685 lines
90 KiB
HTML
685 lines
90 KiB
HTML
<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/><title>Руководство по синтаксису языка запросов по ключевым словам (KQL) | Microsoft Learn</title><style>
|
||
/* cspell:disable-file */
|
||
/* webkit printing magic: print all background colors */
|
||
html {
|
||
-webkit-print-color-adjust: exact;
|
||
}
|
||
* {
|
||
box-sizing: border-box;
|
||
-webkit-print-color-adjust: exact;
|
||
}
|
||
|
||
html,
|
||
body {
|
||
margin: 0;
|
||
padding: 0;
|
||
}
|
||
@media only screen {
|
||
body {
|
||
margin: 2em auto;
|
||
max-width: 900px;
|
||
color: rgb(55, 53, 47);
|
||
}
|
||
}
|
||
|
||
body {
|
||
line-height: 1.5;
|
||
white-space: pre-wrap;
|
||
}
|
||
|
||
a,
|
||
a.visited {
|
||
color: inherit;
|
||
text-decoration: underline;
|
||
}
|
||
|
||
.pdf-relative-link-path {
|
||
font-size: 80%;
|
||
color: #444;
|
||
}
|
||
|
||
h1,
|
||
h2,
|
||
h3 {
|
||
letter-spacing: -0.01em;
|
||
line-height: 1.2;
|
||
font-weight: 600;
|
||
margin-bottom: 0;
|
||
}
|
||
|
||
.page-title {
|
||
font-size: 2.5rem;
|
||
font-weight: 700;
|
||
margin-top: 0;
|
||
margin-bottom: 0.75em;
|
||
}
|
||
|
||
h1 {
|
||
font-size: 1.875rem;
|
||
margin-top: 1.875rem;
|
||
}
|
||
|
||
h2 {
|
||
font-size: 1.5rem;
|
||
margin-top: 1.5rem;
|
||
}
|
||
|
||
h3 {
|
||
font-size: 1.25rem;
|
||
margin-top: 1.25rem;
|
||
}
|
||
|
||
.source {
|
||
border: 1px solid #ddd;
|
||
border-radius: 3px;
|
||
padding: 1.5em;
|
||
word-break: break-all;
|
||
}
|
||
|
||
.callout {
|
||
border-radius: 3px;
|
||
padding: 1rem;
|
||
}
|
||
|
||
figure {
|
||
margin: 1.25em 0;
|
||
page-break-inside: avoid;
|
||
}
|
||
|
||
figcaption {
|
||
opacity: 0.5;
|
||
font-size: 85%;
|
||
margin-top: 0.5em;
|
||
}
|
||
|
||
mark {
|
||
background-color: transparent;
|
||
}
|
||
|
||
.indented {
|
||
padding-left: 1.5em;
|
||
}
|
||
|
||
hr {
|
||
background: transparent;
|
||
display: block;
|
||
width: 100%;
|
||
height: 1px;
|
||
visibility: visible;
|
||
border: none;
|
||
border-bottom: 1px solid rgba(55, 53, 47, 0.09);
|
||
}
|
||
|
||
img {
|
||
max-width: 100%;
|
||
}
|
||
|
||
@media only print {
|
||
img {
|
||
max-height: 100vh;
|
||
object-fit: contain;
|
||
}
|
||
}
|
||
|
||
@page {
|
||
margin: 1in;
|
||
}
|
||
|
||
.collection-content {
|
||
font-size: 0.875rem;
|
||
}
|
||
|
||
.column-list {
|
||
display: flex;
|
||
justify-content: space-between;
|
||
}
|
||
|
||
.column {
|
||
padding: 0 1em;
|
||
}
|
||
|
||
.column:first-child {
|
||
padding-left: 0;
|
||
}
|
||
|
||
.column:last-child {
|
||
padding-right: 0;
|
||
}
|
||
|
||
.table_of_contents-item {
|
||
display: block;
|
||
font-size: 0.875rem;
|
||
line-height: 1.3;
|
||
padding: 0.125rem;
|
||
}
|
||
|
||
.table_of_contents-indent-1 {
|
||
margin-left: 1.5rem;
|
||
}
|
||
|
||
.table_of_contents-indent-2 {
|
||
margin-left: 3rem;
|
||
}
|
||
|
||
.table_of_contents-indent-3 {
|
||
margin-left: 4.5rem;
|
||
}
|
||
|
||
.table_of_contents-link {
|
||
text-decoration: none;
|
||
opacity: 0.7;
|
||
border-bottom: 1px solid rgba(55, 53, 47, 0.18);
|
||
}
|
||
|
||
table,
|
||
th,
|
||
td {
|
||
border: 1px solid rgba(55, 53, 47, 0.09);
|
||
border-collapse: collapse;
|
||
}
|
||
|
||
table {
|
||
border-left: none;
|
||
border-right: none;
|
||
}
|
||
|
||
th,
|
||
td {
|
||
font-weight: normal;
|
||
padding: 0.25em 0.5em;
|
||
line-height: 1.5;
|
||
min-height: 1.5em;
|
||
text-align: left;
|
||
}
|
||
|
||
th {
|
||
color: rgba(55, 53, 47, 0.6);
|
||
}
|
||
|
||
ol,
|
||
ul {
|
||
margin: 0;
|
||
margin-block-start: 0.6em;
|
||
margin-block-end: 0.6em;
|
||
}
|
||
|
||
li > ol:first-child,
|
||
li > ul:first-child {
|
||
margin-block-start: 0.6em;
|
||
}
|
||
|
||
ul > li {
|
||
list-style: disc;
|
||
}
|
||
|
||
ul.to-do-list {
|
||
padding-inline-start: 0;
|
||
}
|
||
|
||
ul.to-do-list > li {
|
||
list-style: none;
|
||
}
|
||
|
||
.to-do-children-checked {
|
||
text-decoration: line-through;
|
||
opacity: 0.375;
|
||
}
|
||
|
||
ul.toggle > li {
|
||
list-style: none;
|
||
}
|
||
|
||
ul {
|
||
padding-inline-start: 1.7em;
|
||
}
|
||
|
||
ul > li {
|
||
padding-left: 0.1em;
|
||
}
|
||
|
||
ol {
|
||
padding-inline-start: 1.6em;
|
||
}
|
||
|
||
ol > li {
|
||
padding-left: 0.2em;
|
||
}
|
||
|
||
.mono ol {
|
||
padding-inline-start: 2em;
|
||
}
|
||
|
||
.mono ol > li {
|
||
text-indent: -0.4em;
|
||
}
|
||
|
||
.toggle {
|
||
padding-inline-start: 0em;
|
||
list-style-type: none;
|
||
}
|
||
|
||
/* Indent toggle children */
|
||
.toggle > li > details {
|
||
padding-left: 1.7em;
|
||
}
|
||
|
||
.toggle > li > details > summary {
|
||
margin-left: -1.1em;
|
||
}
|
||
|
||
.selected-value {
|
||
display: inline-block;
|
||
padding: 0 0.5em;
|
||
background: rgba(206, 205, 202, 0.5);
|
||
border-radius: 3px;
|
||
margin-right: 0.5em;
|
||
margin-top: 0.3em;
|
||
margin-bottom: 0.3em;
|
||
white-space: nowrap;
|
||
}
|
||
|
||
.collection-title {
|
||
display: inline-block;
|
||
margin-right: 1em;
|
||
}
|
||
|
||
.page-description {
|
||
margin-bottom: 2em;
|
||
}
|
||
|
||
.simple-table {
|
||
margin-top: 1em;
|
||
font-size: 0.875rem;
|
||
empty-cells: show;
|
||
}
|
||
.simple-table td {
|
||
height: 29px;
|
||
min-width: 120px;
|
||
}
|
||
|
||
.simple-table th {
|
||
height: 29px;
|
||
min-width: 120px;
|
||
}
|
||
|
||
.simple-table-header-color {
|
||
background: rgb(247, 246, 243);
|
||
color: black;
|
||
}
|
||
.simple-table-header {
|
||
font-weight: 500;
|
||
}
|
||
|
||
time {
|
||
opacity: 0.5;
|
||
}
|
||
|
||
.icon {
|
||
display: inline-block;
|
||
max-width: 1.2em;
|
||
max-height: 1.2em;
|
||
text-decoration: none;
|
||
vertical-align: text-bottom;
|
||
margin-right: 0.5em;
|
||
}
|
||
|
||
img.icon {
|
||
border-radius: 3px;
|
||
}
|
||
|
||
.user-icon {
|
||
width: 1.5em;
|
||
height: 1.5em;
|
||
border-radius: 100%;
|
||
margin-right: 0.5rem;
|
||
}
|
||
|
||
.user-icon-inner {
|
||
font-size: 0.8em;
|
||
}
|
||
|
||
.text-icon {
|
||
border: 1px solid #000;
|
||
text-align: center;
|
||
}
|
||
|
||
.page-cover-image {
|
||
display: block;
|
||
object-fit: cover;
|
||
width: 100%;
|
||
max-height: 30vh;
|
||
}
|
||
|
||
.page-header-icon {
|
||
font-size: 3rem;
|
||
margin-bottom: 1rem;
|
||
}
|
||
|
||
.page-header-icon-with-cover {
|
||
margin-top: -0.72em;
|
||
margin-left: 0.07em;
|
||
}
|
||
|
||
.page-header-icon img {
|
||
border-radius: 3px;
|
||
}
|
||
|
||
.link-to-page {
|
||
margin: 1em 0;
|
||
padding: 0;
|
||
border: none;
|
||
font-weight: 500;
|
||
}
|
||
|
||
p > .user {
|
||
opacity: 0.5;
|
||
}
|
||
|
||
td > .user,
|
||
td > time {
|
||
white-space: nowrap;
|
||
}
|
||
|
||
input[type="checkbox"] {
|
||
transform: scale(1.5);
|
||
margin-right: 0.6em;
|
||
vertical-align: middle;
|
||
}
|
||
|
||
p {
|
||
margin-top: 0.5em;
|
||
margin-bottom: 0.5em;
|
||
}
|
||
|
||
.image {
|
||
border: none;
|
||
margin: 1.5em 0;
|
||
padding: 0;
|
||
border-radius: 0;
|
||
text-align: center;
|
||
}
|
||
|
||
.code,
|
||
code {
|
||
background: rgba(135, 131, 120, 0.15);
|
||
border-radius: 3px;
|
||
padding: 0.2em 0.4em;
|
||
border-radius: 3px;
|
||
font-size: 85%;
|
||
tab-size: 2;
|
||
}
|
||
|
||
code {
|
||
color: #eb5757;
|
||
}
|
||
|
||
.code {
|
||
padding: 1.5em 1em;
|
||
}
|
||
|
||
.code-wrap {
|
||
white-space: pre-wrap;
|
||
word-break: break-all;
|
||
}
|
||
|
||
.code > code {
|
||
background: none;
|
||
padding: 0;
|
||
font-size: 100%;
|
||
color: inherit;
|
||
}
|
||
|
||
blockquote {
|
||
font-size: 1.25em;
|
||
margin: 1em 0;
|
||
padding-left: 1em;
|
||
border-left: 3px solid rgb(55, 53, 47);
|
||
}
|
||
|
||
.bookmark {
|
||
text-decoration: none;
|
||
max-height: 8em;
|
||
padding: 0;
|
||
display: flex;
|
||
width: 100%;
|
||
align-items: stretch;
|
||
}
|
||
|
||
.bookmark-title {
|
||
font-size: 0.85em;
|
||
overflow: hidden;
|
||
text-overflow: ellipsis;
|
||
height: 1.75em;
|
||
white-space: nowrap;
|
||
}
|
||
|
||
.bookmark-text {
|
||
display: flex;
|
||
flex-direction: column;
|
||
}
|
||
|
||
.bookmark-info {
|
||
flex: 4 1 180px;
|
||
padding: 12px 14px 14px;
|
||
display: flex;
|
||
flex-direction: column;
|
||
justify-content: space-between;
|
||
}
|
||
|
||
.bookmark-image {
|
||
width: 33%;
|
||
flex: 1 1 180px;
|
||
display: block;
|
||
position: relative;
|
||
object-fit: cover;
|
||
border-radius: 1px;
|
||
}
|
||
|
||
.bookmark-description {
|
||
color: rgba(55, 53, 47, 0.6);
|
||
font-size: 0.75em;
|
||
overflow: hidden;
|
||
max-height: 4.5em;
|
||
word-break: break-word;
|
||
}
|
||
|
||
.bookmark-href {
|
||
font-size: 0.75em;
|
||
margin-top: 0.25em;
|
||
}
|
||
|
||
.sans { font-family: ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI Variable Display", "Segoe UI", Helvetica, "Apple Color Emoji", Arial, sans-serif, "Segoe UI Emoji", "Segoe UI Symbol"; }
|
||
.code { font-family: "SFMono-Regular", Menlo, Consolas, "PT Mono", "Liberation Mono", Courier, monospace; }
|
||
.serif { font-family: Lyon-Text, Georgia, ui-serif, serif; }
|
||
.mono { font-family: iawriter-mono, Nitti, Menlo, Courier, monospace; }
|
||
.pdf .sans { font-family: Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI Variable Display", "Segoe UI", Helvetica, "Apple Color Emoji", Arial, sans-serif, "Segoe UI Emoji", "Segoe UI Symbol", 'Twemoji', 'Noto Color Emoji', 'Noto Sans CJK JP'; }
|
||
.pdf:lang(zh-CN) .sans { font-family: Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI Variable Display", "Segoe UI", Helvetica, "Apple Color Emoji", Arial, sans-serif, "Segoe UI Emoji", "Segoe UI Symbol", 'Twemoji', 'Noto Color Emoji', 'Noto Sans CJK SC'; }
|
||
.pdf:lang(zh-TW) .sans { font-family: Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI Variable Display", "Segoe UI", Helvetica, "Apple Color Emoji", Arial, sans-serif, "Segoe UI Emoji", "Segoe UI Symbol", 'Twemoji', 'Noto Color Emoji', 'Noto Sans CJK TC'; }
|
||
.pdf:lang(ko-KR) .sans { font-family: Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI Variable Display", "Segoe UI", Helvetica, "Apple Color Emoji", Arial, sans-serif, "Segoe UI Emoji", "Segoe UI Symbol", 'Twemoji', 'Noto Color Emoji', 'Noto Sans CJK KR'; }
|
||
.pdf .code { font-family: Source Code Pro, "SFMono-Regular", Menlo, Consolas, "PT Mono", "Liberation Mono", Courier, monospace, 'Twemoji', 'Noto Color Emoji', 'Noto Sans Mono CJK JP'; }
|
||
.pdf:lang(zh-CN) .code { font-family: Source Code Pro, "SFMono-Regular", Menlo, Consolas, "PT Mono", "Liberation Mono", Courier, monospace, 'Twemoji', 'Noto Color Emoji', 'Noto Sans Mono CJK SC'; }
|
||
.pdf:lang(zh-TW) .code { font-family: Source Code Pro, "SFMono-Regular", Menlo, Consolas, "PT Mono", "Liberation Mono", Courier, monospace, 'Twemoji', 'Noto Color Emoji', 'Noto Sans Mono CJK TC'; }
|
||
.pdf:lang(ko-KR) .code { font-family: Source Code Pro, "SFMono-Regular", Menlo, Consolas, "PT Mono", "Liberation Mono", Courier, monospace, 'Twemoji', 'Noto Color Emoji', 'Noto Sans Mono CJK KR'; }
|
||
.pdf .serif { font-family: PT Serif, Lyon-Text, Georgia, ui-serif, serif, 'Twemoji', 'Noto Color Emoji', 'Noto Serif CJK JP'; }
|
||
.pdf:lang(zh-CN) .serif { font-family: PT Serif, Lyon-Text, Georgia, ui-serif, serif, 'Twemoji', 'Noto Color Emoji', 'Noto Serif CJK SC'; }
|
||
.pdf:lang(zh-TW) .serif { font-family: PT Serif, Lyon-Text, Georgia, ui-serif, serif, 'Twemoji', 'Noto Color Emoji', 'Noto Serif CJK TC'; }
|
||
.pdf:lang(ko-KR) .serif { font-family: PT Serif, Lyon-Text, Georgia, ui-serif, serif, 'Twemoji', 'Noto Color Emoji', 'Noto Serif CJK KR'; }
|
||
.pdf .mono { font-family: PT Mono, iawriter-mono, Nitti, Menlo, Courier, monospace, 'Twemoji', 'Noto Color Emoji', 'Noto Sans Mono CJK JP'; }
|
||
.pdf:lang(zh-CN) .mono { font-family: PT Mono, iawriter-mono, Nitti, Menlo, Courier, monospace, 'Twemoji', 'Noto Color Emoji', 'Noto Sans Mono CJK SC'; }
|
||
.pdf:lang(zh-TW) .mono { font-family: PT Mono, iawriter-mono, Nitti, Menlo, Courier, monospace, 'Twemoji', 'Noto Color Emoji', 'Noto Sans Mono CJK TC'; }
|
||
.pdf:lang(ko-KR) .mono { font-family: PT Mono, iawriter-mono, Nitti, Menlo, Courier, monospace, 'Twemoji', 'Noto Color Emoji', 'Noto Sans Mono CJK KR'; }
|
||
.highlight-default {
|
||
color: rgba(55, 53, 47, 1);
|
||
}
|
||
.highlight-gray {
|
||
color: rgba(120, 119, 116, 1);
|
||
fill: rgba(120, 119, 116, 1);
|
||
}
|
||
.highlight-brown {
|
||
color: rgba(159, 107, 83, 1);
|
||
fill: rgba(159, 107, 83, 1);
|
||
}
|
||
.highlight-orange {
|
||
color: rgba(217, 115, 13, 1);
|
||
fill: rgba(217, 115, 13, 1);
|
||
}
|
||
.highlight-yellow {
|
||
color: rgba(203, 145, 47, 1);
|
||
fill: rgba(203, 145, 47, 1);
|
||
}
|
||
.highlight-teal {
|
||
color: rgba(68, 131, 97, 1);
|
||
fill: rgba(68, 131, 97, 1);
|
||
}
|
||
.highlight-blue {
|
||
color: rgba(51, 126, 169, 1);
|
||
fill: rgba(51, 126, 169, 1);
|
||
}
|
||
.highlight-purple {
|
||
color: rgba(144, 101, 176, 1);
|
||
fill: rgba(144, 101, 176, 1);
|
||
}
|
||
.highlight-pink {
|
||
color: rgba(193, 76, 138, 1);
|
||
fill: rgba(193, 76, 138, 1);
|
||
}
|
||
.highlight-red {
|
||
color: rgba(212, 76, 71, 1);
|
||
fill: rgba(212, 76, 71, 1);
|
||
}
|
||
.highlight-default_background {
|
||
color: rgba(55, 53, 47, 1);
|
||
}
|
||
.highlight-gray_background {
|
||
background: rgba(241, 241, 239, 1);
|
||
}
|
||
.highlight-brown_background {
|
||
background: rgba(244, 238, 238, 1);
|
||
}
|
||
.highlight-orange_background {
|
||
background: rgba(251, 236, 221, 1);
|
||
}
|
||
.highlight-yellow_background {
|
||
background: rgba(251, 243, 219, 1);
|
||
}
|
||
.highlight-teal_background {
|
||
background: rgba(237, 243, 236, 1);
|
||
}
|
||
.highlight-blue_background {
|
||
background: rgba(231, 243, 248, 1);
|
||
}
|
||
.highlight-purple_background {
|
||
background: rgba(244, 240, 247, 0.8);
|
||
}
|
||
.highlight-pink_background {
|
||
background: rgba(249, 238, 243, 0.8);
|
||
}
|
||
.highlight-red_background {
|
||
background: rgba(253, 235, 236, 1);
|
||
}
|
||
.block-color-default {
|
||
color: inherit;
|
||
fill: inherit;
|
||
}
|
||
.block-color-gray {
|
||
color: rgba(120, 119, 116, 1);
|
||
fill: rgba(120, 119, 116, 1);
|
||
}
|
||
.block-color-brown {
|
||
color: rgba(159, 107, 83, 1);
|
||
fill: rgba(159, 107, 83, 1);
|
||
}
|
||
.block-color-orange {
|
||
color: rgba(217, 115, 13, 1);
|
||
fill: rgba(217, 115, 13, 1);
|
||
}
|
||
.block-color-yellow {
|
||
color: rgba(203, 145, 47, 1);
|
||
fill: rgba(203, 145, 47, 1);
|
||
}
|
||
.block-color-teal {
|
||
color: rgba(68, 131, 97, 1);
|
||
fill: rgba(68, 131, 97, 1);
|
||
}
|
||
.block-color-blue {
|
||
color: rgba(51, 126, 169, 1);
|
||
fill: rgba(51, 126, 169, 1);
|
||
}
|
||
.block-color-purple {
|
||
color: rgba(144, 101, 176, 1);
|
||
fill: rgba(144, 101, 176, 1);
|
||
}
|
||
.block-color-pink {
|
||
color: rgba(193, 76, 138, 1);
|
||
fill: rgba(193, 76, 138, 1);
|
||
}
|
||
.block-color-red {
|
||
color: rgba(212, 76, 71, 1);
|
||
fill: rgba(212, 76, 71, 1);
|
||
}
|
||
.block-color-default_background {
|
||
color: inherit;
|
||
fill: inherit;
|
||
}
|
||
.block-color-gray_background {
|
||
background: rgba(241, 241, 239, 1);
|
||
}
|
||
.block-color-brown_background {
|
||
background: rgba(244, 238, 238, 1);
|
||
}
|
||
.block-color-orange_background {
|
||
background: rgba(251, 236, 221, 1);
|
||
}
|
||
.block-color-yellow_background {
|
||
background: rgba(251, 243, 219, 1);
|
||
}
|
||
.block-color-teal_background {
|
||
background: rgba(237, 243, 236, 1);
|
||
}
|
||
.block-color-blue_background {
|
||
background: rgba(231, 243, 248, 1);
|
||
}
|
||
.block-color-purple_background {
|
||
background: rgba(244, 240, 247, 0.8);
|
||
}
|
||
.block-color-pink_background {
|
||
background: rgba(249, 238, 243, 0.8);
|
||
}
|
||
.block-color-red_background {
|
||
background: rgba(253, 235, 236, 1);
|
||
}
|
||
.select-value-color-uiBlue { background-color: rgba(35, 131, 226, .07); }
|
||
.select-value-color-pink { background-color: rgba(245, 224, 233, 1); }
|
||
.select-value-color-purple { background-color: rgba(232, 222, 238, 1); }
|
||
.select-value-color-green { background-color: rgba(219, 237, 219, 1); }
|
||
.select-value-color-gray { background-color: rgba(227, 226, 224, 1); }
|
||
.select-value-color-transparentGray { background-color: rgba(227, 226, 224, 0); }
|
||
.select-value-color-translucentGray { background-color: rgba(0, 0, 0, 0.06); }
|
||
.select-value-color-orange { background-color: rgba(250, 222, 201, 1); }
|
||
.select-value-color-brown { background-color: rgba(238, 224, 218, 1); }
|
||
.select-value-color-red { background-color: rgba(255, 226, 221, 1); }
|
||
.select-value-color-yellow { background-color: rgba(253, 236, 200, 1); }
|
||
.select-value-color-blue { background-color: rgba(211, 229, 239, 1); }
|
||
.select-value-color-pageGlass { background-color: undefined; }
|
||
.select-value-color-washGlass { background-color: undefined; }
|
||
|
||
.checkbox {
|
||
display: inline-flex;
|
||
vertical-align: text-bottom;
|
||
width: 16;
|
||
height: 16;
|
||
background-size: 16px;
|
||
margin-left: 2px;
|
||
margin-right: 5px;
|
||
}
|
||
|
||
.checkbox-on {
|
||
background-image: url("data:image/svg+xml;charset=UTF-8,%3Csvg%20width%3D%2216%22%20height%3D%2216%22%20viewBox%3D%220%200%2016%2016%22%20fill%3D%22none%22%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%3E%0A%3Crect%20width%3D%2216%22%20height%3D%2216%22%20fill%3D%22%2358A9D7%22%2F%3E%0A%3Cpath%20d%3D%22M6.71429%2012.2852L14%204.9995L12.7143%203.71436L6.71429%209.71378L3.28571%206.2831L2%207.57092L6.71429%2012.2852Z%22%20fill%3D%22white%22%2F%3E%0A%3C%2Fsvg%3E");
|
||
}
|
||
|
||
.checkbox-off {
|
||
background-image: url("data:image/svg+xml;charset=UTF-8,%3Csvg%20width%3D%2216%22%20height%3D%2216%22%20viewBox%3D%220%200%2016%2016%22%20fill%3D%22none%22%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%3E%0A%3Crect%20x%3D%220.75%22%20y%3D%220.75%22%20width%3D%2214.5%22%20height%3D%2214.5%22%20fill%3D%22white%22%20stroke%3D%22%2336352F%22%20stroke-width%3D%221.5%22%2F%3E%0A%3C%2Fsvg%3E");
|
||
}
|
||
|
||
</style></head><body><article id="142fc6ca-70fd-81b7-84a3-d54902a690c3" class="page sans"><header><h1 class="page-title">Руководство по синтаксису языка запросов по ключевым словам (KQL) | Microsoft Learn</h1><p class="page-description"></p></header><div class="page-body"><p id="142fc6ca-70fd-81b6-87ef-d5b0ef7db637" class=""><a href="https://learn.microsoft.com/ru-ru/sharepoint/dev/general-development/keyword-query-language-kql-syntax-reference">https://learn.microsoft.com/ru-ru/sharepoint/dev/general-development/keyword-query-language-kql-syntax-reference</a></p><p id="142fc6ca-70fd-819c-b455-dd4db07200f1" class="">
|
||
</p><h2 id="142fc6ca-70fd-81e7-bef2-dd2f4d3117a9" class="">Элементы KQL-запроса</h2><p id="142fc6ca-70fd-810c-90c0-c0a013d686dd" class="">KQL-запрос состоит из одного или нескольких элементов, перечисленных далее.</p><ul id="142fc6ca-70fd-810a-bd02-e5c4a1b76b00" class="bulleted-list"><li style="list-style-type:disc">Ключевые слова с произвольным текстом (слова или фразы)</li></ul><ul id="142fc6ca-70fd-81d3-92e0-d0609e872f8f" class="bulleted-list"><li style="list-style-type:disc">Ограничения свойств</li></ul><p id="142fc6ca-70fd-8170-bd2f-f44d2c2cb2fd" class="">Элементы KQL-запросов можно комбинировать с одним или несколькими доступными операторами.</p><p id="142fc6ca-70fd-81cf-b908-c09f0ce37666" class="">Недопустимы те KQL-запросы, которые пустые или содержат только операторы. KQL-запросы не чувствительны к регистру, а операторы чувствительны (верхний регистр).</p><p id="142fc6ca-70fd-8100-bb04-ea0e77ea25fe" class="">Примечание</p><p id="142fc6ca-70fd-81f3-b477-c75ee8537930" class="">Ограничение длины KQL-запроса зависит от способа его создания. Если KQL-запрос создан при помощи внешнего интерфейса поиска SharePoint, доступного по умолчанию, максимальная длина составляет 2048 символов. Если же вы создаете KQL-запрос программным путем с помощью объектной модели запроса, ограничение длины по умолчанию составляет 4096 знаков. Это ограничение можно увеличить до 20480 символов с помощью свойства <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.SearchServiceApplication.MaxKeywordQueryTextLength.aspx">MaxKeywordQueryTextLength</a> или <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.SearchServiceApplication.DiscoveryMaxKeywordQueryTextLength.aspx">DiscoveryMaxKeywordQueryTextLength</a> (для обнаружения электронных данных).</p><h2 id="142fc6ca-70fd-812e-b58f-edee0489ab24" class="">Создание запросов с произвольным текстом при помощи KQL</h2><p id="142fc6ca-70fd-81bf-ab9f-cb1556a9c9ea" class="">При создании KQL-запроса с использованием произвольных выражений Поиск в SharePoint подбирает результаты с совпадениями для выбранных вами терминов, основываясь на терминах, хранящихся в полнотекстовом индексе. Сюда входят значения управляемых свойств, для которых <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedProperty.FullTextQueriable.aspx">для FullTextQueriable</a> задано <strong>значение true</strong>.</p><p id="142fc6ca-70fd-812b-8b7a-dfcf8f4f318a" class="">KQL-запросы с произвольным текстом не чувствительны к регистру, однако операторы должны быть записаны заглавными буквами. Вы можете строить KQL-запросы с помощью одного или нескольких произвольных выражений:</p><ul id="142fc6ca-70fd-8118-ae8a-ec7abff5d2b2" class="bulleted-list"><li style="list-style-type:disc"><strong>word</strong> (содержит один или несколько символов без пробелов и знаков препинания);</li></ul><ul id="142fc6ca-70fd-81c0-94f1-d148f7f551ce" class="bulleted-list"><li style="list-style-type:disc"><strong>phrase</strong> (содержит два и более слов, разделенных пробелами и обязательно заключенных в двойные кавычки).</li></ul><p id="142fc6ca-70fd-813b-97df-dbe2793f3d8c" class="">Чтобы создать сложные запросы, вы можете комбинировать несколько произвольных выражений с помощью операторов KQL-запросов. Если операторы между выражениями отсутствуют, запрос будет выполняться так же, как при использовании оператора <strong>AND</strong>.</p><h3 id="142fc6ca-70fd-81c4-9a51-f6d1bf96c41f" class="">Использование слов в KQL-запросе с произвольным текстом</h3><p id="142fc6ca-70fd-8144-880c-f8c8c49e2567" class="">Если вы используете слова в KQL-запросе с произвольным текстом, служба Поиск в SharePoint возвращает результаты с точным совпадением этих слов с терминами, хранящимися в полнотекстовом индексе. Можно указывать только начальную часть слова, применяя оператор подстановочного знака (*) для включения сопоставления префиксов. При таком сопоставлении служба Поиск в SharePoint подбирает совпадения с терминами, содержащими искомое слово, за которым могут следовать другие символы.</p><p id="142fc6ca-70fd-8134-86bf-e6a757f707dd" class="">Например, следующие KQL-запросы вернут элементы, содержащие термины "federated" и "search":</p><p id="142fc6ca-70fd-8144-b5ca-f2017fc9c4a1" class=""><code>federated search</code></p><p id="142fc6ca-70fd-819b-a9bf-ea9cd37002ad" class=""><code>federat* search</code></p><p id="142fc6ca-70fd-8175-bebe-fe54e5bb93b1" class=""><code>search fed*</code></p><p id="142fc6ca-70fd-8142-836f-d7a8b843580b" class="">Запросы KQL не поддерживают сопоставление префиксов с подстановочным знаком * в качестве префикса.</p><h3 id="142fc6ca-70fd-81a0-8454-e6ab5f01d78e" class="">Использование фраз в KQL-запросе с произвольным текстом</h3><p id="142fc6ca-70fd-81e0-a356-fe4a9c9065ae" class="">Если вы используете фразы в KQL-запросе с произвольным текстом, служба Поиск в SharePoint возвращает только элементы, в которых есть слова из вашей фразы, следующие друг за другом. Чтобы задать фразу в KQL-запросе, необходимо использовать двойные кавычки.</p><p id="142fc6ca-70fd-81ad-a811-c75d84de0adb" class="">Запросы KQL не поддерживают сопоставление префиксов с подстановочным знаком * в качестве префикса, поэтому нельзя использовать оператор с подстановочными знаками перед фразой в запросах свободного текста. Однако вы можете использовать оператор подстановочного знака после фразы.</p><h2 id="142fc6ca-70fd-8140-90af-f62ab820c921" class="">Запросы с ограничениями свойств в KQL</h2><p id="142fc6ca-70fd-8184-a2ac-f1f8f91bc4f7" class="">С помощью KQL вы можете строить запросы, использующие ограничения свойств, чтобы получать результаты запроса только по заданному условию.</p><h3 id="142fc6ca-70fd-81f4-aafb-c38310f2386a" class="">Задание ограничений свойств</h3><p id="142fc6ca-70fd-81b6-9f95-c38e7880ee24" class="">Базовое ограничение свойств состоит из перечисленных ниже элементов.</p><p id="142fc6ca-70fd-810c-a4f5-c128b518f7f3" class=""><code><Property Name><Property Operator><Property Value></code></p><p id="142fc6ca-70fd-81b9-a426-f4f230bb0e0f" class="">В таблице 1 приведены некоторые примеры допустимого синтаксиса ограничений свойств в KQL-запросах.</p><p id="142fc6ca-70fd-817a-987c-d1f1ad445779" class=""><strong>Таблица 1. Допустимый синтаксис ограничений свойств</strong></p><table id="142fc6ca-70fd-811e-8337-c3bdd900fc05" class="simple-table"><tbody><tr id="142fc6ca-70fd-813d-95c8-cc72e7eb1300"><td id="XNQN" class=""><strong>Синтаксис</strong></td><td id="a^OC" class=""><strong>Возвращаемое значение</strong></td></tr><tr id="142fc6ca-70fd-8173-8d2b-fb67981fa9d9"><td id="XNQN" class=""><code>author:"John Smith"</code></td><td id="a^OC" class="">Возвращает элементы контента, автором которого является John Smith.</td></tr><tr id="142fc6ca-70fd-81af-aa62-e28ead12972d"><td id="XNQN" class=""><code>filetype:docx</code></td><td id="a^OC" class="">Возвращает документы Microsoft Word.</td></tr><tr id="142fc6ca-70fd-81d9-b071-e9a10dfbd5fe"><td id="XNQN" class=""><code>filename:budget.xlsx</code></td><td id="a^OC" class="">Возвращает элементы содержимого с именем <code>budget.xlsx</code>файла .</td></tr></tbody></table><p id="142fc6ca-70fd-8173-9caf-c33d6f6f00ed" class="">Ограничение свойства не должно включать пробелы между именем свойства, оператором свойства и значением свойства, иначе ограничение свойства обрабатывается как запрос свободного текста. Длина ограничения свойства не должна превышать 2048 символов.</p><p id="142fc6ca-70fd-8140-ad13-cd4088fbf1bf" class="">В следующих примерах наличие пробела приводит к тому, что запрос возвращает элементы, содержащие термины "author" и "John Smith", вместо элементов контента, автором которого является John Smith:</p><p id="142fc6ca-70fd-8139-b5b2-ff3332ac3162" class=""><code>author: "John Smith"</code></p><p id="142fc6ca-70fd-8108-b96d-c0cfe4a35b3c" class=""><code>author :"John Smith"</code></p><p id="142fc6ca-70fd-81bd-a047-cad49f866e51" class=""><code>author : "John Smith"</code></p><p id="142fc6ca-70fd-81d4-9042-f78d1f419133" class="">Другими словами, описанные выше ограничения свойств эквивалентны следующему запросу:</p><p id="142fc6ca-70fd-81af-9285-d87c42afdc26" class=""><code>author "John Smith"</code></p><h3 id="142fc6ca-70fd-8138-aeee-c9716a8eb4ed" class="">Указание имен свойств для ограничений свойств</h3><p id="142fc6ca-70fd-81f6-8e0f-d2ab41ba072f" class="">Необходимо указать допустимое имя управляемого свойства для ограничения свойства. По умолчанию в Поиск в SharePoint входит несколько управляемых свойств для документов.</p><p id="142fc6ca-70fd-81e6-a6bd-f36e69664284" class="">Чтобы задать ограничение для значения свойства для обхода, необходимо сначала сопоставить свойство для обхода с управляемым свойством. См. раздел <strong>Управляемые и обходные свойства</strong> в <a href="https://technet.microsoft.com/library/cc263089.aspx">статье Планирование взаимодействия с поиском для конечных пользователей</a>.</p><p id="142fc6ca-70fd-8157-8c07-c07b425dcb23" class="">Управляемое свойство должно быть <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedProperty.Queryable.aspx">запрашиваемым</a> , чтобы можно было искать это управляемое свойство в документе. Кроме того, управляемое свойство может относиться к типу <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedProperty.Retrievable.aspx">Retrievable</a> , чтобы можно было его извлечь. Однако управляемое свойство не обязательно должно относиться к типу <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedProperty.Retrievable.aspx">Retrievable</a> , чтобы можно было найти свойство.</p><h3 id="142fc6ca-70fd-811b-abe7-f5c22b87f40e" class="">Операторы свойств, поддерживаемые в ограничениях свойств</h3><p id="142fc6ca-70fd-81ec-899c-eb9e9a86d5a9" class="">Служба Поиск в SharePoint поддерживает несколько операторов свойств для ограничений свойств, приведенных в таблице 2.</p><p id="142fc6ca-70fd-81bf-a09d-e2660c1de847" class=""><strong>Таблица 2. Допустимые операторы свойств для ограничений свойств</strong></p><table id="142fc6ca-70fd-8176-84c6-c952f1c779b0" class="simple-table"><tbody><tr id="142fc6ca-70fd-815c-91b8-dba5e741dc63"><td id="phmD" class=""><strong>Описание</strong></td><td id="Pegm" class=""><strong>Описание</strong></td><td id="RWpJ" class=""><strong>Поддерживаемый тип управляемого свойства</strong></td></tr><tr id="142fc6ca-70fd-81d3-b872-f36a51a678ab"><td id="phmD" class="">:</td><td id="Pegm" class="">Возвращает результаты, в которых указанное в ограничении свойства значение равно значению свойства, хранящегося в базе данных хранилища свойств, или совпадает с отдельными терминами в значении свойства, хранящегося в полнотекстовом индексе.</td><td id="RWpJ" class=""><a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Text">Text</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#DateTime">DateTime</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Integer">Integer</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Decimal">Decimal</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Double">Double</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#YesNo">YesNo</a></td></tr><tr id="142fc6ca-70fd-8109-855d-f5adb5db17a2"><td id="phmD" class="">=</td><td id="Pegm" class="">Возвращает результаты поиска со значениями свойств, равными значению, определенному при ограничении свойств. <strong>Примечание.</strong> Не рекомендуем сочетать оператор <strong>=</strong> со знаком звездочки (<strong>*</strong>), если нужно найти точное совпадение.</td><td id="RWpJ" class=""><a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Text">Text</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#DateTime">DateTime</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Integer">Integer</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Decimal">Decimal</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Double">Double</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#YesNo">YesNo</a></td></tr><tr id="142fc6ca-70fd-8152-a50b-c75515cdbcae"><td id="phmD" class=""><</td><td id="Pegm" class="">Возвращает результаты, в которых значение свойства меньше значения, указанного в ограничении свойства.</td><td id="RWpJ" class=""><a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#DateTime">DateTime</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Integer">Integer</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Decimal">Decimal</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Double">Double</a></td></tr><tr id="142fc6ca-70fd-8177-9a57-ca8ced315b10"><td id="phmD" class="">></td><td id="Pegm" class="">Возвращает результаты, в которых значение свойства больше значения, указанного в ограничении свойства.</td><td id="RWpJ" class=""><a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#DateTime">DateTime</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Integer">Integer</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Decimal">Decimal</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Double">Double</a></td></tr><tr id="142fc6ca-70fd-81df-8748-cafc5360cf4e"><td id="phmD" class=""><=</td><td id="Pegm" class="">Возвращает результаты со значением свойства, меньшим или равным значению, указанному в ограничении свойства.</td><td id="RWpJ" class=""><a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#DateTime">DateTime</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Integer">Integer</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Decimal">Decimal</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Double">Double</a></td></tr><tr id="142fc6ca-70fd-813d-b404-c87fc5d54934"><td id="phmD" class="">>=</td><td id="Pegm" class="">Возвращает результаты со значением свойства, большим или равным значению, указанному в ограничении свойства.</td><td id="RWpJ" class=""><a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#DateTime">DateTime</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Integer">Integer</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Decimal">Decimal</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Double">Double</a></td></tr><tr id="142fc6ca-70fd-8144-baf4-e497ba897023"><td id="phmD" class=""><></td><td id="Pegm" class="">Возвращает результаты со значением свойства, не равным значению, указанному в ограничении свойства.</td><td id="RWpJ" class=""><a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#DateTime">DateTime</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Integer">Integer</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Decimal">Decimal</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Text">Text</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Double">Double</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#YesNo">YesNo</a></td></tr><tr id="142fc6ca-70fd-8184-9616-daacd96aa37d"><td id="phmD" class="">..</td><td id="Pegm" class="">Возвращает результаты, в которых значение свойства включено в диапазон, указанный в ограничении свойства. Например, диапазон A..B представляет собой набор значений от A до B со значениями A и B включительно. Для диапазонов дат такая запись означает диапазон от начала дня A до конца дня B.</td><td id="RWpJ" class=""><a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#DateTime">DateTime</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Integer">Integer</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Decimal">Decimal</a> <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Double">Double</a></td></tr></tbody></table><h3 id="142fc6ca-70fd-8193-899d-eaa36d56798f" class="">Указание значений свойств</h3><p id="142fc6ca-70fd-81ae-9607-c649f325f19e" class="">Укажите значение свойства, имеющего допустимый тип данных для типа управляемого свойства. В таблице 3 приведен перечень сопоставлений типов.</p><p id="142fc6ca-70fd-81f0-9b3f-ff318ec26b36" class=""><strong>Таблица 3. Соответствие допустимых типов данных типам управляемых свойств</strong></p><table id="142fc6ca-70fd-813d-acf8-d2ae986e1723" class="simple-table"><tbody><tr id="142fc6ca-70fd-812e-8eec-fb3cc732106a"><td id="GTS`" class=""><strong>Тип управляемых свойств</strong></td><td id="Y;vx" class=""><strong>Тип данных</strong></td></tr><tr id="142fc6ca-70fd-8125-9fee-ddb4cd5ac58b"><td id="GTS`" class=""><a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Text">Text</a></td><td id="Y;vx" class=""><a href="https://msdn.microsoft.com/library/System.String.aspx">String</a></td></tr><tr id="142fc6ca-70fd-81b8-8403-e219f3330d44"><td id="GTS`" class=""><a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Integer">Integer</a></td><td id="Y;vx" class=""><a href="https://msdn.microsoft.com/library/System.Int64.aspx">Int64</a></td></tr><tr id="142fc6ca-70fd-81a8-b745-d1a3f60b48ec"><td id="GTS`" class=""><a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Double">Double</a></td><td id="Y;vx" class=""><a href="https://msdn.microsoft.com/library/System.Double.aspx">System.Double</a></td></tr><tr id="142fc6ca-70fd-8103-ab9e-df4730847571"><td id="GTS`" class=""><a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Decimal">Decimal</a></td><td id="Y;vx" class=""><a href="https://msdn.microsoft.com/library/System.Decimal.aspx">Decimal</a></td></tr><tr id="142fc6ca-70fd-8147-8b00-ce0369a1b6eb"><td id="GTS`" class=""><a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#DateTime">DateTime()</a></td><td id="Y;vx" class=""><a href="https://msdn.microsoft.com/library/System.DateTime.aspx">DateTime</a></td></tr><tr id="142fc6ca-70fd-81d5-b0ca-ea18652bc79b"><td id="GTS`" class=""><a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#YesNo">YesNo</a></td><td id="Y;vx" class=""><a href="https://msdn.microsoft.com/library/System.Boolean.aspx">Boolean</a></td></tr></tbody></table><h3 id="142fc6ca-70fd-81ee-b9a5-dbacc002ab9a" class="">Значения текстовых свойств</h3><p id="142fc6ca-70fd-81e7-ac62-fb1fba573c28" class="">В случае значений текстовых свойств ход сопоставления зависит от того, хранится ли свойство в полнотекстовом индексе или в индексе поиска.</p><h3 id="142fc6ca-70fd-813c-b2c3-fd00137bccd4" class="">Значения свойств в полнотекстовом индексе</h3><p id="142fc6ca-70fd-813f-8356-d86f7b6b4c52" class="">Значения свойств хранятся в полнотекстовом индексе, когда свойству <strong>FullTextQueriable</strong> присвоено значение <strong>true</strong> для управляемого свойства. Эту настройку можно использовать только для строковых свойств. Значения свойств, указанные в запросе, сопоставляются с отдельными терминами, которые хранятся в полнотекстовом индексе. Используйте свойство <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedProperty.NoWordBreaker.aspx">NoWordBreaker</a> , чтобы указать, должен ли проводиться поиск совпадений с полным значением свойства.</p><p id="142fc6ca-70fd-81ec-9321-f954d9828680" class="">Например, если вы ищете элемент контента, созданный пользователем Paul Shakespear, такой KQL-запрос возвращает результаты с совпадениями:</p><p id="142fc6ca-70fd-817d-95b7-df9f741bb929" class=""><code>author:Shakespear</code></p><p id="142fc6ca-70fd-81f8-9b8d-f13547218a26" class=""><code>author:Paul</code></p><p id="142fc6ca-70fd-81a1-b234-f38cb6dbd790" class="">Поддерживается также сопоставление префикса. Можно использовать оператор с подстановочными знаками (*), но он не требуется при указании отдельных слов. Продолжая работу с предыдущим примером, следующий запрос KQL возвращает элементы содержимого, созданные Полом Shakespear, в виде совпадений:</p><p id="142fc6ca-70fd-81ad-957d-e91956488cc2" class=""><code>author:Shakesp*</code></p><p id="142fc6ca-70fd-81a7-8ec2-e3ad09ea8a99" class="">Когда вы указываете фразу для значения свойства, результаты с совпадениями должны содержать указанную фразу в значении свойства, хранящегося в полнотекстовом индексе. В следующем примере запроса возвращаются элементы содержимого с текстом "Расширенный поиск" в заголовке, например "Расширенный поиск XML", "Изучение веб-части расширенного поиска" и т. д.</p><p id="142fc6ca-70fd-8155-8c95-f9dc3c5f208f" class=""><code>title:"Advanced Search"</code></p><p id="142fc6ca-70fd-814a-b310-fddff5608fae" class="">Сопоставление префиксов также поддерживается для фраз, указанных в значениях свойств. Но в этом случае в запросе следует использовать оператор подстановочного знака (*), который допустим только в конце фразы, например:</p><p id="142fc6ca-70fd-81f5-9f8f-d702423fbcc7" class=""><code>title:"Advanced Sear*"</code></p><p id="142fc6ca-70fd-8175-8bed-d144027a0c0c" class="">Следующие запросы не возвращают ожидаемые результаты:</p><p id="142fc6ca-70fd-81aa-b70e-f54fe69ad3a4" class=""><code>title:"Advan* Search"</code></p><p id="142fc6ca-70fd-817e-8d26-e294bfd41e0d" class=""><code>title:"Advanced Sear"</code></p><h3 id="142fc6ca-70fd-818b-8118-c83d976524b2" class="">Числовые значения свойств</h3><p id="142fc6ca-70fd-8173-9242-c523c95c70d1" class="">В случае числовых значений свойств, к которым относятся управляемые типы <strong>Integer</strong>, <strong>Double</strong> и <strong>Decimal</strong>, ограничение свойства сопоставляется с полным значением свойства.</p><h3 id="142fc6ca-70fd-81bc-9c02-ce20c7fed7a3" class="">Значения даты и времени для свойств</h3><p id="142fc6ca-70fd-8125-b13c-d373ea81f8d4" class="">В языке KQL для даты и времени предназначен тип данных <strong>datetime</strong>. В запросах поддерживаются следующие форматы даты и времени, совместимые с ISO 8601:</p><ul id="142fc6ca-70fd-8172-8c71-ce58be26f96f" class="bulleted-list"><li style="list-style-type:disc">ГГГГ-ММ-ДД</li></ul><ul id="142fc6ca-70fd-811d-8639-e67c002c71bb" class="bulleted-list"><li style="list-style-type:disc">YYYY-MM-DDThh:mm:ss</li></ul><ul id="142fc6ca-70fd-8183-b1af-c021e08050c5" class="bulleted-list"><li style="list-style-type:disc">ГГГГ-ММ-ДДTчч:мм:ссZ</li></ul><ul id="142fc6ca-70fd-81b5-bda7-fc0cb0025e6f" class="bulleted-list"><li style="list-style-type:disc">ГГГГ-ММ-ДДTчч:мм:ссfrZ</li></ul><p id="142fc6ca-70fd-8138-a6b8-e4c56e5297da" class="">В этих форматах <strong>datetime</strong>:</p><ul id="142fc6ca-70fd-814e-802d-fa4578a5b3cb" class="bulleted-list"><li style="list-style-type:disc"><em>ГГГГ</em> задает год из четырех цифр. <p id="142fc6ca-70fd-8161-9092-fb20fbde314e" class="">Примечание</p><p id="142fc6ca-70fd-81df-b1c3-fc1b1d06ef0e" class="">Поддерживается только формат года из четырех цифр.</p></li></ul><ul id="142fc6ca-70fd-8185-9926-eb9efaef3037" class="bulleted-list"><li style="list-style-type:disc">Параметр <em>MM</em> задает месяц в формате двух цифр. Например, 01 это январь.</li></ul><ul id="142fc6ca-70fd-81a8-b2ff-d99d12a75687" class="bulleted-list"><li style="list-style-type:disc">Параметр <em>DD</em> задает двузначное значение дня месяца (от 01 до 31).</li></ul><ul id="142fc6ca-70fd-8102-8737-d7331a98e008" class="bulleted-list"><li style="list-style-type:disc">Параметр <em>T</em> обозначает букву "T".</li></ul><ul id="142fc6ca-70fd-81ed-aa19-c6a338cf149c" class="bulleted-list"><li style="list-style-type:disc">Параметр <em>hh</em> обозначает часы в формате двух цифр (от 00 до 23). Обозначения a.m. и p.m. не допускаются.</li></ul><ul id="142fc6ca-70fd-8177-b431-fe9e93e2f08e" class="bulleted-list"><li style="list-style-type:disc">Параметр <em>mm</em> обозначает минуты в формате двух цифр (от 00 до 59).</li></ul><ul id="142fc6ca-70fd-814d-98fa-c85b4fc34a31" class="bulleted-list"><li style="list-style-type:disc">Параметр <em>сс</em> обозначает секунды в формате двух цифр (от 00 до 59).</li></ul><ul id="142fc6ca-70fd-81c0-a7ee-d0b9a797e85c" class="bulleted-list"><li style="list-style-type:disc"><em>fr</em> задает необязательную долю секунд, ss; от 1 до 7 цифр, которые следуют за <strong>.</strong> после секунд. Например, 2012-09-27T11:57:34.1234567.</li></ul><p id="142fc6ca-70fd-814a-8104-f83335d70ad5" class="">Все значения даты и времени необходимо указывать в часовом поясе UTC (другое название GMT). Идентификатор часового пояса UTC (символ "Z" в конце) указывать необязательно.</p><h3 id="142fc6ca-70fd-8174-b852-e4ae6e3edf60" class="">Соответствующие интервалы дат, поддерживаемые KQL</h3><p id="142fc6ca-70fd-81b8-93a3-d951317c2596" class="">Язык KQL поддерживает реляционные запросы в диапазоне day, для которых зарезервированы ключевые слова, как показано в таблице 4. Используйте двойные кавычки ("") для интервалов дат, между их названиями ставьте пробел.</p><p id="142fc6ca-70fd-819b-8646-cff6ca23406e" class="">Совпадения будут включать элементы, измененные сегодня:</p><p id="142fc6ca-70fd-81be-8ccb-f54e6e34814d" class=""><code>LastModifiedTime=today</code></p><p id="142fc6ca-70fd-81ce-a9b7-eeaf140344cc" class="">Совпадения будут включать элементы от начала текущего года до его окончания:</p><p id="142fc6ca-70fd-81d7-959a-e2609d0c6336" class=""><code>LastModifiedTime="this year"</code></p><p id="142fc6ca-70fd-818c-ac95-c4626676a51a" class="">Совпадения будут включать элементы с 1 января 2019 г. до 26 апреля 2019 г.:</p><p id="142fc6ca-70fd-8184-a9cc-cf660f5495ea" class=""><code>LastModifiedTime>=2019-01-01 AND LastModifiedTime<=2019-04-26</code></p><p id="142fc6ca-70fd-8150-a23c-c13902d3f541" class=""><strong>Табл. 4. Зарезервированные ключевые слова для интервала даты</strong></p><table id="142fc6ca-70fd-815c-b437-cb10e4a6a3aa" class="simple-table"><tbody><tr id="142fc6ca-70fd-812b-9531-cd6f87ff7675"><td id="mnt^" class=""><strong>Имя интервала дат</strong></td><td id="VEZe" class=""><strong>Описание</strong></td></tr><tr id="142fc6ca-70fd-81d1-81ba-d2137bafa52c"><td id="mnt^" class="">today</td><td id="VEZe" class="">Представляет период времени с начала текущего дня до его окончания.</td></tr><tr id="142fc6ca-70fd-8182-be06-d69c195360a2"><td id="mnt^" class="">yesterday</td><td id="VEZe" class="">Представляет период времени с начала предшествующего дня до его окончания.</td></tr><tr id="142fc6ca-70fd-811d-9f53-f7e0954cebae"><td id="mnt^" class="">this week</td><td id="VEZe" class="">Представляет период времени от начала текущей недели до ее окончания. При определении первого дня недели учитываются традиции региона, в котором формируется текст запроса.</td></tr><tr id="142fc6ca-70fd-8175-805f-e89b335d4830"><td id="mnt^" class="">this month</td><td id="VEZe" class="">Представляет период времени с начала текущего месяца до его окончания.</td></tr><tr id="142fc6ca-70fd-8199-881c-e090392ba00d"><td id="mnt^" class="">last month</td><td id="VEZe" class="">Представляет период времени от начала предыдущего месяца до его окончания.</td></tr><tr id="142fc6ca-70fd-81e8-bdd1-df0cd4e3791c"><td id="mnt^" class="">this year</td><td id="VEZe" class="">Представляет период времени от начала текущего года до его окончания.</td></tr><tr id="142fc6ca-70fd-8199-afc9-dbfb629242cc"><td id="mnt^" class="">last year</td><td id="VEZe" class="">Представляет весь год, предшествующий текущему.</td></tr></tbody></table><h3 id="142fc6ca-70fd-81ac-a271-e1b7751c7ec6" class="">Использование нескольких ограничений свойств в KQL-запросе</h3><p id="142fc6ca-70fd-817c-9e42-f702dcd75424" class="">Служба Поиск в SharePoint поддерживает использование нескольких ограничений свойств в одном KQL-запросе. Можно использовать либо одно свойство для нескольких ограничений свойств, либо разные свойства для каждого ограничения свойств.</p><p id="142fc6ca-70fd-8174-ada3-e01505445e57" class="">Если вы используете несколько экземпляров ограничений свойств, поиск совпадений основан на объединении ограничений свойств в KQL-запросе. В этом примере совпадения включают элементы контента, автором которого является John Smith или Jane Smith:</p><p id="142fc6ca-70fd-81f2-b4f6-f8d9049e921f" class=""><code>author:"John Smith" author:"Jane Smith"</code></p><p id="142fc6ca-70fd-813b-9235-ed3cc0af6062" class="">Результат будет таким же, как и при использовании логического оператора <strong>OR</strong> в запросе, например:</p><p id="142fc6ca-70fd-81e2-a548-d503a1dba9c7" class=""><code>author:"John Smith" OR author:"Jane Smith"</code></p><p id="142fc6ca-70fd-81bd-9c8d-cf9e28eaaf03" class="">Если вы используете различные ограничения свойств, поиск совпадений основан на пересечении ограничений свойств в KQL-запросе, например:</p><p id="142fc6ca-70fd-8173-a9f2-d5030ed682c7" class=""><code>author:"John Smith" filetype:docx</code></p><p id="142fc6ca-70fd-81fc-8f8a-f963095bd466" class="">Совпадения будут содержать документы Microsoft Word, созданные пользователем John Smith. Такой же результат будет при использовании логического оператора <strong>AND</strong>, как показано в следующем примере:</p><p id="142fc6ca-70fd-81c9-8430-d84008360842" class=""><code>author:"John Smith" AND filetype:docx</code></p><h3 id="142fc6ca-70fd-810b-a547-e9aecb55c57d" class="">Группирование ограничений свойств в KQL-запросе</h3><p id="142fc6ca-70fd-8125-9865-e2f235c0e3fc" class=""><em><strong>Область применения:</strong></em><em> Office 365 | SharePoint Online | SharePoint 2019</em></p><p id="142fc6ca-70fd-810a-8c56-ffc66eafa9cd" class="">С помощью скобок <code>()</code> можно сгруппировать несколько ограничений, связанных с определенным свойством типа <em>Text</em> в следующем формате:</p><p id="142fc6ca-70fd-81b6-a43c-dac9a9592ffd" class=""><code><Property Name>:(<Expression>)</code></p><p id="142fc6ca-70fd-81cd-aae5-fdaf04acb122" class="">В более сложных запросах может быть полезно использовать нотацию <code>()</code>, чтобы составлять более краткие и удобочитаемые выражения запросов.</p><p id="142fc6ca-70fd-8122-9e37-ee316faaa979" class="">Следующий запрос:</p><p id="142fc6ca-70fd-81fd-bc9d-e561a993f09d" class=""><code>author:"John Smith" AND author:"Jane Smith"</code></p><p id="142fc6ca-70fd-815b-8268-f41f825b236a" class="">можно перезаписать следующим образом:</p><p id="142fc6ca-70fd-8137-ac74-dd91ab503162" class=""><code>author:("John Smith" "Jane Smith")</code></p><p id="142fc6ca-70fd-8175-94eb-d51208cb1cc9" class="">Следующий запрос:</p><p id="142fc6ca-70fd-813f-9f95-e1302d6f8a15" class=""><code>title:Advanced title:Search title:Query NOT title:"Advanced Search Query"</code></p><p id="142fc6ca-70fd-8183-89f4-efe05aefa34d" class="">можно перезаписать следующим образом:</p><p id="142fc6ca-70fd-81d3-9cb5-ee56788df683" class=""><code>title:((Advanced OR Search OR Query) -"Advanced Search Query")</code></p><p id="142fc6ca-70fd-81fb-8bf9-fad0060d6590" class="">Следующий запрос:</p><p id="142fc6ca-70fd-81dc-a1ed-efaa7e6402cb" class=""><code>title:Advanced XRANK(cb=1) title:Search XRANK(cb=1) title:Query</code></p><p id="142fc6ca-70fd-8121-8b35-f75ee21065d5" class="">можно перезаписать следующим образом:</p><p id="142fc6ca-70fd-8100-9950-ec7c03fc07af" class=""><code>title:(Advanced XRANK(cb=1) Search XRANK(cb=1) Query)</code></p><p id="142fc6ca-70fd-81d3-8471-e3cbde822b38" class="">Примечание</p><p id="142fc6ca-70fd-8140-8fd9-ff087b986096" class="">При использовании символов <code>()</code> для группировки выражения в запросе свойства количество совпадений может увеличиваться, так как в этом случае отдельные ключевые слова запроса лемматизируются. Фразы в кавычках не лемматизируются.</p><p id="142fc6ca-70fd-817f-b864-c8462b22c5fd" class="">Запрос <code>title:page</code> возвращает точные совпадения с термином <em>page</em>, а запрос <code>title:(page)</code> также возвращает совпадения с термином <em>pages</em>.</p><h3 id="142fc6ca-70fd-81c2-8326-f0488a452e9b" class="">Фильтрация по элементам, в которых текстовое свойство пусто или содержит значение</h3><p id="142fc6ca-70fd-813f-a944-c40867e9f5a7" class=""><em><strong>Область применения:</strong></em><em> Office 365 | SharePoint Online</em></p><p id="142fc6ca-70fd-8160-affb-fa933afdcc3c" class="">Для управляемых свойств типа <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedDataType#Text">Text</a> в схеме поиска, для которых задано значение <a href="https://msdn.microsoft.com/library/Microsoft.Office.Server.Search.Administration.ManagedProperty.Queryable.aspx">Queryable</a> , можно использовать оператор подстановочных знаков (*) в качестве выражения свойства для фильтрации по элементам, которые имеют значение или не имеют значения.</p><p id="142fc6ca-70fd-81cb-8194-cf246b65d7cc" class="">Синтаксис для возврата элементов, в которых текстовое свойство имеет значение:</p><p id="142fc6ca-70fd-81cb-b024-ea1703a926c8" class=""><code><Property Name>:*</code></p><p id="142fc6ca-70fd-8194-9702-d1774b6e57a0" class="">Синтаксис для возврата элементов, в которых текстовое свойство не имеет значения:</p><p id="142fc6ca-70fd-8149-9e9a-c07344238bc7" class=""><code>NOT <Property Name>:*</code></p><p id="142fc6ca-70fd-815f-8e3a-d0a7764eeb64" class="">В следующем примере возвращаются сайты, связанные с центральным сайтом, за исключением самих центральных сайтов:</p><p id="142fc6ca-70fd-81bf-bcce-d313176112d4" class=""><code>(DepartmentId:* OR RelatedHubSites:*) AND contentclass:sts_site NOT IsHubSite:true</code></p><h2 id="142fc6ca-70fd-81b2-8151-d88d44f890c6" class="">Операторы KQL для сложных запросов</h2><p id="142fc6ca-70fd-8178-a666-c70a79bb463f" class="">Синтаксис языка KQL включает несколько операторов, которые можно использовать для создания сложных запросов.</p><h3 id="142fc6ca-70fd-81a6-8637-f8ef7638ae18" class="">Логические операторы</h3><p id="142fc6ca-70fd-811f-a2db-defa18adb497" class="">Используйте логические операторы, чтобы расширить или сузить область поиска. Логические операторы в KQL-запросах можно использовать с произвольными выражениями и ограничениями свойств. В таблице 5 перечислены поддерживаемые логические операторы.</p><p id="142fc6ca-70fd-8131-991c-e7c10649fedd" class=""><strong>Таблица 5. Логические операторы, поддерживаемые в KQL</strong></p><table id="142fc6ca-70fd-818b-8c20-dff77b34f6d4" class="simple-table"><tbody><tr id="142fc6ca-70fd-8128-b81c-d86a7774bc4a"><td id="bdP\" class=""><strong>Описание</strong></td><td id="`PuK" class=""><strong>Описание</strong></td></tr><tr id="142fc6ca-70fd-81d4-b248-c357b7982daa"><td id="bdP\" class=""><strong>AND</strong></td><td id="`PuK" class="">Возвращает результаты поиска, содержащие все произвольные выражения или ограничения свойств, заданные оператором <strong>AND</strong>. Укажите допустимое произвольное текстовое выражение и (или) допустимое ограничение свойств перед оператором <strong>AND</strong> и после него. Представьте, что используете знак "+".</td></tr><tr id="142fc6ca-70fd-817d-8963-cc037815f839"><td id="bdP\" class=""><strong>NOT</strong></td><td id="`PuK" class="">Возвращает результаты поиска, не содержащие заданных произвольных выражений или ограничений свойств. Укажите допустимое произвольное текстовое выражение и (или) допустимое ограничение свойств после оператора <strong>NOT</strong>. Представьте, что используете знак "-".</td></tr><tr id="142fc6ca-70fd-81a3-9f56-e2a6f5f135c1"><td id="bdP\" class=""><strong>ИЛИ</strong></td><td id="`PuK" class="">Возвращает результаты поиска, содержащие одно или несколько заданных произвольных выражений или ограничений свойств. Укажите допустимое произвольное текстовое выражение и (или) допустимое ограничение свойств перед оператором <strong>OR</strong> и после него.</td></tr></tbody></table><h3 id="142fc6ca-70fd-8135-bcc1-fab7d5e7a83f" class="">Операторы поиска с учетом расположения</h3><p id="142fc6ca-70fd-814d-b043-ef5398783046" class="">Используйте операторы поиска с учетом расположения, чтобы получить результаты, в которых заданные термины находятся в непосредственной близости друг от друга. Такие операторы вы можете использовать только с произвольными текстовыми выражениями: они не предназначены для использования с ограничениями свойств в KQL-запросах. Существует два оператора операторы поиска с учетом расположения: <strong>NEAR</strong> и <strong>ONEAR</strong>.</p><h3 id="142fc6ca-70fd-8194-ab9d-e1ca2c44bb93" class="">Оператор NEAR</h3><p id="142fc6ca-70fd-8136-bd91-c2f834907cc5" class="">Оператор <strong>NEAR</strong> возвращает совпадения, в которых заданные термины поиска находятся в непосредственной близости друг от друга (при этом не учитывается порядок следования терминов). Синтаксис оператора <strong>NEAR</strong>:</p><p id="142fc6ca-70fd-81e5-904c-db1182dc8fa6" class=""><code><expression> NEAR(n=4) <expression></code></p><p id="142fc6ca-70fd-81b6-8595-f38949e22143" class="">Где <em>n</em> — необязательный параметр, указывающий максимальное расстояние между терминами. Значение <em>n</em> является целым числом >= 0 и значением по умолчанию <strong>8</strong>.</p><p id="142fc6ca-70fd-8156-ae5a-e48f0745d9fc" class="">Параметр <em>n</em> можно указать как <code>n=v</code> , где <em>v</em> представляет значение, или сокращен до <em>только v</em>; например <code>NEAR(4)</code> , где <em>v</em> равно 4.</p><p id="142fc6ca-70fd-81cc-a1cc-c5ed328237ef" class="">Например:</p><p id="142fc6ca-70fd-81ed-aff4-f6cd197ca8a9" class=""><code>"acquisition" NEAR "debt"</code></p><p id="142fc6ca-70fd-8196-808d-c4c8e77fedbe" class="">Результатом запроса будут элементы, в которых термины "acquisition" и "debt" появляются в одном элементе, в котором за термином "acquisition" следует до восьми других терминов, а за ними "debt" (или наоборот). Порядок терминов при поиске совпадений не учитывается.</p><p id="142fc6ca-70fd-819d-9482-f2d2fe72ac2d" class="">Если вам нужно меньшее расстояние между терминами, укажите его. Результатом следующего запроса будут элементы, в которых термины "acquisition" и "debt" появляются в одном элементе, при этом между ними не более трех терминов. Порядок следования терминов также не учитывается.</p><p id="142fc6ca-70fd-812e-8701-e9cc7780935f" class=""><code>"acquisition" NEAR(n=3) "debt"</code></p><p id="142fc6ca-70fd-8174-b6dd-f6fd5c0f3f59" class="">Примечание</p><p id="142fc6ca-70fd-814c-9494-f7b102077a90" class="">В SharePoint оператор <strong>NEAR</strong> больше не сохраняет порядок токенов. Кроме того, оператор <strong>NEAR</strong> теперь принимает необязательный параметр, который указывает максимальное расстояние до токена. Однако значение по умолчанию все еще равно <strong>8</strong>. Если нужно реализовать предыдущее поведение, используйте оператор <strong>ONEAR</strong>.</p><h3 id="142fc6ca-70fd-81e8-a473-eaa3b0ff203d" class="">Оператор ONEAR</h3><p id="142fc6ca-70fd-8176-8171-d838fa78238b" class="">Оператор <strong>ONEAR</strong> соответствует результатам, в которых указанные условия поиска находятся в непосредственной близости друг от друга, сохраняя при этом порядок терминов. Синтаксис <strong>ONEAR</strong> выглядит следующим образом, где <em>n</em> — необязательный параметр, указывающий максимальное расстояние между терминами. Значение <em>n</em> является целым числом >= 0 и значением по умолчанию <strong>8</strong>.</p><p id="142fc6ca-70fd-8199-b5b0-edb34658512d" class=""><code><expression> ONEAR(n=4) <expression></code></p><p id="142fc6ca-70fd-8112-b1c1-dd5a82e52bf6" class="">Параметр <em>n</em> можно указать как <code>n=v</code> , где <em>v</em> представляет значение, или сокращен до <em>только v</em>; например <code>ONEAR(4)</code> , где <em>v</em> равно 4.</p><p id="142fc6ca-70fd-8136-8b97-ca2609baffab" class="">Например, результатом следующего запроса будут элементы, в которых термины "acquisition" и "debt" появляются в одном элементе, при этом за термином "acquisition" следует до восьми других терминов, а за ними "debt". Порядок следования терминов <strong>должен</strong> совпадать с их порядком в возвращаемом элементе:</p><p id="142fc6ca-70fd-8155-b05b-c19c6f743b75" class=""><code>"acquisition" ONEAR "debt"</code></p><p id="142fc6ca-70fd-811c-a6d4-eddc9fff6e35" class="">Если требуется меньшее расстояние между терминами, укажите его, как показано в примере ниже. Результатом следующего запроса будут элементы, в которых термины "acquisition" и "debt" появляются в одном элементе, при этом между ними не более 3 терминов. Порядок следования терминов <strong>должен</strong> совпадать с их порядком в возвращаемом элементе:</p><p id="142fc6ca-70fd-81ea-b293-d7d075b31a22" class=""><code>"acquisition" ONEAR(n=3) "debt"</code></p><h3 id="142fc6ca-70fd-818b-b965-d21e2720ab37" class="">Операторы поиска синонимов</h3><p id="142fc6ca-70fd-811a-b96f-eb5586a3b612" class="">Оператор <strong>WORDS</strong> используется, чтобы указать, что термины в запросе являются синонимами, а возвращаемые результаты должны соответствовать любой из указанных терминов. Оператор <strong>WORDS</strong> можно использовать только с свободными текстовыми выражениями; Он не поддерживается с ограничениями свойств в запросах KQL.</p><p id="142fc6ca-70fd-8112-af9a-e5200e02f666" class="">Указанный ниже пример запроса выдает результаты, содержащие термин "TV" или "television". Под ним приведен еще один запрос, его результаты аналогичны предыдущим.</p><p id="142fc6ca-70fd-81ed-80cd-e6cf6c0639df" class=""><code>WORDS(TV, Television)</code></p><p id="142fc6ca-70fd-8152-a652-eea4868f55d2" class=""><code>TV OR Television</code></p><p id="142fc6ca-70fd-816b-b9f0-c0960e1489f7" class="">Эти запросы отличаются ранжированием результатов. При использовании оператора <strong>WORDS</strong> термины "TV" и "television" рассматриваются как синонимы, а не как отдельные термины. Поэтому оба эти термина ранжируются, как если бы они были одним термином. Например, элемент контента, содержащий один термин "television" и пять терминов "TV", ранжируется так же, как элемент контента с шестью терминами "TV".</p><h3 id="142fc6ca-70fd-81de-9faf-fe5fcc1fcce5" class="">Оператор подстановочного знака</h3><p id="142fc6ca-70fd-814d-86b7-cef3bf226126" class="">Используйте оператор подстановочного знака (символ звездочки, "<strong>*</strong>"), чтобы включить сопоставление префиксов. Вы можете указать в запросе начальную часть слова, поставив далее оператор подстановочного знака, как показано ниже. Результат следующего запроса — термины, начинающиеся на "serv" (при этом далее могут следовать другие знаки), например "serve", "server", "service":</p><p id="142fc6ca-70fd-81e7-9aa4-ffac5c9de4d5" class=""><code>serv*</code></p><h3 id="142fc6ca-70fd-81ec-add1-f72158c1d97e" class="">Операторы включения и исключения</h3><p id="142fc6ca-70fd-816a-b81c-fe4eb7b6a6a8" class="">С помощью операторов включения и исключения, описанных в таблице 6, вы можете указать, будут ли возвращаемые результаты включать или исключать контент, совпадающий со значением, указанным в произвольном текстовом выражении или ограничении свойств.</p><p id="142fc6ca-70fd-813b-ac64-d6f366161672" class=""><strong>Таблица 6. Операторы для включения и исключения контента в результатах</strong></p><table id="142fc6ca-70fd-8166-90ca-ea3f02715575" class="simple-table"><tbody><tr id="142fc6ca-70fd-81f3-825f-ff1792af5c38"><td id="y}{g" class=""><strong>Имя</strong></td><td id="O\Q}" class=""><strong>Оператор</strong></td><td id="Yguv" class=""><strong>Поведение</strong></td></tr><tr id="142fc6ca-70fd-8144-a10c-f06ba468a3a1"><td id="y}{g" class="">Включение</td><td id="O\Q}" class="">" <strong>+</strong> "</td><td id="Yguv" class="">Включает в результаты контент со значениями, совпадающими с теми, которые нужно включить. Это поведение по умолчанию, если символы не указаны. Аналогичный результат будет при использовании оператора <strong>AND</strong>.</td></tr><tr id="142fc6ca-70fd-813c-8be5-f19c3f3ed9ad"><td id="y}{g" class="">Исключения</td><td id="O\Q}" class="">" <strong>-</strong> "</td><td id="Yguv" class="">Исключает контент со значениями, совпадающими с теми, которые нужно исключить. Аналогичный результат будет при использовании оператора <strong>NOT</strong>.</td></tr></tbody></table><h3 id="142fc6ca-70fd-81b5-97c0-f943e2616c27" class="">Оператор динамического ранжирования</h3><p id="142fc6ca-70fd-811f-9b85-ee36a7ef476f" class="">Применяйте оператор <strong>XRANK</strong>, чтобы повысить динамический рейтинг элементов в зависимости от повторений определенных терминов в <em>match expression</em>, не меняя состав элементов, удовлетворяющих критериям запроса. Выражение <strong>XRANK</strong> содержит один компонент, который должен быть сопоставлен, <em>выражение соответствия</em> и один или несколько компонентов, которые влияют только на динамическое ранжирование, <em>выражение ранжирования</em>. Должен быть задан хотя бы <strong>один</strong> параметр (за исключением <em>n</em>), чтобы выражение <strong>XRANK</strong> было допустимым.</p><p id="142fc6ca-70fd-81ed-9779-d65ed7cb47f0" class="">Примечание</p><p id="142fc6ca-70fd-8130-a2cb-c425fbc8c7b6" class="">Задержка при выполнении запроса (и вероятность превышения времени ожидания) растет при использовании сложных запросов, особенно с операторами xrank. Увеличение задержки при выполнении запроса зависит от количества операторов <strong>XRANK</strong> и количества совпадений в компонентах <em>совпадение выражения</em> и <em>ранжирующее выражение</em> в дереве запросов.</p><p id="142fc6ca-70fd-81b3-9b1b-ead597a6a786" class="">Параметр <em>Match expressions</em> может быть любым допустимым выражением KQL, включая вложенные выражения <strong>XRANK</strong>. Параметр <em>Rank expressions</em> может быть любым допустимым выражением в языке KQL, кроме выражений <strong>XRANK</strong>. Если KQL-запросы содержат несколько операторов <strong>XRANK</strong>, итоговое значение динамического рейтинга рассчитывается как сумма увеличений по всем операторам <strong>XRANK</strong>.</p><p id="142fc6ca-70fd-81f5-805e-cdf82175247c" class="">Примечание</p><p id="142fc6ca-70fd-81ed-afc8-d5762a37d369" class="">Используйте скобки, чтобы явно указать порядок вычисления для KQL-запросов, содержащих более одного оператора <strong>XRANK</strong> на одном уровне.</p><p id="142fc6ca-70fd-81d7-a798-c3a0d81bc3fe" class="">Можно использовать следующий синтаксис оператора <strong>XRANK</strong>:</p><p id="142fc6ca-70fd-81c9-903a-cbf25680a556" class=""><code><match expression> XRANK(cb=100, rb=0.4, pb=0.4, avgb=0.4, stdb=0.4, nb=0.4, n=200) <rank expression></code></p><p id="142fc6ca-70fd-812e-9869-ec5941fb13f5" class="">Динамического рейтинг с использованием оператора <strong>XRANK</strong> вычисляется по формуле:</p><figure id="142fc6ca-70fd-814f-8a2e-c4c301077f95" class="image"><a href="https://learn.microsoft.com/ru-ru/sharepoint/dev/images/xrankformula.gif"><img src="https://learn.microsoft.com/ru-ru/sharepoint/dev/images/xrankformula.gif"/></a></figure><p id="142fc6ca-70fd-8196-b7da-f0975859d2ae" class="">Формула для оператора XRANK</p><p id="142fc6ca-70fd-81eb-9ea3-cec97392c56e" class="">В таблице 7 перечислены основные параметры, доступные для оператора <strong>XRANK</strong>.</p><p id="142fc6ca-70fd-8194-b0a9-fef2479b2184" class=""><strong>Таблица 7. Параметры оператора XRANK</strong></p><table id="142fc6ca-70fd-810b-b0d7-c678ac498df4" class="simple-table"><tbody><tr id="142fc6ca-70fd-8192-933a-c0d6589b5477"><td id="HvvC" class=""><strong>Параметр</strong></td><td id=":>zK" class=""><strong>Значение</strong></td><td id="piMv" class=""><strong>Описание</strong></td></tr><tr id="142fc6ca-70fd-816d-b6be-e249b59d17ec"><td id="HvvC" class=""><em>n</em></td><td id=":>zK" class=""><em><целое_число></em></td><td id="piMv" class="">Задает количество результатов, для которых вычисляются статистические данные. Этот параметр не влияет на количество результатов, на которые влияет динамический рейтинг. С его помощью из вычисления статистики просто исключаются ненужные элементы. Значение по умолчанию: <strong>0</strong>. Нулевое значение содержит семантику <em>всех документов</em> .</td></tr><tr id="142fc6ca-70fd-81bf-b41b-dc865378276e"><td id="HvvC" class=""><em>nb</em></td><td id=":>zK" class=""><em><значение_с_плавающей_запятой></em></td><td id="piMv" class="">Параметр <em>nb</em> ссылается на нормированную величину. Этот параметр определяет коэффициент, на который умножается произведение дисперсии и среднего арифметического значений рейтингов в наборе результатов. Параметр <em>f</em> в формуле XRANK.</td></tr></tbody></table><p id="142fc6ca-70fd-81c1-8635-d6a5c02abf0d" class="">Как правило, нормализованный boost, <em>nb</em>, является единственным параметром, который изменяется. Этого параметра достаточно, чтобы понижать или повышать рейтинг отдельного элемента, не учитывая стандартное отклонение.</p><p id="142fc6ca-70fd-8187-9544-d78cd25a732d" class="">Доступны также дополнительные параметры, указанные ниже. Но обычно они не используются.</p><p id="142fc6ca-70fd-8139-b41d-c7ca1b9ff1ba" class=""><strong>Таблица 8. Дополнительные параметры оператора XRANK</strong></p><table id="142fc6ca-70fd-8162-8448-eee89dd6de40" class="simple-table"><tbody><tr id="142fc6ca-70fd-8186-9b91-e222c44fc168"><td id="bWT_" class=""><strong>Параметр</strong></td><td id="\qM}" class=""><strong>Значение</strong></td><td id="]Npa" class=""><strong>Описание</strong></td></tr><tr id="142fc6ca-70fd-8177-9550-f05de64dc917"><td id="bWT_" class=""><em>cb</em></td><td id="\qM}" class=""><em><значение_с_плавающей_запятой></em></td><td id="]Npa" class="">Параметр <em>cb</em> ссылается на постоянную величину. Значение по умолчанию: <strong>0</strong>. Параметр <em>a</em> в формуле XRANK.</td></tr><tr id="142fc6ca-70fd-81c4-aa2b-c2c2835cce65"><td id="bWT_" class=""><em>stdb</em></td><td id="\qM}" class=""><em><значение_с_плавающей_запятой></em></td><td id="]Npa" class="">Параметр <em>stdb</em> ссылается на величину стандартного отклонения. Значение по умолчанию: <strong>0</strong>. Параметр <em>e</em> в формуле XRANK.</td></tr><tr id="142fc6ca-70fd-8154-8eb1-fb660e40cb3d"><td id="bWT_" class=""><em>avgb</em></td><td id="\qM}" class=""><em><значение_с_плавающей_запятой></em></td><td id="]Npa" class="">Параметр <em>avgb</em> ссылается на среднее значение. По умолчанию: <strong>0</strong>. Параметр <em>d</em> в формуле XRANK.</td></tr><tr id="142fc6ca-70fd-819a-8455-f2908f4a3952"><td id="bWT_" class=""><em>rb</em></td><td id="\qM}" class=""><em><значение_с_плавающей_запятой></em></td><td id="]Npa" class="">Параметр <em>rb</em> ссылается на диапазон значений. Этот коэффициент умножается на диапазон значений рейтингов в наборе результатов. Значение по умолчанию: <strong>0</strong>. Параметр <em>b</em> в формуле XRANK.</td></tr><tr id="142fc6ca-70fd-81ee-ba39-d839254409b5"><td id="bWT_" class=""><em>pb</em></td><td id="\qM}" class=""><em><значение_с_плавающей_запятой></em></td><td id="]Npa" class="">Параметр <em>pb</em> ссылается на значение в процентах. Этот коэффициент умножается на собственный рейтинг элемента в сравнении с минимальным значением в наборе. Значение по умолчанию: <strong>0</strong>. Параметр <em>c</em> в формуле XRANK.</td></tr></tbody></table><h3 id="142fc6ca-70fd-8183-9403-ef8bfcbe7b10" class="">Примеры</h3><p id="142fc6ca-70fd-81fe-b55b-ee2b2b150b10" class=""><strong>Пример 1.</strong> Следующее выражение сопоставляет элементы, для которых полнотекстовый индекс по умолчанию содержит "cat" или "dog". Выражение увеличивает на постоянную величину 100 динамический рейтинг элементов, содержащих также термин "thoroughbred".</p><p id="142fc6ca-70fd-8133-89ff-cd9b1c2ef5b4" class=""><code>(cat OR dog) XRANK(cb=100) thoroughbred</code></p><p id="142fc6ca-70fd-81dd-869c-e172b2966669" class=""><strong>Пример 2.</strong> Следующее выражение сопоставляет элементы, для которых полнотекстовый индекс по умолчанию содержит термины "cat" или "dog". Выражение увеличивает динамический рейтинг элементов на нормированную величину 1,5 для элементов, содержащих также термин "thoroughbred".</p><p id="142fc6ca-70fd-811b-b5b9-f9d0fecf77e5" class=""><code>(cat OR dog) XRANK(nb=1.5) thoroughbred</code></p><p id="142fc6ca-70fd-8155-a8fe-e9f787010be0" class=""><strong>Пример 3.</strong> Следующее выражение сопоставляет элементы, для которых полнотекстовый индекс по умолчанию содержит термины "cat" или "dog". Выражение увеличивает динамический рейтинг элементов на постоянную величину 100 и нормированную величину 1,5 для элементов, содержащих также термин "thoroughbred".</p><p id="142fc6ca-70fd-8182-9733-eab55a9b83a2" class=""><code>(cat OR dog) XRANK(cb=100, nb=1.5) thoroughbred</code></p><p id="142fc6ca-70fd-81e0-9017-f4d8ff83294e" class=""><strong>Пример 4.</strong> Следующее выражение сопоставляет все элементы, содержащие термин "animals", и увеличивает динамический рейтинг следующим образом:</p><ul id="142fc6ca-70fd-8108-a595-c9504041af47" class="bulleted-list"><li style="list-style-type:disc">динамический ранг элементов, содержащих термин "dogs", увеличивается на 100 баллов;</li></ul><ul id="142fc6ca-70fd-81fe-9b48-df6330ccfd36" class="bulleted-list"><li style="list-style-type:disc">динамический ранг элементов, содержащих термин "cats", увеличивается на 200 баллов;</li></ul><ul id="142fc6ca-70fd-8154-9c90-eec034f61648" class="bulleted-list"><li style="list-style-type:disc">динамический рейтинг элементов, содержащих и термин "dogs", и термин "cats", увеличивается на 300 баллов.</li></ul><p id="142fc6ca-70fd-8193-9c5b-c2d608d47d0f" class=""><code>(animals XRANK(cb=100) dogs) XRANK(cb=200) cats</code></p><h3 id="142fc6ca-70fd-81e9-9c5b-e8e3f6cf63e1" class="">Круглые скобки</h3><p id="142fc6ca-70fd-8183-96e8-e02b910a4eec" class="">Можно объединять разные части запросов по ключевым словам с помощью открывающей скобки " <strong>(</strong> " и закрывающей скобки " <strong>)</strong> ". Каждой открывающей скобке " <strong>(</strong> " должна соответствовать закрывающая скобка " <strong>)</strong> ". Пробел до или после скобки не влияет на запрос.</p></div></article><span class="sans" style="font-size:14px;padding-top:2em"></span></body></html> |