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-simple-syntax"> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <meta property="og:title" content="Simple 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-simple-syntax"> <meta property="og:description" content="Reference for the simple query syntax used for full text search queries in Azure AI Search."> <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 simple query syntax used for full text search queries in Azure AI Search."> <meta name="document_id" content="e1c2c641-bd55-a7aa-b747-bfb75671a7cc"> <meta name="document_version_independent_id" content="616f0123-6306-f0b3-806b-30c1fbfe702a"> <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-simple-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="01/17/2024"> <meta name="ms.service" content="azure-ai-search"> <meta name="ms.suite" content="office"> <meta name="ms.topic" content="conceptual"> <meta name="original_content_git_url" content="https://github.com/MicrosoftDocs/azure-ai-docs-pr/blob/live/articles/search/query-simple-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="1892"> <meta name="persistent_id" content="14f08d52-6433-930e-42e2-701e6aa56cd2"> <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-simple-syntax.md"> <link href="https://learn.microsoft.com/en-us/azure/search/query-simple-syntax" rel="canonical"> <title>Simple 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: "84961", url: "https://github.com/84961" },{ name: "rhdo180brno", url: "https://github.com/rhdo180brno" },{ name: "dereklegenzoff", url: "https://github.com/dereklegenzoff" },{ name: "DCtheGeek", url: "https://github.com/DCtheGeek" },{ name: "brjohnstmsft", url: "https://github.com/brjohnstmsft" },{ name: "john-par", url: "https://github.com/john-par" }],}, 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-simple-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-simple-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-simple-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-simple-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-simple-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-simple-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-simple-syntax.md" data-original_content_git_url="https://github.com/MicrosoftDocs/azure-ai-docs-pr/blob/live/articles/search/query-simple-syntax.md" data-original_content_git_url_template="{repo}/blob/{branch}/articles/search/query-simple-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-simple-syntax.md" data-original_content_git_url="https://github.com/MicrosoftDocs/azure-ai-docs-pr/blob/live/articles/search/query-simple-syntax.md" data-original_content_git_url_template="{repo}/blob/{branch}/articles/search/query-simple-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="simple-query-syntax-in-azure-ai-search">Simple 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-08-28T16:59:00Z" data-article-date-source="calculated">08/28/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">8 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>For full text search scenarios, Azure AI Search implements two Lucene-based query languages, each one aligned to a query parser. The <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/simple/SimpleQueryParser.html" data-linktype="external">Simple Query Parser</a> is the default. It covers common use cases and attempts to interpret a request even if it's not perfectly composed. The other parser is <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> and it supports more advanced query constructions.</p> <p>This article is the query syntax reference for the simple query parser.</p> <p>Query syntax for both parsers applies to query expressions passed in the <code>search</code> parameter of a <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/search-query-create?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="relative-path">query request</a>, not to be confused with the <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 syntax</a>, with its own syntax and rules for <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/search-filters?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="relative-path"><code>filter</code></a> and <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/search-query-odata-orderby?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="relative-path"><code>orderby</code></a> expressions in the same request.</p> <p>Although the simple parser is based on the <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/simple/SimpleQueryParser.html" data-linktype="external">Apache Lucene Simple Query Parser</a> class, its implementation in Azure AI Search excludes fuzzy search. If you need <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>, consider the alternative <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" data-linktype="relative-path">full Lucene query syntax</a> instead.</p> <h2 id="example-simple-syntax">Example (simple syntax)</h2> <p>This example shows a simple query, distinguished by <code>"queryType": "simple"</code> and valid syntax. Although query type is set below, it's the default and can be omitted unless you're reverting from an alternative type. The following example is a search over independent terms, with a requirement that all matching documents include "pool".</p> <pre><code class="lang-http">POST https://{{service-name}}.search.windows.net/indexes/hotel-rooms-sample/docs/search?api-version=2024-07-01 { "queryType": "simple", "search": "budget hotel +pool", "searchMode": "all" } </code></pre> <p>The <code>searchMode</code> parameter is relevant in this example. Whenever boolean operators are on the query, you should generally set <code>searchMode=all</code> to ensure that <em>all</em> of the criteria are matched. Otherwise, you can use the default <code>searchMode=any</code> that favors recall over precision.</p> <p>For more examples, see <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">Simple query syntax examples</a>. For details about the query request and parameters, 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="keyword-search-on-terms-and-phrases">Keyword search on terms and phrases</h2> <p>Strings passed to the <code>search</code> parameter can include terms or phrases in any supported language, boolean operators, precedence operators, wildcard or prefix characters for "starts with" queries, escape characters, and URL encoding characters. The <code>search</code> parameter is optional. Unspecified, search (<code>search=*</code> or <code>search=" "</code>) returns the top 50 documents in arbitrary (unranked) order.</p> <ul> <li><p>A <em>term search</em> is a query of one or more terms, where any of the terms are considered a match.</p></li> <li><p>A <em>phrase search</em> is an exact phrase enclosed in quotation marks <code>" "</code>. For example, while <code>Roach Motel</code> (without quotes) would search for documents containing <code>Roach</code> and/or <code>Motel</code> anywhere in any order, <code>"Roach Motel"</code> (with quotes) will only match documents that contain that whole phrase together and in that order (lexical analysis still applies).</p></li> </ul> <p>Depending on your search client, you might need to escape the quotation marks in a phrase search. For example, in a POST request, a phrase search on <code>"Roach Motel"</code> in the request body might be specified as <code>"\"Roach Motel\""</code>. If you're using the Azure SDKs, the search client escapes the quotation marks when it serializes the search text. Your search phrase can be sent be as "Roach Motel".</p> <p>By default, all strings passed in the <code>search</code> parameter undergo lexical analysis. Make sure you understand the tokenization behavior of the analyzer you're using. Often, when query results are unexpected, the reason can be traced to how terms are tokenized at query time. 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 tokenization on specific strings</a> to confirm the output.</p> <p>Any text input with one or more terms is considered a valid starting point for query execution. Azure AI Search will match documents containing any or all of the terms, including any variations found during analysis of the text.</p> <p>As straightforward as this sounds, there's one aspect of query execution in Azure AI Search that <em>might</em> produce unexpected results, increasing rather than decreasing search results as more terms and operators are added to the input string. Whether this expansion actually occurs depends on the inclusion of a NOT operator, combined with a <code>searchMode</code> parameter setting that determines how NOT is interpreted in terms of <code>AND</code> or <code>OR</code> behaviors. For more information, see the <code>NOT</code> operator under <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#boolean-operators" data-linktype="self-bookmark">Boolean operators</a>.</p> <h2 id="boolean-operators">Boolean operators</h2> <p>You can embed Boolean operators in a query string to improve the precision of a match. In the simple syntax, boolean operators are character-based. Text operators, such as the word AND, aren't supported.</p> <table> <thead> <tr> <th>Character</th> <th>Example</th> <th>Usage</th> </tr> </thead> <tbody> <tr> <td><code>+</code></td> <td><code>pool + ocean</code></td> <td>An <code>AND</code> operation. For example, <code>pool + ocean</code> stipulates that a document must contain both terms.</td> </tr> <tr> <td><code>|</code></td> <td><code>pool | ocean</code></td> <td>An <code>OR</code> operation finds a match when either term is found. In the example, the query engine will return a match on documents containing either <code>pool</code> or <code>ocean</code> or both. Because <code>OR</code> is the default conjunction operator, you could also leave it out, such that <code>pool ocean</code> is the equivalent of <code>pool | ocean</code>.</td> </tr> <tr> <td><code>-</code></td> <td><code>pool – ocean</code></td> <td>A <code>NOT</code> operation returns matches on documents that exclude the term. <p></p><p></p>The <code>searchMode</code> parameter on a query request controls whether a term with the <code>NOT</code> operator is <code>AND</code>ed or <code>OR</code>ed with other terms in the query (assuming there's no boolean operators on the other terms). Valid values include <code>any</code> or <code>all</code>. <p></p><code>searchMode=any</code> increases the recall of queries by including more results, and by default <code>-</code> will be interpreted as "OR NOT". For example, <code>pool - ocean</code> will match documents that either contain the term <code>pool</code> or those that don't contain the term <code>ocean</code>. <p></p><code>searchMode=all</code> increases the precision of queries by including fewer results, and by default <code>-</code> will be interpreted as "AND NOT". For example, with <code>searchMode=any</code>, the query <code>pool - ocean</code> will match documents that contain the term "pool" and all documents that don't contain the term "ocean". This is arguably a more intuitive behavior for the <code>-</code> operator. Therefore, you should consider using <code>searchMode=all</code> instead of <code>searchMode=any</code> if you want to optimize searches for precision instead of recall, <em>and</em> Your users frequently use the <code>-</code> operator in searches.<p></p> When deciding on a <code>searchMode</code> setting, consider the user interaction patterns for queries in various applications. Users who are searching for information are more likely to include an operator in a query, as opposed to e-commerce sites that have more built-in navigation structures.</td> </tr> </tbody> </table> <p><a name="prefix-search"></a></p> <h2 id="prefix-queries">Prefix queries</h2> <p>For "starts with" queries, add a suffix operator (<code>*</code>) as the placeholder for the remainder of a term. A prefix query must begin with at least one alphanumeric character before you can add the suffix operator.</p> <table> <thead> <tr> <th>Character</th> <th>Example</th> <th>Usage</th> </tr> </thead> <tbody> <tr> <td><code>*</code></td> <td><code>lingui*</code> will match on "linguistic" or "linguini"</td> <td>The asterisk (<code>*</code>) represents one or more characters of arbitrary length, ignoring case.</td> </tr> </tbody> </table> <p>Similar to filters, a prefix query looks for an exact match. As such, there's no relevance scoring (all results receive a search score of 1.0). Be aware that prefix queries can be slow, especially if the index is large and the prefix consists of a small number of characters. An alternative methodology, such as edge n-gram tokenization, might perform faster. Terms using prefix search can't be longer than 1000 characters.</p> <p>Simple syntax supports prefix matching only. For suffix or infix matching against the end or middle of a term, use 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#bkmk_wildcard" data-linktype="relative-path">full Lucene syntax for wildcard search</a>.</p> <h2 id="escaping-search-operators">Escaping search operators</h2> <p>In the simple syntax, search operators include these characters: <code>+ | " ( ) ' \</code></p> <p>If any of these characters are part of a token in the index, escape it by prefixing it with a single backslash (<code>\</code>) in the query. For example, suppose you used a custom analyzer for whole term tokenization, and your index contains the string "Luxury+Hotel". To get an exact match on this token, insert an escape character: <code>search=luxury\+hotel</code>.</p> <p>To make things simple for the more typical cases, there are two exceptions to this rule where escaping isn't needed:</p> <ul> <li><p>The NOT operator <code>-</code> only needs to be escaped if it's the first character after a whitespace. If the <code>-</code> appears in the middle (for example, in <code>3352CDD0-EF30-4A2E-A512-3B30AF40F3FD</code>), you can skip escaping.</p></li> <li><p>The suffix operator <code>*</code> only needs to be escaped if it's the last character before a whitespace. If the <code>*</code> appears in the middle (for example, in <code>4*4=16</code>), no escaping is needed.</p></li> </ul> <div class="NOTE"> <p>Note</p> <p>By default, the standard analyzer will delete and break words on hyphens, whitespace, ampersands, and other characters during <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>. If you require special characters to remain 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> <h2 id="encoding-unsafe-and-reserved-characters-in-urls">Encoding unsafe and reserved characters in URLs</h2> <p>Ensure all unsafe and reserved characters are encoded in a URL. For example, '#' 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. '&' and '=' are examples of reserved characters as they delimit parameters and specify values in Azure AI Search. For more information, 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>.</p> <p>Unsafe characters are <code>" ` < > # % { } | \ ^ ~ [ ]</code>. Reserved characters are <code>; / ? : @ = + &</code>.</p> <h2 id="special-characters">Special characters</h2> <p>Special characters can range from currency symbols like '$' or '€', to emojis. Many analyzers, including the default standard analyzer, will exclude special characters during indexing, which means they won't be represented in your index.</p> <p>If you need special character representation, you can assign an analyzer that preserves them:</p> <ul> <li><p>The whitespace analyzer considers any character sequence separated by white spaces as tokens (so the '❤' emoji would be considered a token).</p></li> <li><p>A <a href="https://learn-microsoft-com.translate.goog/en-us/azure/search/search-language-support?_x_tr_sl=pl&_x_tr_tl=de&_x_tr_hl=en-GB" data-linktype="relative-path">language analyzer</a>, such as the Microsoft English analyzer (<code>en.microsoft</code>), would take the '$' or '€' string as a token.</p></li> </ul> <p>For confirmation, 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 are generated for a given string. As you might expect, you might not get full tokenization from a single analyzer. A workaround is to create multiple fields that contain the same content, but with different analyzer assignments (for example, <code>description_en</code>, <code>description_fr</code>, and so forth for language analyzers).</p> <p>When using Unicode characters, make sure symbols are properly escaped in the query url (for instance for '❤' would use the escape sequence <code>%E2%9D%A4+</code>). Some web 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> will search for documents containing the "motel" term and either "wifi" or "luxury" (or both).</p> <h2 id="query-size-limits">Query size limits</h2> <p>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> <ul> <li><p>For GET, the length of the URL can't exceed 8 KB.</p></li> <li><p>For POST (and any other request), where the body of the request includes <code>search</code> and other parameters such as <code>filter</code> and <code>orderby</code>, the maximum size is 16 MB. Additional limits include:</p> <ul> <li>The maximum length of the search clause is 100,000 characters.</li> <li>The maximum number of clauses in <code>search</code> (expressions separated by AND or OR) is 1024.</li> <li>The maximum search term size is 1000 characters for <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#prefix-queries" data-linktype="self-bookmark">prefix search</a>.</li> <li>There's also a limit of approximately 32 KB on the size of any individual term in a query.</li> </ul></li> </ul> <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="next-steps">Next steps</h2> <p>If you'll be constructing queries programmatically, review <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 in Azure AI Search</a> to understand the stages of query processing and the implications of text analysis.</p> <p>You can also review the following articles to learn more about query construction:</p> <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 REST API</a></li> <li><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" data-linktype="relative-path">Lucene query syntax</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">Filter and Select (OData) expression syntax</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-simple-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-simple-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>