CINXE.COM

<!doctype html> <html class="hasSidebar hasPageActions hasBreadcrumb conceptual has-default-focus theme-light" lang="en-us" dir="ltr" data-authenticated="false" data-auth-status-determined="false" data-target="docs" x-ms-format-detection="none"> <head> <base href="https://learn.microsoft.com/en-us/azure/search/query-lucene-syntax"> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <meta property="og:title" content="Lucene query syntax - Azure AI Search"> <meta property="og:type" content="website"> <meta property="og:url" content="https://learn.microsoft.com/en-us/azure/search/query-lucene-syntax"> <meta property="og:description" content="Reference for the full Lucene query syntax, as used in Azure AI Search for wildcard, fuzzy search, RegEx, and other advanced query constructs."> <meta property="og:image" content="https://learn.microsoft.com/en-us/media/open-graph-image.png"> <meta property="og:image:alt" content="Microsoft Learn"> <meta name="twitter:card" content="summary_large_image"> <meta name="twitter:site" content="@MicrosoftLearn"> <meta name="color-scheme" content="light dark"> <meta name="author" content="BevLoh"> <meta name="breadcrumb_path" content="../breadcrumb/azure-ai/toc.json"> <meta name="depot_name" content="Learn.azure-ai"> <meta name="description" content="Reference for the full Lucene query syntax, as used in Azure AI Search for wildcard, fuzzy search, RegEx, and other advanced query constructs."> <meta name="document_id" content="7dabd64d-2dce-2c70-0cb0-8c80a37ccad0"> <meta name="document_version_independent_id" content="4fcbd335-01bf-dd4a-1638-7bc81f2f2711"> <meta name="feedback_help_link_type" content="get-help-at-qna"> <meta name="feedback_help_link_url" content="https://learn.microsoft.com/en-us/answers/tags/109/azure-cognitive-search"> <meta name="feedback_product_url" content="https://feedback.azure.com/d365community/forum/9325d19e-0225-ec11-b6e6-000d3a4f07b8"> <meta name="feedback_system" content="Standard"> <meta name="git_commit_id" content="967e77459bbe0cd11a5cbbdb42ecae2b4bb02d23"> <meta name="gitcommit" content="https://github.com/MicrosoftDocs/azure-ai-docs-pr/blob/967e77459bbe0cd11a5cbbdb42ecae2b4bb02d23/articles/search/query-lucene-syntax.md"> <meta name="learn_banner_products" content="azure"> <meta name="locale" content="en-us"> <meta name="manager" content="nitinme"> <meta name="ms.author" content="beloh"> <meta name="ms.collection" content="ce-skilling-ai-copilot"> <meta name="ms.custom" content="ignite-2023"> <meta name="ms.date" content="09/19/2024"> <meta name="ms.service" content="azure-ai-search"> <meta name="ms.suite" content="office"> <meta name="ms.topic" content="concept-article"> <meta name="original_content_git_url" content="https://github.com/MicrosoftDocs/azure-ai-docs-pr/blob/live/articles/search/query-lucene-syntax.md"> <meta name="page_type" content="conceptual"> <meta name="permissioned-type" content="public"> <meta name="recommendation_types" content="Training"> <meta name="recommendation_types" content="Certification"> <meta name="recommendations" content="true"> <meta name="schema" content="Conceptual"> <meta name="site_name" content="Docs"> <meta name="toc_rel" content="toc.json"> <meta name="uhfHeaderId" content="azure"> <meta name="updated_at" content="2024-10-11 08:18 AM"> <meta name="word_count" content="2836"> <meta name="persistent_id" content="26d62756-c0e6-1bdd-70eb-b3bac27923ff"> <meta name="cmProducts" content="https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/12ed19f9-ebdf-4c8a-8bcd-7a681836774d" data-source="generated"> <meta name="spProducts" content="https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/3a764584-4f97-452b-8f1d-36f19b12f6ae" data-source="generated"> <meta name="scope" content="Azure"> <meta name="github_feedback_content_git_url" content="https://github.com/MicrosoftDocs/azure-ai-docs/blob/main/articles/search/query-lucene-syntax.md"> <link href="https://learn.microsoft.com/en-us/azure/search/query-lucene-syntax" rel="canonical"> <title>Lucene query syntax - Azure AI Search | Microsoft Learn</title> <link rel="stylesheet" href="/static/assets/0.4.028726178/styles/site-ltr.css"> <script id="msdocs-script"> var msDocs = {environment: { supportLevel: 'production', accessLevel: 'online', reviewFeatures: false, systemContent: true, azurePortalHostname: 'portal.azure.com', legacyHosting: false, siteName: 'learn', },data: { timeOrigin: Date.now(), contentLocale: 'en-us', contentDir: 'ltr', userLocale: 'en-us', userDir: 'ltr', pageTemplate: 'Conceptual', brand: 'azure', context: {}, hasBinaryRating: true, feedbackHelpLinkType:'get-help-at-qna', feedbackHelpLinkUrl:'https://learn.microsoft.com/en-us/answers/tags/109/azure-cognitive-search', standardFeedback: true, showFeedbackReport: false, enableTutorialFeedback: false, feedbackSystem: 'Standard', feedbackGitHubRepo: 'MicrosoftDocs/azure-docs', feedbackProductUrl: 'https://feedback.azure.com/d365community/forum/9325d19e-0225-ec11-b6e6-000d3a4f07b8',extendBreadcrumb: false,isEditDisplayable: true, hideViewSource: false, hasPageActions: true, hasPrintButton: true, hasBookmark: true, hasShare: true, isPermissioned: false, isPrivateUnauthorized: false,hasRecommendations: true,contributors: [{ name: "BevLoh", url: "https://github.com/BevLoh" },{ name: "HeidiSteen", url: "https://github.com/HeidiSteen" },{ name: "mattgotteiner", url: "https://github.com/mattgotteiner" },{ name: "dereklegenzoff", url: "https://github.com/dereklegenzoff" },{ name: "v-dihans", url: "https://github.com/v-dihans" },{ name: "DCtheGeek", url: "https://github.com/DCtheGeek" },{ name: "brjohnstmsft", url: "https://github.com/brjohnstmsft" },{ name: "v-makoud", url: "https://github.com/v-makoud" },{ name: "nschonni", url: "https://github.com/nschonni" },{ name: "MSshujia", url: "https://github.com/MSshujia" },{ name: "changeworld", url: "https://github.com/changeworld" }],}, functions:{} }; </script> <script src="https://wcpstatic.microsoft.com/mscc/lib/v2/wcp-consent.js"></script> <script src="https://js.monitor.azure.com/scripts/c/ms.jsll-4.min.js"></script> <script src="/static/assets/0.4.028726178/global/deprecation.js"></script> <script src="/static/assets/0.4.028726178/scripts/en-us/index-docs.js"></script> <meta http-equiv="X-Translated-By" content="Google"> <meta http-equiv="X-Translated-To" content="de"> <script type="text/javascript" src="https://www.gstatic.com/_/translate_http/_/js/k=translate_http.tr.en_GB.omlEigW4xY8.O/am=DgY/d=1/rs=AN8SPfpjsL9kUWY0h-sp7Ilu7hZWGwEmeg/m=corsproxy" data-sourceurl="https://learn.microsoft.com/en-us/azure/search/query-lucene-syntax"></script> <link href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@20..48,100..700,0..1,-50..200" rel="stylesheet"> <script type="text/javascript" src="https://www.gstatic.com/_/translate_http/_/js/k=translate_http.tr.en_GB.omlEigW4xY8.O/am=DgY/d=1/exm=corsproxy/ed=1/rs=AN8SPfpjsL9kUWY0h-sp7Ilu7hZWGwEmeg/m=phishing_protection" data-phishing-protection-enabled="false" data-forms-warning-enabled="true" data-source-url="https://learn.microsoft.com/en-us/azure/search/query-lucene-syntax"></script> <meta name="robots" content="none"> </head> <body lang="en-us" dir="ltr"> <script type="text/javascript" src="https://www.gstatic.com/_/translate_http/_/js/k=translate_http.tr.en_GB.omlEigW4xY8.O/am=DgY/d=1/exm=corsproxy,phishing_protection/ed=1/rs=AN8SPfpjsL9kUWY0h-sp7Ilu7hZWGwEmeg/m=navigationui" data-environment="prod" data-proxy-url="https://learn-microsoft-com.translate.goog" data-proxy-full-url="https://learn-microsoft-com.translate.goog/en-us/azure/search/query-lucene-syntax?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-source-url="https://learn.microsoft.com/en-us/azure/search/query-lucene-syntax" data-source-language="pl" data-target-language="de" data-display-language="en-GB" data-detected-source-language="" data-is-source-untranslated="false" data-source-untranslated-url="https://translate.google.com/website?sl=pl&tl=de&hl=en-GB&u=https://learn.microsoft.com/en-us/azure/search/query-lucene-syntax&anno=2" data-client="tr"></script> <div class="header-holder has-default-focus"><a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/query-lucene-syntax?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB#main" style="z-index: 1070" class="outline-color-text visually-hidden-until-focused position-fixed inner-focus focus-visible top-0 left-0 right-0 padding-xs text-align-center has-body-background" tabindex="1">Skip to main content</a> <div hidden id="cookie-consent-holder" data-test-id="cookie-consent-container"></div> <div id="unsupported-browser" style=" background-color: white; color: black; padding: 16px; border-bottom: 1px solid grey;" hidden> <div style="max-width: 800px; margin: 0 auto;"> <p style="font-size: 24px">This browser is no longer supported.</p> <p style="font-size: 16px; margin-top: 16px;">Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.</p> <div style="margin-top: 12px;"><a href="https://translate.google.com/website?sl=pl&tl=de&hl=en-GB&u=https://go.microsoft.com/fwlink/p/?LinkID%3D2092881+" style=" background-color: #0078d4; border: 1px solid #0078d4; color: white; padding: 6px 12px; border-radius: 2px; display: inline-block; ">Download Microsoft Edge</a> <a href="https://learn-microsoft-com.translate.goog/en-us/lifecycle/faq/internet-explorer-microsoft-edge?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" style=" background-color: white; padding: 6px 12px; border: 1px solid #505050; color: #171717; border-radius: 2px; display: inline-block; ">More info about Internet Explorer and Microsoft Edge</a> </div> </div> </div>  <header id="ms--site-header" data-test-id="site-header-wrapper" role="banner" itemscope itemtype="http://schema.org/Organization"> <div id="ms--mobile-nav" class="site-header display-none-tablet padding-inline-none gap-none" data-bi-name="mobile-header" data-test-id="mobile-header"></div> <div id="ms--primary-nav" class="site-header display-none display-flex-tablet" data-bi-name="L1-header" data-test-id="primary-header"></div> <div id="ms--secondary-nav" class="site-header display-none display-flex-tablet" data-bi-name="L2-header" data-test-id="secondary-header"></div> </header> <div id="content-header" class="content-header uhf-container has-padding has-default-focus border-bottom-none" data-bi-name="content-header"> <div class="content-header-controls margin-xxs margin-inline-sm-tablet"><button type="button" class="contents-button button button-sm margin-right-xxs" data-bi-name="contents-expand" aria-haspopup="true" data-contents-button> <span class="icon"><span class="docon docon-menu" aria-hidden="true"></span></span> <span class="contents-expand-title">Table of contents</span> </button> <button type="button" class="ap-collapse-behavior ap-expanded button button-sm" data-bi-name="ap-collapse" aria-controls="action-panel"> <span class="icon"><span class="docon docon-exit-mode" aria-hidden="true"></span></span> <span>Exit focus mode</span> </button> </div> </div> <div id="disclaimer-holder" class="has-overflow-hidden has-default-focus"> </div> </div> <div class="mainContainer uhf-container has-default-focus" data-bi-name="body"> <div class="columns has-large-gaps is-gapless-mobile "> <div id="left-container" class="left-container is-hidden-mobile column is-one-third-tablet is-one-quarter-desktop"> <nav id="affixed-left-container" class="margin-top-sm-tablet position-sticky display-flex flex-direction-column" aria-label="Primary"></nav> </div> <section class="primary-holder column is-two-thirds-tablet is-three-quarters-desktop"> <div class="columns is-gapless-mobile has-large-gaps "> <div id="main-column" class="column is-full is-8-desktop"> <main id="main" class="" role="main" data-bi-name="content" lang="en-us" dir="ltr">  <div id="article-header" class="background-color-body margin-top-sm-tablet margin-bottom-xs display-none-print"> <div class="display-flex align-items-center "> <details id="article-header-breadcrumbs-overflow-popover" class="popover" data-for="article-header-breadcrumbs"><summary class="button button-clear button-primary button-sm inner-focus" aria-label="All breadcrumbs"> <span class="icon"> <span class="docon docon-more"></span> </span> </summary> <div id="article-header-breadcrumbs-overflow" class="popover-content padding-none"> </div> </details><bread-crumbs id="article-header-breadcrumbs" data-test-id="article-header-breadcrumbs" class="overflow-hidden flex-grow-1 margin-right-sm margin-right-md-tablet margin-right-lg-desktop margin-left-negative-xxs padding-left-xxs"></bread-crumbs> <div id="article-header-page-actions" class="opacity-none margin-left-auto display-flex flex-wrap-no-wrap align-items-stretch"> <a id="lang-link-tablet" class="button button-primary button-clear button-sm display-none display-inline-flex-tablet" title="Read in English" data-bi-name="language-toggle" data-read-in-link hidden> <span class="icon margin-none" aria-hidden="true" data-read-in-link-icon> <span class="docon docon-locale-globe"></span> </span> <span class="is-visually-hidden" data-read-in-link-text>Read in English</span> </a><button type="button" class="collection button button-clear button-sm button-primary display-none display-inline-flex-tablet" data-list-type="collection" data-bi-name="collection" title="Add to collection"> <span class="icon margin-none" aria-hidden="true"> <span class="docon docon-circle-addition"></span> </span> <span class="collection-status is-visually-hidden">Save</span> </button><a data-contenteditbtn class="button button-clear button-sm text-decoration-none button-primary display-none display-inline-flex-tablet" aria-label="Edit" title="Edit This Document" data-bi-name="edit" href="https://translate.google.com/website?sl=pl&tl=de&hl=en-GB&u=https://github.com/MicrosoftDocs/azure-ai-docs/blob/main/articles/search/query-lucene-syntax.md" data-original_content_git_url="https://github.com/MicrosoftDocs/azure-ai-docs-pr/blob/live/articles/search/query-lucene-syntax.md" data-original_content_git_url_template="{repo}/blob/{branch}/articles/search/query-lucene-syntax.md" data-pr_repo="" data-pr_branch=""> <span class="icon margin-none" aria-hidden="true"> <span class="docon docon-edit-outline"></span> </span> </a> <details class="popover popover-right" id="article-header-page-actions-overflow"><summary class="justify-content-flex-start button button-clear button-sm button-primary" aria-label="More actions" title="More actions"> <span class="icon" aria-hidden="true"> <span class="docon docon-more-vertical"></span> </span> </summary> <div class="popover-content padding-xs"> <button data-page-action-item="overflow-mobile" type="button" class="justify-content-flex-start button-block button-sm has-inner-focus button button-clear display-none-tablet" data-bi-name="contents-expand" data-contents-button data-popover-close> <span class="icon"> <span class="docon docon-editor-list-bullet" aria-hidden="true"></span> </span><span class="contents-expand-title">Table of contents</span></button><a id="lang-link-overflow" class="justify-content-flex-start button-sm has-inner-focus button button-clear button-block display-none-tablet" title="Read in English" data-bi-name="language-toggle" data-page-action-item="overflow-mobile" data-check-hidden="true" data-read-in-link hidden> <span class="icon" aria-hidden="true" data-read-in-link-icon> <span class="docon docon-locale-globe"></span> </span> <span data-read-in-link-text>Read in English</span> </a><button type="button" class="collection justify-content-flex-start button button-clear button-sm has-inner-focus button-block display-none-tablet" data-list-type="collection" data-bi-name="collection" title="Save" data-page-action-item="overflow-mobile" data-check-hidden="true" data-popover-close> <span class="icon" aria-hidden="true"> <span class="docon docon-circle-addition"></span> </span> <span class="collection-status">Save</span> </button> <button type="button" class="collection justify-content-flex-start button button-clear button-sm has-inner-focus button-block display-none-tablet" data-list-type="plan" data-bi-name="plan" title="Add to Plan" data-page-action-item="overflow-mobile" data-check-hidden="true" data-popover-close hidden> <span class="icon" aria-hidden="true"> <span class="docon docon-circle-addition"></span> </span> <span class="plan-status">Add to Plan</span> </button><a data-contenteditbtn class="button button-clear button-block button-sm has-inner-focus justify-content-flex-start text-decoration-none display-none-tablet" aria-label="Edit" title="Edit This Document" data-bi-name="edit" href="https://translate.google.com/website?sl=pl&tl=de&hl=en-GB&u=https://github.com/MicrosoftDocs/azure-ai-docs/blob/main/articles/search/query-lucene-syntax.md" data-original_content_git_url="https://github.com/MicrosoftDocs/azure-ai-docs-pr/blob/live/articles/search/query-lucene-syntax.md" data-original_content_git_url_template="{repo}/blob/{branch}/articles/search/query-lucene-syntax.md" data-pr_repo="" data-pr_branch=""> <span class="icon" aria-hidden="true"> <span class="docon docon-edit-outline"></span> </span> <span>Edit</span> </a> <div aria-hidden="true" class="margin-none" data-page-action-item="overflow-all"></div> <hr class="display-none-tablet margin-bottom-xxs margin-top-xxs"> <h4 class="font-size-sm padding-left-xxs">Share via</h4><a class="button button-clear button-sm button-block has-inner-focus text-decoration-none justify-content-flex-start share-facebook" data-bi-name="facebook" data-page-action-item="overflow-all"> <span class="icon" aria-hidden="true"> <span class="docon docon-facebook-share font-size-md color-primary"></span> </span> <span class="margin-left-xxs">Facebook</span> </a> <a class="button button-clear button-sm has-inner-focus button-block text-decoration-none justify-content-flex-start share-twitter" data-bi-name="twitter" data-page-action-item="overflow-all"> <span class="icon" aria-hidden="true"> <span class="docon docon-xlogo-share font-size-xxs"></span> </span> <span class="margin-left-xxs">x.com</span> </a> <a class="button button-clear button-sm has-inner-focus button-block text-decoration-none justify-content-flex-start share-linkedin" data-bi-name="linkedin" data-page-action-item="overflow-all"> <span class="icon" aria-hidden="true"> <span class="docon docon-linked-in-logo font-size-sm color-primary"></span> </span> <span class="margin-left-xxs">LinkedIn</span> </a> <a class="button button-clear button-sm button-block has-inner-focus text-decoration-none justify-content-flex-start margin-bottom-xxs share-email" data-bi-name="email" data-page-action-item="overflow-all"> <span class="icon" aria-hidden="true"> <span class="docon docon-mail-message font-size-sm color-primary"></span> </span> <span class="margin-left-xxs">Email</span> </a> <hr><button class="button button-block button-clear button-sm justify-content-flex-start has-inner-focus margin-top-xxs" title="Print" type="button" aria-label="Print" data-bi-name="print" data-page-action-item="overflow-all" data-popover-close data-print-page data-check-hidden="true"> <span class="icon" aria-hidden="true"> <span class="docon docon-print font-size-sm color-primary"></span> </span> <span class="margin-left-xxs">Print</span> </button> </div> </details> </div> </div> </div> <div><button type="button" class="border contents-button button button-clear button-sm is-hidden-tablet has-inner-focus" data-bi-name="contents-expand" data-contents-button hidden> <span class="icon"> <span class="docon docon-editor-list-bullet" aria-hidden="true"></span> </span><span class="contents-expand-title">Table of contents</span></button> </div> <div class="content "> <h1 id="lucene-query-syntax-in-azure-ai-search">Lucene query syntax in Azure AI Search</h1> <div class="display-flex justify-content-space-between align-items-center flex-wrap-wrap page-metadata-container"> <div class="margin-right-xxs"> <ul class="metadata page-metadata" data-bi-name="page info" lang="en-us" dir="ltr"> <li>Article</li> <li class="visibility-hidden-visual-diff"><time class="is-invisible" data-article-date aria-label="Article review date" datetime="2024-09-19T08:00:00Z" data-article-date-source="calculated">09/19/2024</time></li> <li class="contributors-holder display-none-print"><button aria-label="View all contributors" class="contributors-button link-button" data-bi-name="contributors" title="View all contributors">11 contributors</button></li> </ul> </div> <div id="user-feedback" class="margin-block-xxs display-none-print" data-hide-on-archived><button id="user-feedback-button" data-test-id="conceptual-feedback-button" class="button button-sm button-clear button-primary" type="button" data-bi-name="user-feedback-button" data-user-feedback-button> <span class="icon" aria-hidden="true"> <span class="docon docon-like"></span> </span> <span>Feedback</span> </button> </div> </div> <nav id="center-doc-outline" class="doc-outline is-hidden-desktop display-none-print margin-bottom-sm" data-bi-name="intopic toc" aria-label="In this article"> <h2 id="ms--in-this-article" class="title is-6 margin-block-xs">In this article</h2> </nav> <p>When creating queries in Azure AI Search, you can opt for the full <a href="https://translate.google.com/website?sl=pl&tl=de&hl=en-GB&u=https://lucene.apache.org/core/6_6_1/queryparser/org/apache/lucene/queryparser/classic/package-summary.html" data-linktype="external">Lucene Query Parser</a> syntax for specialized query forms: wildcard, fuzzy search, proximity search, regular expressions. Much of the Lucene Query Parser syntax is <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/search-lucene-query-architecture?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="relative-path">implemented intact in Azure AI Search</a>, except for <em>range searches</em>, which are constructed through <strong><code>$filter</code></strong> expressions.</p> <p>To use full Lucene syntax, set the queryType to <code>full</code> and pass in a query expression patterned for wildcard, fuzzy search, or one of the other query forms supported by the full syntax. In REST, query expressions are provided in the <strong><code>search</code></strong> parameter of a <a href="https://learn-microsoft-com.translate.goog/en-us/rest/api/searchservice/documents/search-post?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="absolute-path">Search Documents (REST API)</a> request.</p> <h2 id="example-full-syntax">Example (full syntax)</h2> <p>The following example is a search request constructed using the full syntax. This particular example shows in-field search and term boosting. It looks for hotels where the category field contains the term <code>budget</code>. Any documents containing the phrase <code>"recently renovated"</code> are ranked higher as a result of the term boost value (3).</p> <pre><code class="lang-http">POST /indexes/hotels-sample-index/docs/search?api-version=2024-07-01 { "queryType": "full", "search": "category:budget AND \"recently renovated\"^3", "searchMode": "all" } </code></pre> <p>While not specific to any query type, the <strong><code>searchMode</code></strong> parameter is relevant in this example. Whenever operators are on the query, you should generally set <code>searchMode=all</code> to ensure that <em>all</em> of the criteria are matched.</p> <p>For more examples, see <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/search-query-lucene-examples?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="relative-path">Lucene query syntax examples</a>. For details about the query request and parameters, including searchMode, see <a href="https://learn-microsoft-com.translate.goog/en-us/rest/api/searchservice/documents/search-post?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="absolute-path">Search Documents (REST API)</a>.</p> <h2 id="bkmk_syntax">Syntax fundamentals</h2> <p>The following syntax fundamentals apply to all queries that use the Lucene syntax.</p> <h3 id="operator-evaluation-in-context">Operator evaluation in context</h3> <p>Placement determines whether a symbol is interpreted as an operator or just another character in a string.</p> <p>For example, in Lucene full syntax, the tilde (<code>~</code>) is used for both fuzzy search and proximity search. When placed after a quoted phrase, <code>~</code> invokes proximity search. When placed at the end of a term, <code>~</code> invokes fuzzy search.</p> <p>Within a term, such as <code>business~analyst</code>, the character isn't evaluated as an operator. In this case, assuming the query is a term or phrase query, <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/search-lucene-query-architecture?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="relative-path">full text search</a> with <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/search-lucene-query-architecture?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB#stage-2-lexical-analysis" data-linktype="relative-path">lexical analysis</a> strips out the <code>~</code> and breaks the term <code>business~analyst</code> in two: <code>business</code> OR <code>analyst</code>.</p> <p>The example above is the tilde (<code>~</code>), but the same principle applies to every operator.</p> <h3 id="escaping-special-characters">Escaping special characters</h3> <p>In order to use any of the search operators as part of the search text, escape the character by prefixing it with a single backslash (<code>\</code>). For example, for a wildcard search on <code>https://</code>, where <code>://</code> is part of the query string, you would specify <code>search=https\:\/\/*</code>. Similarly, an escaped phone number pattern might look like this <code>\+1 $800$ 642\-7676</code>.</p> <p>Special characters that require escaping include the following:<br><code>+ - & | ! ( ) { } [ ] ^ " ~ * ? : \ /</code></p> <div class="NOTE"> <p>Note</p> <p>Although escaping keeps tokens together, <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/search-lucene-query-architecture?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB#stage-2-lexical-analysis" data-linktype="relative-path">lexical analysis</a> during indexing may strip them out. For example, the standard Lucene analyzer will break words on hyphens, whitespace, and other characters. If you require special characters in the query string, you might need an analyzer that preserves them in the index. Some choices include Microsoft natural <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/index-add-language-analyzers?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="relative-path">language analyzers</a>, which preserves hyphenated words, or a custom analyzer for more complex patterns. For more information, see <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/search-query-partial-matching?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="relative-path">Partial terms, patterns, and special characters</a>.</p> </div> <h3 id="encoding-unsafe-and-reserved-characters-in-urls">Encoding unsafe and reserved characters in URLs</h3> <p>Ensure all unsafe and reserved characters are encoded in a URL. For example, <code>#</code> is an unsafe character because it's a fragment/anchor identifier in a URL. The character must be encoded to <code>%23</code> if used in a URL. <code>&</code> and <code>=</code> are examples of reserved characters as they delimit parameters and specify values in Azure AI Search. See <a href="https://translate.google.com/website?sl=pl&tl=de&hl=en-GB&u=https://www.ietf.org/rfc/rfc1738.txt" data-linktype="external">RFC1738: Uniform Resource Locators (URL)</a> for more details.</p> <p>Unsafe characters are <code>" ` < > # % { } | \ ^ ~ [ ]</code>. Reserved characters are <code>; / ? : @ = + &</code>.</p> <h2 id="bkmk_boolean">Boolean operators</h2> <p>You can embed Boolean operators in a query string to improve the precision of a match. The full syntax supports text operators in addition to character operators. Always specify text boolean operators (AND, OR, NOT) in all caps.</p> <table> <thead> <tr> <th>Text operator</th> <th>Character</th> <th>Example</th> <th>Usage</th> </tr> </thead> <tbody> <tr> <td>AND</td> <td><code>+</code></td> <td><code>wifi AND luxury</code></td> <td>Specifies terms that a match must contain. In the example, the query engine looks for documents containing both <code>wifi</code> and <code>luxury</code>. The plus character (<code>+</code>) can also be used directly in front of a term to make it required. For example, <code>+wifi +luxury</code> stipulates that both terms must appear somewhere in the field of a single document.</td> </tr> <tr> <td>OR</td> <td>(none) <sup>1</sup></td> <td><code>wifi OR luxury</code></td> <td>Finds a match when either term is found. In the example, the query engine returns match on documents containing either <code>wifi</code> or <code>luxury</code> or both. Because OR is the default conjunction operator, you could also leave it out, such that <code>wifi luxury</code> is the equivalent of <code>wifi OR luxury</code>.</td> </tr> <tr> <td>NOT</td> <td><code>!</code>, <code>-</code></td> <td><code>wifi –luxury</code></td> <td>Returns a match on documents that exclude the term. For example, <code>wifi –luxury</code> searches for documents that have the <code>wifi</code> term but not <code>luxury</code>.</td> </tr> </tbody> </table> <p><sup>1</sup> The <code>|</code> character isn't supported for OR operations.</p> <h3 id="bkmk_boolean_not">NOT Boolean operator</h3> <div class="IMPORTANT"> <p>Important</p> <p>The NOT operator (<code>NOT</code>, <code>!</code>, or <code>-</code>) behaves differently in full syntax than it does in simple syntax.</p> </div> <ul> <li>In simple syntax, queries with negation always have a wildcard automatically added. For example, the query <code>-luxury</code> is automatically expanded to <code>-luxury *</code>.</li> <li>In full syntax, queries with negation cannot be combined with a wildcard. For example, the queries <code>-luxury *</code> is not allowed.</li> <li>In full syntax, queries with a single negation are not allowed. For example, the query <code>-luxury</code> is not allowed.</li> <li>In full syntax, negations will behave as if they are always ANDed onto the query regardless of the search mode. <ul> <li>For example, the full syntax query <code>wifi -luxury</code> in full syntax only fetches documents that contain the term <code>wifi</code>, and then applies the negation <code>-luxury</code> to those documents.</li> </ul></li> <li>If you want to use negations to search over all documents in the index, simple syntax with the <code>any</code> search mode is recommended.</li> <li>If you want to use negations to search over a subset of documents in the index, full syntax or the simple syntax with the all search mode are recommended.</li> </ul> <table> <thead> <tr> <th>Query Type</th> <th>Search Mode</th> <th>Example Query</th> <th>Behavior</th> </tr> </thead> <tbody> <tr> <td>Simple</td> <td>any</td> <td><code>wifi -luxury</code></td> <td>Returns all documents in the index. Documents with the term "wifi" or documents missing the term "luxury" are ranked higher than other documents. The query is expanded to <code>wifi OR -luxury OR *</code>.</td> </tr> <tr> <td>Simple</td> <td>all</td> <td><code>wifi -luxury</code></td> <td>Returns only documents in the index that contain the term "wifi" and don't contain the term "luxury". The query is expanded to <code>wifi AND -luxury AND *</code>.</td> </tr> <tr> <td>Full</td> <td>any</td> <td><code>wifi -luxury</code></td> <td>Returns only documents in the index that contain the term "wifi", and then documents that contain the term "luxury" are removed from the results.</td> </tr> <tr> <td>Full</td> <td>all</td> <td><code>wifi -luxury</code></td> <td>Returns only documents in the index that contain the term "wifi", and then documents that contain the term "luxury" are removed from the results.</td> </tr> </tbody> </table> <h2 id="bkmk_fields">Fielded search</h2> <p>You can define a fielded search operation with the <code>fieldName:searchExpression</code> syntax, where the search expression can be a single word or a phrase, or a more complex expression in parentheses, optionally with Boolean operators. Some examples include the following:</p> <ul> <li><p><code>genre:jazz NOT history</code></p></li> <li><p><code>artists:("Miles Davis" "John Coltrane")</code></p></li> </ul> <p>Be sure to put multiple strings within quotation marks if you want both strings to be evaluated as a single entity, in this case searching for two distinct artists in the <code>artists</code> field.</p> <p>The field specified in <code>fieldName:searchExpression</code> must be a <code>searchable</code> field. See <a href="https://learn-microsoft-com.translate.goog/en-us/rest/api/searchservice/indexes/create?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="absolute-path">Create Index</a> for details on how index attributes are used in field definitions.</p> <div class="NOTE"> <p>Note</p> <p>When using fielded search expressions, you do not need to use the <code>searchFields</code> parameter because each fielded search expression has a field name explicitly specified. However, you can still use the <code>searchFields</code> parameter if you want to run a query where some parts are scoped to a specific field, and the rest could apply to several fields. For example, the query <code>search=genre:jazz NOT history&searchFields=description</code> would match <code>jazz</code> only to the <code>genre</code> field, while it would match <code>NOT history</code> with the <code>description</code> field. The field name provided in <code>fieldName:searchExpression</code> always takes precedence over the <code>searchFields</code> parameter, which is why in this example, we do not need to include <code>genre</code> in the <code>searchFields</code> parameter.</p> </div> <h2 id="bkmk_fuzzy">Fuzzy search</h2> <p>A fuzzy search finds matches in terms that have a similar construction, expanding a term up to the maximum of 50 terms that meet the distance criteria of two or less. For more information, see <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/search-query-fuzzy?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="relative-path">Fuzzy search</a>.</p> <p>To do a fuzzy search, use the tilde <code>~</code> symbol at the end of a single word with an optional parameter, a number between 0 and 2 (default), that specifies the edit distance. For example, <code>blue~</code> or <code>blue~1</code> would return <code>blue</code>, <code>blues</code>, and <code>glue</code>.</p> <p>Fuzzy search can only be applied to terms, not quotation-enclosed phrases, but you can append the tilde to each term individually in a multi-part name or phrase. For example, <code>Unviersty~ of~ Wshington~</code> would match on <code>University of Washington</code>.</p> <h2 id="bkmk_proximity">Proximity search</h2> <p>Proximity searches are used to find terms that are near each other in a document. Insert a tilde <code>~</code> symbol at the end of a phrase followed by the number of words that create the proximity boundary. For example, <code>"hotel airport"~5</code> finds the terms <code>hotel</code> and <code>airport</code> within five words of each other in a document.</p> <h2 id="bkmk_termboost">Term boosting</h2> <p>Term boosting refers to ranking a document higher if it contains the boosted term, relative to documents that don't contain the term. This differs from scoring profiles in that scoring profiles boost certain fields, rather than specific terms.</p> <p>The following example helps illustrate the differences. Suppose that there's a scoring profile that boosts matches in a certain field, say <em>genre</em> in the <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/index-add-scoring-profiles?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB#extended-example-for-keyword-search" data-linktype="relative-path">musicstoreindex example</a>. Term boosting could be used to further boost certain search terms higher than others. For example, <code>rock^2 electronic</code> boosts documents that contain the search terms in the genre field higher than other searchable fields in the index. Further, documents that contain the search term <em>rock</em> are ranked higher than the other search term <em>electronic</em> as a result of the term boost value (2).</p> <p>To boost a term, use the caret, <code>^</code>, symbol with a boost factor (a number) at the end of the term you're searching. You can also boost phrases. The higher the boost factor, the more relevant the term is relative to other search terms. By default, the boost factor is 1. Although the boost factor must be positive, it can be less than 1 (for example, 0.20).</p> <h2 id="bkmk_regex">Regular expression search</h2> <p>A regular expression search finds a match based on patterns that are valid under Apache Lucene, as documented in the <a href="https://translate.google.com/website?sl=pl&tl=de&hl=en-GB&u=https://lucene.apache.org/core/6_6_1/core/org/apache/lucene/util/automaton/RegExp.html" data-linktype="external">RegExp class</a>. In Azure AI Search, a regular expression is enclosed between forward slashes <code>/</code>.</p> <p>For example, to find documents containing <code>motel</code> or <code>hotel</code>, specify <code>/[mh]otel/</code>. Regular expression searches are matched against single words.</p> <p>Some tools and languages impose extra escape character requirements beyond the <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/query-lucene-syntax?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB#escaping-special-characters" data-linktype="self-bookmark">escape rules</a> imposed by Azure AI Search. For JSON, strings that include a forward slash are escaped with a backward slash: <code>microsoft.com/azure/</code> becomes <code>search=/.*microsoft.com\/azure\/.*/</code> where <code>search=/.* <string-placeholder>.*/</code> sets up the regular expression, and <code>microsoft.com\/azure\/</code> is the string with an escaped forward slash.</p> <p>Two common symbols in regex queries are <code>.</code> and <code>*</code>. A <code>.</code> matches any one character and a <code>*</code> matches the previous character zero or more times. For example, <code>/be./</code> matches the terms <code>bee</code> and <code>bet</code> while <code>/be*/</code> would match <code>be</code>, <code>bee</code>, and <code>beee</code> but not <code>bet</code>. Together, <code>.*</code> allow you to match any series of characters so <code>/be.*/</code> would match any term that starts with <code>be</code> such as <code>better</code>.</p> <p>If you get syntax errors in your regular expression, review the <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/query-lucene-syntax?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB#escaping-special-characters" data-linktype="self-bookmark">escape rules</a> for special characters. You might also try a different client to confirm whether the problem is tool-specific.</p> <h2 id="bkmk_wildcard">Wildcard search</h2> <p>You can use generally recognized syntax for multiple (<code>*</code>) or single (<code>?</code>) character wildcard searches. Full Lucene syntax supports prefix and infix matching. Use <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/query-lucene-syntax?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB#bkmk_regex" data-linktype="self-bookmark">regular expression</a> syntax for suffix matching.</p> <p>Note the Lucene query parser supports the use of these symbols with a single term, and not a phrase.</p> <table> <thead> <tr> <th>Affix type</th> <th>Description and examples</th> </tr> </thead> <tbody> <tr> <td>prefix</td> <td>Term fragment comes before <code>*</code> or <code>?</code>. For example, a query expression of <code>search=alpha*</code> returns <code>alphanumeric</code> or <code>alphabetical</code>. Prefix matching is supported in both simple and full syntax.</td> </tr> <tr> <td>suffix</td> <td>Term fragment comes after <code>*</code> or <code>?</code>, with a forward slash to delimit the construct. For example, <code>search=/.*numeric/</code> returns <code>alphanumeric</code>.</td> </tr> <tr> <td>infix</td> <td>Term fragments enclose <code>*</code> or <code>?</code>. For example, <code>search=non*al</code> returns <code>non-numerical</code> and <code>nonsensical</code>.</td> </tr> </tbody> </table> <p>You can combine operators in one expression. For example, <code>980?2*</code> matches on <code>98072-1222</code> and <code>98052-1234</code>, where <code>?</code> matches on a single (required) character, and <code>*</code> matches on characters of an arbitrary length that follow.</p> <p>Suffix matching requires the regular expression forward slash <code>/</code> delimiters. Generally, you can’t use a <code>*</code> or <code>?</code> symbol as the first character of a term, without the <code>/</code>. It's also important to note that the <code>*</code> behaves differently when used outside of regex queries. Outside of the regex forward slash <code>/</code> delimiter, the <code>*</code> is a wildcard character and matches any series of characters much like <code>.*</code> in regex. As an example, <code>search=/non.*al/</code> produces the same result set as <code>search=non*al</code>.</p> <div class="NOTE"> <p>Note</p> <p>As a rule, pattern matching is slow so you might want to explore alternative methods, such as edge n-gram tokenization that creates tokens for sequences of characters in a term. With n-gram tokenization, the index will be larger, but queries might execute faster, depending on the pattern construction and the length of strings you are indexing. For more information, see <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/search-query-partial-matching?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB#optimizing-prefix-and-suffix-queries" data-linktype="relative-path">Partial term search and patterns with special characters</a>.</p> </div> <h3 id="effect-of-an-analyzer-on-wildcard-queries">Effect of an analyzer on wildcard queries</h3> <p>During query parsing, queries that are formulated as prefix, suffix, wildcard, or regular expressions are passed as-is to the query tree, bypassing <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/search-lucene-query-architecture?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB#stage-2-lexical-analysis" data-linktype="relative-path">lexical analysis</a>. Matches will only be found if the index contains the strings in the format your query specifies. In most cases, you need an analyzer during indexing that preserves string integrity so that partial term and pattern matching succeeds. For more information, see <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/search-query-partial-matching?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="relative-path">Partial term search in Azure AI Search queries</a>.</p> <p>Consider a situation where you may want the search query <code>terminal*</code> to return results that contain terms such as <code>terminate</code>, <code>termination</code>, and <code>terminates</code>.</p> <p>If you were to use the en.lucene (English Lucene) analyzer, it would apply aggressive stemming of each term. For example, <code>terminate</code>, <code>termination</code>, <code>terminates</code> will all be tokenized down to the token <code>termi</code> in your index. On the other side, terms in queries using wildcards or fuzzy search aren't analyzed at all, so there would be no results that would match the <code>terminat*</code> query.</p> <p>On the other side, the Microsoft analyzers (in this case, the en.microsoft analyzer) are a bit more advanced and use lemmatization instead of stemming. This means that all generated tokens should be valid English words. For example, <code>terminate</code>, <code>terminates</code>, and <code>termination</code> will mostly stay whole in the index, and would be a preferable choice for scenarios that depend a lot on wildcards and fuzzy search.</p> <h2 id="scoring-wildcard-and-regex-queries">Scoring wildcard and regex queries</h2> <p>Azure AI Search uses frequency-based scoring (<a href="https://translate.google.com/website?sl=pl&tl=de&hl=en-GB&u=https://en.wikipedia.org/wiki/Okapi_BM25" data-linktype="external">BM25</a>) for text queries. However, for wildcard and regex queries where scope of terms can potentially be broad, the frequency factor is ignored to prevent the ranking from biasing towards matches from rarer terms. All matches are treated equally for wildcard and regex searches.</p> <h2 id="special-characters">Special characters</h2> <p>In some circumstances, you may want to search for a special character, like an '❤' emoji or the '€' sign. In such cases, make sure that the analyzer you use doesn't filter those characters out. The standard analyzer bypasses many special characters, excluding them from your index.</p> <p>Analyzers that tokenize special characters include the whitespace analyzer, which takes into consideration any character sequences separated by whitespaces as tokens (so the <code>❤</code> string would be considered a token). Also, a language analyzer like the Microsoft English analyzer ("en.microsoft"), would take the "€" string as a token. You can <a href="https://learn-microsoft-com.translate.goog/en-us/rest/api/searchservice/indexes/analyze?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="absolute-path">test an analyzer</a> to see what tokens it generates for a given query.</p> <p>When using Unicode characters, make sure symbols are properly escaped in the query url (for instance for <code>❤</code> would use the escape sequence <code>%E2%9D%A4+</code>). Some REST clients do this translation automatically.</p> <h2 id="precedence-grouping">Precedence (grouping)</h2> <p>You can use parentheses to create subqueries, including operators within the parenthetical statement. For example, <code>motel+(wifi|luxury)</code> searches for documents containing the <code>motel</code> term and either <code>wifi</code> or <code>luxury</code> (or both).</p> <p>Field grouping is similar but scopes the grouping to a single field. For example, <code>hotelAmenities:(gym+(wifi|pool))</code> searches the field <code>hotelAmenities</code> for <code>gym</code> and <code>wifi</code>, or <code>gym</code> and <code>pool</code>.</p> <h2 id="query-size-limits">Query size limits</h2> <p>Azure AI Search imposes limits on query size and composition because unbounded queries can destabilize your search service. There are limits on query size and composition (the number of clauses). Limits also exist for the length of prefix search and for the complexity of regex search and wildcard search. If your application generates search queries programmatically, we recommend designing it in such a way that it doesn't generate queries of unbounded size.</p> <p>For more information on query limits, see <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/search-limits-quotas-capacity?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB#api-request-limits" data-linktype="relative-path">API request limits</a>.</p> <h2 id="see-also">See also</h2> <ul> <li><a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/search-query-simple-examples?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="relative-path">Query examples for simple search</a></li> <li><a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/search-query-lucene-examples?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="relative-path">Query examples for full Lucene search</a></li> <li><a href="https://learn-microsoft-com.translate.goog/en-us/rest/api/searchservice/documents/search-post?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="absolute-path">Search Documents</a></li> <li><a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/query-odata-filter-orderby-syntax?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="relative-path">OData expression syntax for filters and sorting</a></li> <li><a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/query-simple-syntax?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="relative-path">Simple query syntax in Azure AI Search</a></li> </ul> </div> <div id="ms--inline-notifications" class="margin-block-xs" data-bi-name="inline-notification"></div> <div id="assertive-live-region" role="alert" aria-live="assertive" class="visually-hidden" aria-relevant="additions" aria-atomic="true"></div> <div id="polite-live-region" role="status" aria-live="polite" class="visually-hidden" aria-relevant="additions" aria-atomic="true"></div> </main>  <section id="site-user-feedback-footer" class="font-size-sm margin-top-md" data-test-id="site-user-feedback-footer" data-bi-name="site-feedback-section"> <hr class="hr"> <h2 id="feedback" class="title is-3">Feedback</h2> <div class="display-flex flex-wrap-wrap align-items-center"> <p class="font-weight-semibold margin-xxs margin-left-none">Was this page helpful?</p> <div class="buttons"><button class="thumb-rating-button like button button-primary button-sm" data-test-id="footer-rating-yes" data-binary-rating-response="rating-yes" type="button" title="This article is helpful" data-bi-name="button-rating-yes" aria-pressed="false"> <span class="icon" aria-hidden="true"> <span class="docon docon-like"></span> </span> <span>Yes</span> </button> <button class="thumb-rating-button dislike button button-primary button-sm" data-test-id="footer-rating-no" data-binary-rating-response="rating-no" type="button" title="This article is not helpful" data-bi-name="button-rating-no" aria-pressed="false"> <span class="icon" aria-hidden="true"> <span class="docon docon-dislike"></span> </span> <span>No</span> </button> </div> </div> <div class="display-flex flex-wrap-wrap margin-top-xxs"> <div><a data-bi-name="provide-feedback-cta" class="has-external-link-indicator" href="https://translate.google.com/website?sl=pl&tl=de&hl=en-GB&u=https://feedback.azure.com/d365community/forum/9325d19e-0225-ec11-b6e6-000d3a4f07b8"> <span>Provide product feedback</span> </a><span class="margin-inline-xxs" aria-hidden="true">|</span> </div><a href="https://learn-microsoft-com.translate.goog/en-us/answers/tags/109/azure-cognitive-search?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" class="has-external-link-indicator" data-bi-name="get-help-at-qna"> <span>Get help at Microsoft Q&A</span> </a> </div> </section>  <aside id="ms--additional-resources-mobile" aria-label="Additional resources" class="display-none-desktop display-none-print"> <hr class="hr" hidden> <h2 id="ms--additional-resources-mobile-heading" class="title is-3" hidden>Additional resources</h2> <section id="right-rail-recommendations-mobile" data-bi-name="recommendations" hidden></section> <section id="right-rail-training-mobile" data-bi-name="learning-resources-card" hidden></section> <section id="right-rail-events-mobile" data-bi-name="events-card" hidden></section> <section id="right-rail-qna-mobile" data-bi-name="qna-link-card" hidden></section> </aside> <div class="border-top is-visible-interactive has-default-focus margin-top-sm "> <footer id="footer-interactive" data-bi-name="footer" class="footer-layout"> <div class="display-flex gap-xs flex-wrap-wrap is-full-height padding-right-lg-desktop"> <a data-mscc-ic="false" class="locale-selector-link button button-sm button-clear flex-shrink-0" href="https://learn-microsoft-com.translate.goog/en-us/azure/search/query-lucene-syntax?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB#" data-bi-name="select-locale"> <span class="icon" aria-hidden="true"> <span class="docon docon-world"></span> </span> <span class="local-selector-link-text"></span></a> <div class="ccpa-privacy-link" data-ccpa-privacy-link hidden><a href="https://translate.google.com/website?sl=pl&tl=de&hl=en-GB&u=https://aka.ms/yourcaliforniaprivacychoices" class="button button-sm button-clear flex-shrink-0" data-mscc-ic="false" data-bi-name="your-privacy-choices"> <svg role="img" aria-label="California Consumer Privacy Act (CCPA) Opt-Out Icon" xmlns="http://www.w3.org/2000/svg" viewbox="0 0 30 14" xml:space="preserve" height="16" width="43" focusable="false"> <title>California Consumer Privacy Act (CCPA) Opt-Out Icon</title><path d="M7.4 12.8h6.8l3.1-11.6H7.4C4.2 1.2 1.6 3.8 1.6 7s2.6 5.8 5.8 5.8z" style="fill-rule:evenodd;clip-rule:evenodd;fill:#fff"></path> <path d="M22.6 0H7.4c-3.9 0-7 3.1-7 7s3.1 7 7 7h15.2c3.9 0 7-3.1 7-7s-3.2-7-7-7zm-21 7c0-3.2 2.6-5.8 5.8-5.8h9.9l-3.1 11.6H7.4c-3.2 0-5.8-2.6-5.8-5.8z" style="fill-rule:evenodd;clip-rule:evenodd;fill:#06f"></path> <path d="M24.6 4c.2.2.2.6 0 .8L22.5 7l2.2 2.2c.2.2.2.6 0 .8-.2.2-.6.2-.8 0l-2.2-2.2-2.2 2.2c-.2.2-.6.2-.8 0-.2-.2-.2-.6 0-.8L20.8 7l-2.2-2.2c-.2-.2-.2-.6 0-.8.2-.2.6-.2.8 0l2.2 2.2L23.8 4c.2-.2.6-.2.8 0z" style="fill:#fff"></path> <path d="M12.7 4.1c.2.2.3.6.1.8L8.6 9.8c-.1.1-.2.2-.3.2-.2.1-.5.1-.7-.1L5.4 7.7c-.2-.2-.2-.6 0-.8.2-.2.6-.2.8 0L8 8.6l3.8-4.5c.2-.2.6-.2.9 0z" style="fill:#06f"></path> </svg><span>Your Privacy Choices</span> </a> </div> <div class="flex-shrink-0"> <div class="dropdown has-caret-up"><button class="dropdown-trigger button button-clear button-sm has-inner-focus theme-dropdown-trigger" aria-controls="theme-menu-interactive" aria-expanded="false" title="Theme" data-bi-name="theme"> <span class="icon"> <span class="docon docon-sun" aria-hidden="true"></span> </span> <span>Theme</span> <span class="icon expanded-indicator" aria-hidden="true"> <span class="docon docon-chevron-down-light"></span> </span> </button> <div class="dropdown-menu" id="theme-menu-interactive" role="menu"> <ul class="theme-selector padding-xxs" role="none"> <li class="theme display-block" role="menuitem"><button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="light"> <span class="theme-light margin-right-xxs"> <span class="theme-selector-icon border display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewbox="0 0 22 14"><rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg></span> </span> <span>Light</span> </button></li> <li class="theme display-block" role="menuitem"><button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="dark"> <span class="theme-dark margin-right-xxs"> <span class="border theme-selector-icon display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewbox="0 0 22 14"><rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg></span> </span> <span>Dark</span> </button></li> <li class="theme display-block" role="menuitem"><button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="high-contrast"> <span class="theme-high-contrast margin-right-xxs"> <span class="border theme-selector-icon display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewbox="0 0 22 14"><rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg></span> </span> <span>High contrast</span> </button></li> </ul> </div> </div> </div> </div> <ul class="links" data-bi-name="footerlinks"> <li class="manage-cookies-holder" hidden></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="https://learn-microsoft-com.translate.goog/en-us/previous-versions/?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-bi-name="archivelink">Previous Versions</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="https://translate.google.com/website?sl=pl&tl=de&hl=en-GB&u=https://techcommunity.microsoft.com/t5/microsoft-learn-blog/bg-p/MicrosoftLearnBlog" data-bi-name="bloglink">Blog</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="https://learn-microsoft-com.translate.goog/en-us/contribute/?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-bi-name="contributorGuide">Contribute</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="https://translate.google.com/website?sl=pl&tl=de&hl=en-GB&u=https://go.microsoft.com/fwlink/?LinkId%3D521839" data-bi-name="privacy">Privacy</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="https://learn-microsoft-com.translate.goog/en-us/legal/termsofuse?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-bi-name="termsofuse">Terms of Use</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="https://translate.google.com/website?sl=pl&tl=de&hl=en-GB&u=https://www.microsoft.com/legal/intellectualproperty/Trademarks/" data-bi-name="trademarks">Trademarks</a></li> <li>© Microsoft 2024</li> </ul> </footer> </div> </div> <div id="ms--additional-resources" class="right-container column is-4-desktop display-none display-block-desktop" data-bi-name="pageactions" role="complementary" aria-label="Additional resources"> <div id="affixed-right-container" class="margin-top-sm-tablet" data-bi-name="right-column"> <h2 id="ms--additional-resources-heading" class="title is-6 margin-top-md" hidden>Additional resources</h2> <section id="right-rail-events" data-bi-name="events-card" hidden></section> <section id="right-rail-training" data-bi-name="learning-resources-card" hidden></section> <section id="right-rail-recommendations" data-bi-name="recommendations" hidden></section> <nav id="side-doc-outline" class="doc-outline" data-bi-name="intopic toc" aria-label="In this article"> <h3>In this article</h3> </nav> <section id="right-rail-qna" class="margin-top-xxs" data-bi-name="qna-link-card" hidden></section> </div> </div> </div> </section>  <aside id="interactive-container" class="interactive-container is-visible-interactive column has-body-background-dark "> </aside> </div> </div> <section class="border-top has-default-focus is-hidden-interactive margin-top-sm "> <footer id="footer" data-bi-name="footer" class="footer-layout uhf-container has-padding" role="contentinfo"> <div class="display-flex gap-xs flex-wrap-wrap is-full-height padding-right-lg-desktop"> <a data-mscc-ic="false" class="locale-selector-link button button-sm button-clear flex-shrink-0" href="https://learn-microsoft-com.translate.goog/en-us/azure/search/query-lucene-syntax?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB#" data-bi-name="select-locale"> <span class="icon" aria-hidden="true"> <span class="docon docon-world"></span> </span> <span class="local-selector-link-text"></span></a> <div class="ccpa-privacy-link" data-ccpa-privacy-link hidden><a href="https://translate.google.com/website?sl=pl&tl=de&hl=en-GB&u=https://aka.ms/yourcaliforniaprivacychoices" class="button button-sm button-clear flex-shrink-0" data-mscc-ic="false" data-bi-name="your-privacy-choices"> <svg role="img" aria-label="California Consumer Privacy Act (CCPA) Opt-Out Icon" xmlns="http://www.w3.org/2000/svg" viewbox="0 0 30 14" xml:space="preserve" height="16" width="43" focusable="false"> <title>California Consumer Privacy Act (CCPA) Opt-Out Icon</title><path d="M7.4 12.8h6.8l3.1-11.6H7.4C4.2 1.2 1.6 3.8 1.6 7s2.6 5.8 5.8 5.8z" style="fill-rule:evenodd;clip-rule:evenodd;fill:#fff"></path> <path d="M22.6 0H7.4c-3.9 0-7 3.1-7 7s3.1 7 7 7h15.2c3.9 0 7-3.1 7-7s-3.2-7-7-7zm-21 7c0-3.2 2.6-5.8 5.8-5.8h9.9l-3.1 11.6H7.4c-3.2 0-5.8-2.6-5.8-5.8z" style="fill-rule:evenodd;clip-rule:evenodd;fill:#06f"></path> <path d="M24.6 4c.2.2.2.6 0 .8L22.5 7l2.2 2.2c.2.2.2.6 0 .8-.2.2-.6.2-.8 0l-2.2-2.2-2.2 2.2c-.2.2-.6.2-.8 0-.2-.2-.2-.6 0-.8L20.8 7l-2.2-2.2c-.2-.2-.2-.6 0-.8.2-.2.6-.2.8 0l2.2 2.2L23.8 4c.2-.2.6-.2.8 0z" style="fill:#fff"></path> <path d="M12.7 4.1c.2.2.3.6.1.8L8.6 9.8c-.1.1-.2.2-.3.2-.2.1-.5.1-.7-.1L5.4 7.7c-.2-.2-.2-.6 0-.8.2-.2.6-.2.8 0L8 8.6l3.8-4.5c.2-.2.6-.2.9 0z" style="fill:#06f"></path> </svg><span>Your Privacy Choices</span> </a> </div> <div class="flex-shrink-0"> <div class="dropdown has-caret-up"><button class="dropdown-trigger button button-clear button-sm has-inner-focus theme-dropdown-trigger" aria-controls="theme-menu" aria-expanded="false" title="Theme" data-bi-name="theme"> <span class="icon"> <span class="docon docon-sun" aria-hidden="true"></span> </span> <span>Theme</span> <span class="icon expanded-indicator" aria-hidden="true"> <span class="docon docon-chevron-down-light"></span> </span> </button> <div class="dropdown-menu" id="theme-menu" role="menu"> <ul class="theme-selector padding-xxs" role="none"> <li class="theme display-block" role="menuitem"><button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="light"> <span class="theme-light margin-right-xxs"> <span class="theme-selector-icon border display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewbox="0 0 22 14"><rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg></span> </span> <span>Light</span> </button></li> <li class="theme display-block" role="menuitem"><button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="dark"> <span class="theme-dark margin-right-xxs"> <span class="border theme-selector-icon display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewbox="0 0 22 14"><rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg></span> </span> <span>Dark</span> </button></li> <li class="theme display-block" role="menuitem"><button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="high-contrast"> <span class="theme-high-contrast margin-right-xxs"> <span class="border theme-selector-icon display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewbox="0 0 22 14"><rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg></span> </span> <span>High contrast</span> </button></li> </ul> </div> </div> </div> </div> <ul class="links" data-bi-name="footerlinks"> <li class="manage-cookies-holder" hidden></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="https://learn-microsoft-com.translate.goog/en-us/previous-versions/?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-bi-name="archivelink">Previous Versions</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="https://translate.google.com/website?sl=pl&tl=de&hl=en-GB&u=https://techcommunity.microsoft.com/t5/microsoft-learn-blog/bg-p/MicrosoftLearnBlog" data-bi-name="bloglink">Blog</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="https://learn-microsoft-com.translate.goog/en-us/contribute/?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-bi-name="contributorGuide">Contribute</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="https://translate.google.com/website?sl=pl&tl=de&hl=en-GB&u=https://go.microsoft.com/fwlink/?LinkId%3D521839" data-bi-name="privacy">Privacy</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="https://learn-microsoft-com.translate.goog/en-us/legal/termsofuse?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-bi-name="termsofuse">Terms of Use</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="https://translate.google.com/website?sl=pl&tl=de&hl=en-GB&u=https://www.microsoft.com/legal/intellectualproperty/Trademarks/" data-bi-name="trademarks">Trademarks</a></li> <li>© Microsoft 2024</li> </ul> </footer> </section> <div id="action-panel" role="region" aria-label="Action Panel" class="action-panel has-default-focus" tabindex="-1"></div> <script>function gtElInit() {var lib = new google.translate.TranslateService();lib.translatePage('pl', 'de', function () {});}</script> <script src="https://translate.google.com/translate_a/element.js?cb=gtElInit&hl=en-GB&client=wt" type="text/javascript"></script> </body> </html>