Zoeken naar Microsoft 365 multi-geo configurerenConfigure Search for Microsoft 365 Multi-Geo

In een multi-geoomgeving heeft elke geografische locatie een eigen zoekindex en zoekcentrum.In a multi-geo environment, each geo location has its own search index and Search Center. Wanneer een gebruiker zoekt, wordt de query uitgewaakt naar alle indexen en worden de geretourneerde resultaten samengevoegd.When a user searches, the query is fanned out to all the indexes, and the returned results are merged.

Een gebruiker op één geografische locatie kan bijvoorbeeld zoeken naar inhoud die is opgeslagen op een andere geografische locatie of naar inhoud op een SharePoint-site die is beperkt tot een andere geografische locatie.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. Als de gebruiker toegang heeft tot deze inhoud, wordt het resultaat ervan in de zoekopdracht besyd.If the user has access to this content, search will show the result.

Welke zoek clients werken in een multi-geo-omgeving?Which search clients work in a multi-geo environment?

Deze clients kunnen resultaten van alle geografische locaties retourneren:These clients can return results from all geo locations:

  • OneDrive voor BedrijvenOneDrive for Business
  • DelveDelve
  • De SharePoint startpaginaThe SharePoint home page
  • Het zoekcentrumThe Search Center
  • Aangepaste zoektoepassingen die gebruikmaken van de SharePoint Search APICustom search applications that use the SharePoint Search API

OneDrive voor BedrijvenOneDrive for Business

Zodra de multi-geo-omgeving is ingesteld, krijgen gebruikers die zoeken in OneDrive resultaten van alle geografische locaties.As soon as the multi-geo environment has been set up, users that search in OneDrive get results from all geo locations.

DelveDelve

Zodra de multi-geo-omgeving is ingesteld, krijgen gebruikers die zoeken in Delve resultaten van alle geografische locaties.As soon as the multi-geo environment has been set up, users that search in Delve get results from all geo locations.

De Delve en de profielkaart geven alleen voorbeelden weer van bestanden die zijn opgeslagen op de centrale locatie.The Delve feed and the profile card only show previews of files that are stored in the central location. Voor bestanden die zijn opgeslagen op satellietlocaties, wordt in plaats daarvan het pictogram voor het bestandstype weergegeven.For files that are stored in satellite locations, the icon for the file type is shown instead.

De SharePoint startpaginaThe SharePoint home page

Zodra de multi-geo-omgeving is ingesteld, zien gebruikers nieuws, recente en gevolgde sites van meerdere geografische locaties op hun SharePoint startpagina.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. Als ze het zoekvak op de SharePoint startpagina gebruiken, krijgen ze samengevoegde resultaten van meerdere geografische locaties.If they use the search box on the SharePoint home page, they'll get merged results from multiple geo locations.

Het zoekcentrumThe Search Center

Nadat de multi-geo-omgeving is ingesteld, worden in elk zoekcentrum alleen resultaten van hun eigen geografische locatie weer te geven.After the multi-geo environment has been set up, each Search Center continues to only show results from their own geo location. Beheerders moeten de instellingen van elk zoekcentrum wijzigen om resultaten te krijgen van alle geografische locaties.Admins must change the settings of each Search Center to get results from all geo locations. Daarna krijgen gebruikers die zoeken in het zoekcentrum resultaten van alle geografische locaties.Afterwards, users that search in the Search Center get results from all geo locations.

Aangepaste zoektoepassingenCustom search applications

Zoals gewoonlijk werken aangepaste zoektoepassingen samen met de zoekindexen met behulp van de bestaande SharePoint SEARCH REST-API's.As usual, custom search applications interact with the search indexes by using the existing SharePoint Search REST APIs. Als u resultaten wilt krijgen van alle of bepaalde geografische locaties, moet de toepassing de API bellen en de nieuwe multi-geoqueryparameters in de aanvraag opnemen.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. Hiermee wordt een ventilator uit de query naar alle geografische locaties triggers.This triggers a fan out of the query to all geo locations.

Wat is er anders aan zoeken in een multi-geo-omgeving?What's different about search in a multi-geo environment?

Sommige zoekfuncties die u mogelijk kent, werken anders in een multi-geoomgeving.Some search features you might be familiar with, work differently in a multi-geo environment.

FunctieFeature Hoe het werktHow it works Tijdelijke oplossingWorkaround
Gepromoveerde resultatenPromoted results U kunt queryregels maken met gepromoveerde resultaten op verschillende niveaus: voor de hele tenant, voor een siteverzameling of voor een site.You can create query rules with promoted results at different levels: for the whole tenant, for a site collection, or for a site. Definieer in een multi-geoomgeving gepromoveerde resultaten op tenantniveau om de resultaten te promoveren naar de zoekcentra op alle geografische locaties.In a multi-geo environment, define promoted results at the tenant level to promote the results to the Search Centers in all geo locations. Als u alleen resultaten wilt promoten in het zoekcentrum dat zich op de geografische locatie van de siteverzameling of site bevindt, definieert u de gepromoveerde resultaten op siteverzamelings- of siteniveau.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. Deze resultaten worden niet gepromoveerd op andere geografische locaties.These results are not promoted in other geo locations. Als u geen andere gepromoveerde resultaten per geografische locatie nodig hebt, bijvoorbeeld andere regels voor reizen, raden we u aan gepromoveerde resultaten op tenantniveau te definiëren.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.
Verfijningen zoekenSearch refiners Zoeken retourneert verfijningen van alle geografische locaties van een tenant en verzamelt ze vervolgens.Search returns refiners from all the geo locations of a tenant and then aggregates them. De aggregatie is een goede poging, wat betekent dat het aantal verfijningen mogelijk niet 100% nauwkeurig is.The aggregation is a best effort, meaning that the refiner counts might not be 100% accurate. Voor de meeste zoekscenario's is deze nauwkeurigheid voldoende.For most search-driven scenarios, this accuracy is sufficient. Voor zoektoepassingen die afhankelijk zijn van de verfijningsversterkheid, kunt u elke geografische locatie onafhankelijk van elkaar opvragen.For search-driven applications that depend on refiner completeness, query each geo location independently.
Multi-geo search biedt geen ondersteuning voor dynamische bucketing voor numerieke verfijningen.Multi-geo search doesn't support dynamic bucketing for numerical refiners. Gebruik de parameter 'Discretize' voor numerieke verfijningen.Use the "Discretize" parameter for numerical refiners.
Document-edsDocument IDs Als u een zoektoepassing ontwikkelt die afhankelijk is van document-1D's, moet u er rekening mee houden dat document-ed's in een multi-geo-omgeving niet uniek zijn op geografische locaties, maar uniek zijn per geografische locatie.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. We hebben een kolom toegevoegd die de geografische locatie identificeert.We've added a column that identifies the geo location. Gebruik deze kolom om uniciteit te bereiken.Use this column to achieve uniqueness. Deze kolom heet 'GeoLocationSource'.This column is named "GeoLocationSource".
Aantal resultatenNumber of results De pagina met zoekresultaten bevat gecombineerde resultaten van de geografische locaties, maar het is niet mogelijk om meer dan 500 resultaten te pagina's.The search results page shows combined results from the geo locations, but it's not possible to page beyond 500 results.
Hybride zoekopdrachtHybrid search In een hybride SharePoint omgeving met hybride zoeken in de cloud,wordt on-premises inhoud toegevoegd aan de Microsoft 365 index van de centrale locatie.In a hybrid SharePoint environment with cloud hybrid search, on-premises content is added to the Microsoft 365 index of the central location.

Wat wordt niet ondersteund voor zoeken in een multi-geo-omgeving?What's not supported for search in a multi-geo environment?

Sommige zoekfuncties die u mogelijk kent, worden niet ondersteund in een multi-geoomgeving.Some of the search features you might be familiar with, aren't supported in a multi-geo environment.

ZoekfunctieSearch feature OpmerkingNote
Alleen-app-verificatieApp-only authentication App-only verificatie (privileged access from services) wordt niet ondersteund in multi-geo-zoekopdracht.App-only authentication (privileged access from services) isn't supported in multi-geo search.
GastgebruikersGuest users Gastgebruikers krijgen alleen resultaten van de geografische locatie waar ze naar zoeken.Guest users only get results from the geo location that they're searching from.

Hoe werkt zoeken in een multi-geo-omgeving?How does search work in a multi-geo environment?

Alle zoek clients gebruiken de bestaande SharePoint SEARCH REST API's om te werken met de zoekindexen.All the search clients use the existing SharePoint Search REST APIs to interact with the search indexes.

Diagram waarin wordt SharePoint de interactie tussen zoek-REST-API's en de zoekindexen

  1. Een zoekclient noemt het eindpunt Rest zoeken met de query-eigenschap EnableMultiGeoSearch= waar.A search client calls the Search REST endpoint with the query property EnableMultiGeoSearch= true.
  2. De query wordt verzonden naar alle geografische locaties in de tenant.The query is sent to all geo locations in the tenant.
  3. Zoekresultaten van elke geografische locatie worden samengevoegd en gerangschikt.Search results from each geo location are merged and ranked.
  4. De client krijgt geïntegreerde zoekresultaten.The client gets unified search results.

We voegen de zoekresultaten pas samen als we resultaten van alle geografische locaties hebben ontvangen.Notice that we don't merge the search results until we've received results from all the geo locations. Dit betekent dat meerdere geografische zoekopdrachten extra latentie hebben ten opzichte van zoekopdrachten in een omgeving met slechts één geografische locatie.This means that multi-geo searches have additional latency compared to searches in an environment with only one geo location.

Een zoekcentrum zoeken om resultaten van alle geografische locaties weer te gevenGet a Search Center to show results from all geo locations

Elk zoekcentrum heeft verschillende verticaalen en u moet elke verticaal afzonderlijk instellen.Each Search Center has several verticals and you have to set up each vertical individually.

  1. Zorg ervoor dat u deze stappen voert met een account dat is machtigingen voor het bewerken van de pagina met zoekresultaten en het webonderdeel Zoekresultaten.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. Ga naar de pagina met zoekresultaten (zie de lijst met pagina's met zoekresultaten)Navigate to the search results page (see the list of search results pages)

  3. Selecteer de verticale positie die u wilt instellen, klik Instellingen tandwielpictogram in de rechterbovenhoek en klik vervolgens op Pagina bewerken.Select the vertical to set up, click Settings gear icon in the upper, right corner, and then click Edit Page. De pagina met zoekresultaten wordt geopend in de bewerkingsmodus.The search results page opens in Edit mode.

    Paginaselectie bewerken in Instellingen

  4. Verplaats in het webonderdeel Zoekresultaten de aanwijzer naar de rechterbovenhoek van het webonderdeel, klik op de pijl en klik vervolgens op Webonderdeel bewerken in het menu.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. Het deelvenster Webonderdeel Zoekresultaten wordt geopend onder het lint rechtsboven op de pagina.The Search Results Web Part tool pane opens under the ribbon in the top right of the page.

    Selectie webonderdeel bewerken

  5. Selecteer in het taakvenster van het webonderdeel in de sectie Instellingen onder Instellingen voor resultatenbesturingselement de optie Multi-Geo-resultaten weergeven om het webonderdeel Zoekresultaten weer te geven om resultaten van alle geografische locaties weer te geven.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. Klik op OK om de wijziging op te slaan en het taakvenster van het webonderdeel te sluiten.Click OK to save your change and close the Web Part tool pane.

  7. Controleer uw wijzigingen in het webonderdeel Zoekresultaten door op Inchecken te klikken op het tabblad Pagina van het hoofdmenu.Check your changes to the Search Results Web Part by clicking Check-In on the Page tab of the main menu.

  8. Publiceer de wijzigingen met behulp van de koppeling in de notitie boven aan de pagina.Publish the changes by using the link provided in the note at the top of the page.

Aangepaste zoektoepassingen gebruiken om resultaten van alle of sommige geografische locaties weer te gevenGet custom search applications to show results from all or some geo locations

Aangepaste zoektoepassingen krijgen resultaten van alle of sommige geografische locaties door queryparameters op te geven met de aanvraag voor de SharePoint SEARCH REST API.Custom search applications get results from all, or some, geo locations by specifying query parameters with the request to the SharePoint Search REST API. Afhankelijk van de queryparameters wordt de query uitgewaakt naar alle geografische locaties of naar bepaalde geografische locaties.Depending on the query parameters, the query is fanned out to all geo locations, or to some geo locations. Als u bijvoorbeeld alleen een subset met geografische locaties hoeft te query's uitvoeren om relevante informatie te vinden, kunt u de ventilator alleen naar deze locaties uitbesturing geven.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. Als de aanvraag slaagt, retourneert SharePoint SEARCH REST API antwoordgegevens.If the request succeeds, the SharePoint Search REST API returns response data.

VereisteRequirement

Voor elke geografische locatie moet u ervoor zorgen dat alle gebruikers in de organisatie het machtigingsniveau Lezen hebben gekregen voor de hoofdwebsite (bijvoorbeeld contoso APAC.sharepoint.com/ en 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/). Meer informatie over machtigingen.Learn about permissions.

QueryparametersQuery parameters

EnableMultiGeoSearch: dit is een Booleaanse waarde die aangeeft of de query moet worden uitgewaakt naar de indexen van andere geografische locaties van de multi-geotenant.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. Stel deze in op waar om de query uit te ventilatoren. onwaar om de query niet uit te waaieren.Set it to true to fan out the query; false to not fan out the query. Als u deze parameter niet opgeeft, is de standaardwaarde onwaar, behalve wanneer u een REST API-oproep doet tegen een site die de sjabloon Enterprise Search Center gebruikt, in dit geval is de standaardwaarde waar.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. Als u de parameter gebruikt in een omgeving die niet multi-geo is, wordt de parameter genegeerd.If you use the parameter in an environment that isn't multi-geo, the parameter is ignored.

ClientType: dit is een tekenreeks.ClientType - This is a string. Voer een unieke clientnaam in voor elke zoektoepassing.Enter a unique client name for each search application. Als u deze parameter niet opgeeft, wordt de query niet uitgewaakt naar andere geografische locaties.If you don't include this parameter, the query is not fanned out to other geo locations.

MultiGeoSearchConfiguration - Dit is een optionele lijst van de geografische locaties in de multi-geo tenant om de query uit te ventilatoren wanneer EnableMultiGeoSearch waar is.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. Als u deze parameter niet opgeeft of leeg laat, wordt de query uitgewaakt naar alle geografische locaties.If you don't include this parameter, or leave it blank, the query is fanned out to all geo locations. Voer voor elke geografische locatie de volgende items in in de JSON-indeling:For each geo location, enter the following items, in JSON format:

ItemItem BeschrijvingDescription
DataLocationDataLocation De geografische locatie, bijvoorbeeld nam.The geo location, for example NAM.
EndPointEndPoint Het eindpunt waar u verbinding mee wilt maken, bijvoorbeeld https://contoso.sharepoint.comThe endpoint to connect to, for example https://contoso.sharepoint.com
SourceIdSourceId De GUID van de resultatenbron, bijvoorbeeld B81EAB55-3140-4312-B0F4-9459D1B4FFEE.The GUID of the result source, for example B81EAB55-3140-4312-B0F4-9459D1B4FFEE.

Als u DataLocation of EndPoint weglaat of als een DataLocation wordt gedupliceerd, mislukt de aanvraag.If you omit DataLocation or EndPoint, or if a DataLocation is duplicated, the request fails. U kunt informatie krijgen over het eindpunt van de geografische locaties van een tenant met Behulp van Microsoft Graph.You can get information about the endpoint of a tenant's geo locations by using Microsoft Graph.

AntwoordgegevensResponse data

MultiGeoSearchStatus: dit is een eigenschap die de SharePoint Search API retourneert als antwoord op een aanvraag.MultiGeoSearchStatus – This is a property that the SharePoint Search API returns in response to a request. De waarde van de eigenschap is een tekenreeks en geeft de volgende informatie over de resultaten die de SharePoint Search API retourneert:The value of the property is a string and gives the following information about the results that the SharePoint Search API returns:

WaardeValue BeschrijvingDescription
VolledigFull Volledige resultaten van alle geografische locaties.Full results from all the geo locations.
GedeeltelijkPartial Gedeeltelijke resultaten van een of meer geografische locaties.Partial results from one or more geo locations. De resultaten zijn onvolledig vanwege een tijdelijke fout.The results are incomplete due to a transient error.

Query met de REST-serviceQuery using the REST service

Met een GET-aanvraag geeft u de queryparameters op in de URL.With a GET request, you specify the query parameters in the URL. Met een POST-aanvraag passeert u de queryparameters in de body in de JSON-indeling (JavaScript Object Notation).With a POST request, you pass the query parameters in the body in JavaScript Object Notation (JSON) format.

AanvraagheadersRequest headers

NameName ValueValue
Content-TypeContent-Type application/json;odata=verboseapplication/json;odata=verbose

Voorbeeld van GET-aanvraag die is uitgewaakt naar alle geografische locatiesSample 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'

Voorbeeld van GET-aanvraag om uit te waaieren naar bepaalde geografische locatiesSample 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"}]'

Notitie

Komma's en dubbele puntpunten in de lijst met geografische locaties voor de eigenschap MultiGeoSearchConfiguration worden voorafgegaan door het backslash-teken.Commas and colons in the list of geo locations for the MultiGeoSearchConfiguration property are preceded by the backslash character. Dit komt omdat get-aanvragen dubbele punten gebruiken om eigenschappen en komma's te scheiden om argumenten van eigenschappen te scheiden.This is because GET requests use colons to separate properties and commas to separate arguments of properties. Zonder de backslash als een escape-teken wordt de eigenschap MultiGeoSearchConfiguration verkeerd geïnterpreteerd.Without the backslash as an escape character, the MultiGeoSearchConfiguration property is interpreted wrongly.

Voorbeeld van een POST-aanvraag die is uitgewaakt naar alle geografische locatiesSample 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"
        }
    }

Voorbeeld van een POST-aanvraag die is uitgewaakt naar bepaalde geografische locatiesSample 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
                        }
                    }
                ]
            }
        }
    }

Query met behulp van CSOMQuery using CSOM

Hier is een voorbeeld van een CSOM-query die is uitgewaakt naar alle geografische locaties: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.Properties["EnableMultiGeoSearch"] = true;