Konfigurera sökning för Microsoft 365 Multi-GeoConfigure Search for Microsoft 365 Multi-Geo

I en geomiljö med flera platser har varje geoplats ett eget sökindex och ett sökcenter.In a multi-geo environment, each geo location has its own search index and Search Center. När en användare söker visas frågan i alla index och de returnerade resultaten sammanfogas.When a user searches, the query is fanned out to all the indexes, and the returned results are merged.

En användare på en geoplats kan till exempel söka efter innehåll som lagrats på en annan geoplats eller efter innehåll på en SharePoint-webbplats som är begränsat till en annan geoplats.For example, a user in one geo location can search for content stored in another geo location, or for content on a SharePoint site that's restricted to a different geo location. Om användaren har åtkomst till innehållet visas resultatet i sökningen.If the user has access to this content, search will show the result.

Vilka sökklienter fungerar i en geomiljö med flera sökklienter?Which search clients work in a multi-geo environment?

Dessa klienter kan returnera resultat från alla geoplatser:These clients can return results from all geo locations:

  • OneDrive för företagOneDrive for Business
  • DelveDelve
  • Startsidan för SharePointThe SharePoint home page
  • SökcenterThe Search Center
  • Anpassade sökprogram som använder SharePoint Search APICustom search applications that use the SharePoint Search API

OneDrive för företagOneDrive for Business

Så snart multi geomiljön har konfigurerats får användare som söker i OneDrive resultat från alla geoplatser.As soon as the multi-geo environment has been set up, users that search in OneDrive get results from all geo locations.

DelveDelve

Så snart multigeomiljön har ställts in får användare som söker i Delve resultat från alla geoplatser.As soon as the multi-geo environment has been set up, users that search in Delve get results from all geo locations.

Delve-feeden och profilkortet visar endast förhandsgranskningar av filer som lagras på den centrala platsen.The Delve feed and the profile card only show previews of files that are stored in the central location. För filer som lagras på satellitplatser visas ikonen för filtypen i stället.For files that are stored in satellite locations, the icon for the file type is shown instead.

Startsidan för SharePointThe SharePoint home page

Så snart multigeomiljön har ställts in kan användarna se nyheter, senaste och följda webbplatser från flera geografiska platser på startsidan för SharePoint.As soon as the multi-geo environment has been set up, users will see news, recent and followed sites from multiple geo locations on their SharePoint home page. Om de använder sökrutan på startsidan för SharePoint får de kopplade resultat från flera geoplatser.If they use the search box on the SharePoint home page, they'll get merged results from multiple geo locations.

SökcenterThe Search Center

Efter att multigeomiljön har ställts in fortsätter varje sökcenter bara att visa resultat från sin egen geoplats.After the multi-geo environment has been set up, each Search Center continues to only show results from their own geo location. Administratörer måste ändra inställningarna för varje sökcenter för att få resultat från alla geoplatser.Admins must change the settings of each Search Center to get results from all geo locations. Därefter får användare som söker i sökcentret resultat från alla geoplatser.Afterwards, users that search in the Search Center get results from all geo locations.

Anpassade sökprogramCustom search applications

Som vanligt interagerar anpassade sökprogram med sökindex genom att använda befintliga REST-API:er för SharePoint-sökning.As usual, custom search applications interact with the search indexes by using the existing SharePoint Search REST APIs. Om du vill få resultat från alla, eller vissa geoplatser, måste programmet anropa API:t och inkludera de nya parametrarna för multi-geofråga i begäran.To get results from all, or some geo locations, the application must call the API and include the new Multi-Geo query parameters in the request. Det här utlöser en fan av frågan på alla geoplatser.This triggers a fan out of the query to all geo locations.

Vad är så annorlunda med sökning i en geomiljö med flera platser?What's different about search in a multi-geo environment?

Vissa sökfunktioner som du kanske är van vid fungerar annorlunda i en geomiljö med flera platser.Some search features you might be familiar with, work differently in a multi-geo environment.

FunktionFeature Så här fungerar detHow it works LösningWorkaround
Framhävda resultatPromoted results Du kan skapa frågeregler med framhävda resultat på olika nivåer: för hela klientorganisationen, för en webbplatssamling eller för en webbplats.You can create query rules with promoted results at different levels: for the whole tenant, for a site collection, or for a site. Definiera framhävda resultat på innehavarnivå i en geomiljö så att sökresultatet framhävs till sökcentren på alla geoplatser.In a multi-geo environment, define promoted results at the tenant level to promote the results to the Search Centers in all geo locations. Om du bara vill lyfta fram resultat i Sökcenter som finns på den geografiska platsen för webbplatssamlingen eller webbplatsen definierar du framhävda resultat på webbplatssamlingen eller webbplatsnivån.If you only want to promote results in the Search Center that's in the geo location of the site collection or site, define the promoted results at the site collection or site level. Dessa resultat framhävs inte på andra geografiska platser.These results are not promoted in other geo locations. Om du inte behöver olika framhävda resultat per geoplats, till exempel olika regler för resor, rekommenderar vi att du definierar framhävda resultat på innehavarnivå.If you don't need different promoted results per geo location, for example different rules for traveling, we recommend defining promoted results at the tenant level.
Sök förfiningSearch refiners Sökningen returnerar förfiningar från alla geoplatser för en klientorganisation och aggregerar dem sedan.Search returns refiners from all the geo locations of a tenant and then aggregates them. Aggregeringen är en bästa ansträngning, vilket innebär att förfiningen kanske inte är 100 % korrekt.The aggregation is a best effort, meaning that the refiner counts might not be 100% accurate. För de flesta sökdrivna scenarier är den här precisionen tillräcklig.For most search-driven scenarios, this accuracy is sufficient. För sökdrivna program som är beroende av förfiningens fullständighet bör du köra frågor för varje geoplats oberoende av varandra.For search-driven applications that depend on refiner completeness, query each geo location independently.
Geosökning med flera har inte stöd för dynamisk bucketing för numeriska förfining.Multi-geo search doesn't support dynamic bucketing for numerical refiners. Använd parametern "Diskretize" för numeriska förfining.Use the "Discretize" parameter for numerical refiners.
Dokument-IDsDocument IDs Om du utvecklar ett sökdrivna program som är beroende av dokument-ID:t är dokument-ID:t i en geomiljö inte unika för flera geografiska platser, utan unika per geoplats.If you're developing a search-driven application that depends on document IDs, note that document IDs in a multi-geo environment aren't unique across geo locations, they are unique per geo location. Vi har lagt till en kolumn som identifierar geoplatsen.We've added a column that identifies the geo location. Använd den här kolumnen för att uppnå unikhet.Use this column to achieve uniqueness. Den här kolumnen heter "GeoLocationSource".This column is named "GeoLocationSource".
Antal resultatNumber of results Sökresultatsidan visar kombinerade resultat från geoplatserna, men det går inte att ha mer än 500 resultat.The search results page shows combined results from the geo locations, but it's not possible to page beyond 500 results.
HybridsökningHybrid search I en SharePoint-hybridmiljö med molnhybridsökning läggs lokalt innehåll till i Microsoft 365-indexet för den centrala platsen. In a hybrid SharePoint environment with cloud hybrid search, on-premises content is added to the Microsoft 365 index of the central location.

Vad stöds inte för sökning i en miljö med flera geoer?What's not supported for search in a multi-geo environment?

Vissa av de sökfunktioner du kanske är van vid stöds inte i en miljö med flera geofunktioner.Some of the search features you might be familiar with, aren't supported in a multi-geo environment.

SökfunktionSearch feature Obs!Note
Endast appautentiseringApp-only authentication Endast programautentisering (privilegierad åtkomst från tjänster) stöds inte vid geosökning med flera program.App-only authentication (privileged access from services) isn't supported in multi-geo search.
GästanvändareGuest users Gästanvändare får bara resultat från den geoplats de söker från.Guest users only get results from the geo location that they're searching from.

Hur fungerar sökning i en geomiljö med flera sökverktyg?How does search work in a multi-geo environment?

Alla sökklienter använder befintliga REST API:er för SharePoint-sökning för att interagera med sökindexen.All the search clients use the existing SharePoint Search REST APIs to interact with the search indexes.

Diagram som visar hur REST-API:er för SharePoint-sökning interagerar med sökindex

  1. En sökklient anropar SÖK REST-slutpunkten med frågeegenskapen EnableMultiGeoSearch= true.A search client calls the Search REST endpoint with the query property EnableMultiGeoSearch= true.
  2. Frågan skickas till alla geoplatser i klientorganisationen.The query is sent to all geo locations in the tenant.
  3. Sökresultat från varje geoplats sammanfogas och rangordnas.Search results from each geo location are merged and ranked.
  4. Klienten får enhetliga sökresultat.The client gets unified search results.

Observera att vi inte slår samman sökresultaten förrän vi har fått resultat från alla geoplatser.Notice that we don't merge the search results until we've received results from all the geo locations. Det innebär att flera geosökningar har ytterligare fördröjning jämfört med sökningar i en miljö med bara en geoplats.This means that multi-geo searches have additional latency compared to searches in an environment with only one geo location.

Hämta ett sökcenter för att visa resultat från alla geografiska platserGet a Search Center to show results from all geo locations

Varje sökcenter har flera lodräta och du måste konfigurera varje lodrätt individuellt.Each Search Center has several verticals and you have to set up each vertical individually.

  1. Se till att du utför de här stegen med ett konto som har behörighet att redigera sökresultatsidan och webbdelen Sökresultat.Ensure that you perform these steps with an account that has permission to edit the search results page and the Search Result Web Part.

  2. Gå till sidan med sökresultat (se listan över sökresultatsidor)Navigate to the search results page (see the list of search results pages)

  3. Välj den lodräta för att konfigurera, klicka på kugghjulsikonen för inställningar i det övre högra hörnet och klicka sedan på Redigera sida. Select the vertical to set up, click Settings gear icon in the upper, right corner, and then click Edit Page. Sidan med sökresultat öppnas i redigeringsläge.The search results page opens in Edit mode.

    Redigera sidval i Inställningar

  4. I webbdelen Sökresultat flyttar du pekaren till det övre högra hörnet av webbdelen, klickar på pilen och klickar sedan på Redigera webbdel på menyn.In the Search Results Web Part, move the pointer to the upper, right corner of the web part, click the arrow, and then click Edit Web Part on the menu. Verktygsfönstret för webbdelen Sökresultat öppnas under menyfliksområdet längst upp till höger på sidan.The Search Results Web Part tool pane opens under the ribbon in the top right of the page.

    Redigera webbdelsval

  5. I webbdelsverktygsfönstret, i avsnittet Inställningar, under Inställningar för resultatkontroll väljer du Visa multi-georesultat för att få webbdelen Sökresultat för att visa resultat från alla geografiska platser.In the Web Part tool pane, in the Settings section, under Results control settings, select Show Multi-Geo results to get the Search Results Web Part to show results from all geo locations.

  6. Klicka på OK för att spara ändringen och stänga verktygsfönstret Webbdel.Click OK to save your change and close the Web Part tool pane.

  7. Kontrollera ändringarna i webbdelen Sökresultat genom att klicka på Checka in på fliken Sida i huvudmenyn.Check your changes to the Search Results Web Part by clicking Check-In on the Page tab of the main menu.

  8. Publicera ändringarna med hjälp av länken som finns i anteckningen högst upp på sidan.Publish the changes by using the link provided in the note at the top of the page.

Hämta anpassade sökprogram för att visa resultat från alla eller vissa geografiska platserGet custom search applications to show results from all or some geo locations

Anpassade sökprogram får resultat från alla, eller vissa, geoplatser genom att ange frågeparametrar med begäran till REST API för SharePoint-sökning.Custom search applications get results from all, or some, geo locations by specifying query parameters with the request to the SharePoint Search REST API. Beroende på frågeparametrarna är frågan borta från alla geoplatser eller till vissa geografiska platser.Depending on the query parameters, the query is fanned out to all geo locations, or to some geo locations. Om du till exempel bara behöver söka efter relevant information på en delmängd av geoplatserna kan du hålla koll på endast dessa.For example, if you only need to query a subset of geo locations to find relevant information, you can control the fan out to only these. Om begäran lyckas returnerar SharePoint Search REST API svarsdata.If the request succeeds, the SharePoint Search REST API returns response data.

KravRequirement

För varje geoplats måste du säkerställa att alla användare i organisationen har beviljats läsbehörighetsnivå för rotwebbplatsen (till exempel contoso APAC.sharepoint.com/ och contoso EU.sharepoint.com/).For each geo location, you must ensure that all users in the organization have been granted the Read permission level for the root website (for example contoso APAC.sharepoint.com/ and contoso EU.sharepoint.com/). Läs mer om behörigheter.Learn about permissions.

FrågeparametrarQuery parameters

EnableMultiGeoSearch – Det här är ett booleskt värde som anger om frågan ska rensas mot index för andra geoplatser för den geoklientorganisationen.EnableMultiGeoSearch - This is a Boolean value that specifies whether the query shall be fanned out to the indexes of other geo locations of the multi-geo tenant. Sätt det på sant för att skapa en bra fråga; false to not fan out the query.Set it to true to fan out the query; false to not fan out the query. Om du inte tar med den här parametern är standardvärdet falskt , förutom när du ringer ett REST API-anrop mot en webbplats som använder sökcentermallen för företag, är standardvärdet sant.If you don't include this parameter, the default value is false, except when making a REST API call against a site which uses the Enterprise Search Center template, in this case the default value is true. Om du använder parametern i en miljö som inte innehåller flera geovärden ignoreras parametern.If you use the parameter in an environment that isn't multi-geo, the parameter is ignored.

ClientType – det här är en sträng.ClientType - This is a string. Ange ett unikt klientnamn för varje sökprogram.Enter a unique client name for each search application. Om du inte tar med den här parametern är frågan inte borta från andra geoplatser.If you don't include this parameter, the query is not fanned out to other geo locations.

MultiGeoSearchConfiguration – Det här är en valfri lista över vilka geoplatser i multi-geoklientorganisationen som du kan ta frågan till när EnableMultiGeoSearch är sant.MultiGeoSearchConfiguration - This is an optional list of which geo locations in the multi-geo tenant to fan the query out to when EnableMultiGeoSearch is true. Om du inte tar med den här parametern eller lämnar den tom kommer frågan att visas för alla geoplatser.If you don't include this parameter, or leave it blank, the query is fanned out to all geo locations. För varje geoplats anger du följande objekt i JSON-format:For each geo location, enter the following items, in JSON format:

ObjektItem BeskrivningDescription
DataLocationDataLocation Geoplatsen, till exempel NAM.The geo location, for example NAM.
EndPointEndPoint Slutpunkten som du vill ansluta till, till exempel https://contoso.sharepoint.comThe endpoint to connect to, for example https://contoso.sharepoint.com
SourceIdSourceId GUID för resultatkällan, till exempel B81EAB55-3140-4312-B0F4-9459D1B4FFEE.The GUID of the result source, for example B81EAB55-3140-4312-B0F4-9459D1B4FFEE.

Om du utelämnar DataLocation eller EndPoint, eller om en DataLocation dupliceras, misslyckas begäran.If you omit DataLocation or EndPoint, or if a DataLocation is duplicated, the request fails. Du kan få information om slutpunkten för en klientorganisations geografiska platser med hjälp av Microsoft Graph.You can get information about the endpoint of a tenant's geo locations by using Microsoft Graph.

SvarsdataResponse data

MultiGeoSearchStatus – Det här är en egenskap som SharePoint Search API returnerar som svar på en begäran.MultiGeoSearchStatus – This is a property that the SharePoint Search API returns in response to a request. Värdet för egenskapen är en sträng och ger följande information om de resultat som Sök-API:t för SharePoint returnerar:The value of the property is a string and gives the following information about the results that the SharePoint Search API returns:

ValueValue BeskrivningDescription
FullständigFull Fullständiga resultat från alla geoplatser.Full results from all the geo locations.
DelvisPartial Ofullständiga resultat från en eller flera geografiska platser.Partial results from one or more geo locations. Resultatet är ofullständigt på grund av ett tillfälligt fel.The results are incomplete due to a transient error.

Fråga med REST-tjänstenQuery using the REST service

Med en HÄMTA-begäran anger du frågeparametrar i URL-adressen.With a GET request, you specify the query parameters in the URL. Med en POST-begäran skickar du frågeparametrarna i brödtexten i JavaScript Object Notation-formatet (JSON).With a POST request, you pass the query parameters in the body in JavaScript Object Notation (JSON) format.

Begäran om rubrikerRequest headers

NamnName VärdeValue
InnehållstypContent-Type application/json;odata=verboseapplication/json;odata=verbose

Exempel på HÄMTA-begäran som är bortskad från alla geografiska platserSample GET request that's fanned out to all geo locations

https:// <tenant> / _ api/search/query?querytext='sharepoint'&Properties='EnableMultiGeoSearch:true'&ClientType='my _ client _ id'https:// <tenant>/_api/search/query?querytext='sharepoint'&Properties='EnableMultiGeoSearch:true'&ClientType='my_client_id'

Exempel på HÄMTA begäran att ta del av en del geografiska platserSample GET request to fan out to some geo locations

https:// <tenant> / _ api/search/query?querytext='site'&ClientType='my_client_id'&Properties='EnableMultiGeoSearch:true, MultiGeoSearchConfiguration:[{DataLocation \ :"NAM" \ ,Endpoint \ :"https \ ://contosoNAM.sharepoint.com" \ ,SourceId \ :"B81EAB55-3140-4312-B0F4-9459D1B4FFEE"} \ ,{DataLocation \ :"CAN" \ ,Endpoint \ :"https \ ://contosoCAN.sharepoint-df.com"}]'https:// <tenant>/_api/search/query?querytext='site'&ClientType='my_client_id'&Properties='EnableMultiGeoSearch:true, MultiGeoSearchConfiguration:[{DataLocation\:"NAM"\,Endpoint\:"https\://contosoNAM.sharepoint.com"\,SourceId\:"B81EAB55-3140-4312-B0F4-9459D1B4FFEE"}\,{DataLocation\:"CAN"\,Endpoint\:"https\://contosoCAN.sharepoint-df.com"}]'

Anteckning

Kommatecken och kolon i listan över geografiska platser för egenskapen MultiGeoSearchConfiguration föregås av omstöpen snedstreck.Commas and colons in the list of geo locations for the MultiGeoSearchConfiguration property are preceded by the backslash character. Det beror på att HÄMTA-begäranden använder kolon för att separera egenskaper och kommatecken för att separera egenskapsargument.This is because GET requests use colons to separate properties and commas to separate arguments of properties. Utan om baksnedstrecket som ett escape-tecken tolkas egenskapen MultiGeoSearchConfiguration felaktigt.Without the backslash as an escape character, the MultiGeoSearchConfiguration property is interpreted wrongly.

Exempel på EFTER-begäran som är bortskad från alla geografiska platserSample POST request that's fanned out to all geo locations

    {
    "request": {
            "__metadata": {
            "type": "Microsoft.Office.Server.Search.REST.SearchRequest"
        },
        "Querytext": "sharepoint",
        "Properties": {
            "results": [
                {
                    "Name": "EnableMultiGeoSearch",
                    "Value": {
                        "QueryPropertyValueTypeIndex": 3,
                        "BoolVal": true
                    }
                }
            ]
        },
        "ClientType": "my_client_id"
        }
    }

Exempel på INLÄGG-begäran som är bortskad från vissa geografiska platserSample POST request that's fanned out to some geo locations

    {
        "request": {
            "Querytext": "SharePoint",
            "ClientType": "my_client_id",
            "Properties": {
                "results": [
                    {
                        "Name": "EnableMultiGeoSearch",
                        "Value": {
                            "QueryPropertyValueTypeIndex": 3,
                            "BoolVal": true
                        }
                    },
                    {
                        "Name": "MultiGeoSearchConfiguration",
                        "Value": {
                        "StrVal": "[{\"DataLocation\":\"NAM\",\"Endpoint\":\"https://contoso.sharepoint.com\",\"SourceId\":\"B81EAB55-3140-4312-B0F4-9459D1B4FFEE\"},{\"DataLocation\":\"CAN\",\"Endpoint\":\"https://contosoCAN.sharepoint.com\"}]",
                            "QueryPropertyValueTypeIndex": 1
                        }
                    }
                ]
            }
        }
    }

Fråga med CSOMQuery using CSOM

Här är ett exempel på en CSOM-fråga som är borta från alla geoplatser:Here's a sample CSOM query that's fanned out to all geo locations:

var keywordQuery = new KeywordQuery(ctx);
keywordQuery.QueryText = query.SearchQueryText;
keywordQuery.ClientType = <enter a string here>;
keywordQuery["EnableMultiGeoSearch"] = true;