Настройка поиска для OneDrive для бизнеса Multi географическиConfigure Search for OneDrive for Business Multi-Geo

В среде с несколькими географически SharePoint Online (SPO) может иметь одну клиента Office 365 организации, но хранить их содержимого SharePoint в нескольких географических местах - одного центрального местоположения и один или несколько вспомогательные географического расположения.In a Multi-Geo SharePoint Online (SPO) environment, an organization can have one Office 365 tenant, but store their SharePoint content in multiple geographical locations - one central location and one or more satellite geo locations.

Каждый свое географическое местоположение имеет свой собственный центр поиска и индекс поиска. При выполнении пользователем поиска, запрос fanned в работе для всех индексов и объединяются возвращаемых результатов.Each geographical location has its own search index and Search Center. When a user searches, the query is fanned out to all the indexes, and the returned results are merged.

К примеру пользователей в одном месте географически можно найти контент, который хранится в другом месте географически, и для контента на сайте SharePoint, в которую различных географического расположения. Если у пользователя есть доступ к этому содержимому, поиска будет показывать результат.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. If the user has access to this content, search will show the result.

В среде с несколькими географически которого поиск работы клиентов?Which search clients work in a Multi-Geo environment?

Эти клиенты могут возвращать результаты из всех расположений географически:These clients can return results from all geo locations:

  • OneDrive for BusinessOneDrive for Business

  • DelveDelve

  • Домашняя страница SharePointThe SharePoint home page

  • Центр поискаThe Search Center

  • Настраиваемые приложения поиска, использующие API поиска SharePointCustom search applications that use the SharePoint Search API

OneDrive for BusinessOneDrive for Business

Настройка среды ферма с несколькими географически сразу же пользователей, в которых поиск в OneDrive получать результаты из всех расположений географически.As soon as the Multi-Geo environment has been set up, users that search in OneDrive get results from all geo locations.

DelveDelve

Настройка среды ферма с несколькими географически сразу же пользователей, в которых поиск в Delve получать результаты из всех расположений географически.As soon as the Multi-Geo environment has been set up, users that search in Delve get results from all geo locations.

Веб-канал Delve и Карточка профиля отображаются только предварительный просмотр файлов, которые хранятся в центральном расположении. Для файлов, которые хранятся в вспомогательных географического расположения вместо этого отображается значок для типа файла.The Delve feed and the profile card only show previews of files that are stored in the central location. For files that are stored in satellite geo locations, the icon for the file type is shown instead.

Домашняя страница SharePointThe SharePoint home page

Как настроить среду несколькими географически пользователи увидят новости, последние и число сайтов из нескольких расположений географически на своей домашней странице SharePoint. При использовании поля поиска на домашней странице 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. If they use the search box on the SharePoint home page, they'll get merged results from multiple geo locations.

Центр поискаThe Search Center

После Multi-географически среды был настроен, каждого центра поиска по-прежнему производится только Показать результаты из географического расположения. Администраторы должны Изменить параметры каждого центра поиска для получения результатов из всех расположений географически. После этого пользователи, в которых поиск в центре поиска получать результаты из всех расположений географически.After the Multi-Geo environment has been set up, each Search Center continues to only show results from their own geo location. Admins must change the settings of each Search Center to get results from all geo locations. Afterwards, users that search in the Search Center get results from all geo locations.

Настраиваемые приложения поискаCustom search applications

Как обычно настраиваемые приложения поиска взаимодействовать с индексы поиска с помощью существующих API REST поиска SharePoint. Для получения результатов из всех или некоторых географического расположения, приложение должно вызов API и включения новых параметров запроса несколькими географически в запросе. Это запускает вентилятора из него запросов на все географического расположения.As usual, custom search applications interact with the search indexes by using the existing SharePoint Search REST APIs. 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. This triggers a fan out of the query to all geo locations.

Каковы отличия, о поиске в среде с несколькими географически?What’s different about search in a Multi-Geo environment?

Некоторые функции поиска, которые могут быть знакомы, работают по-разному в среде с несколькими географически.Some search features you might be familiar with, work differently in a Multi-Geo environment.

КомпонентFeature Как это работаетHow does it work Обходной путьWorkaround
Результатов повышенного уровняPromoted results Можно создать правила запросов с повышенным уровнем результаты на различных уровнях: для всей клиента, для семейства веб-сайтов или для сайта. В среде с несколькими географически определите результатов повышенного уровня на уровне клиента , чтобы повысить уровень результатов в центрах поиска во всех расположениях географически. Вы только продвигать результаты в центре поиска, который находится в папке географически семейства веб-сайтов или сайта, определите результаты на уровне семейства веб-сайтов или сайта .You can create query rules with promoted results at different levels: for the whole tenant, for a site collection, or for a site. In a Multi-Geo environment, define promoted results at the tenant level if you want to promote the results to the Search Centers in all geo locations. 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 results at the site collection or site level. Если не требуется различных результатов повышенного уровня одного географического расположения, например различные правила поездок, мы рекомендуем определение результатов на уровне клиента повышенного уровня.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.
Уточнения поискаSearch refiners Поиск возвращает уточнений из всех расположений географически клиента и затем объединяет их. Объединение — это все возможное, что означает, что счетчиков может быть точных 100%. Для большинства сценариев на основе механизмов поиска это является достаточно.Search returns refiners from all the geo locations of a tenant and then aggregates them. The aggregation is a best effort, meaning that the refiner counts might not be 100% accurate. For most search-driven scenarios, this accuracy is sufficient. Для приложения на основе поиска, зависящих от полнота уточнения запросов для каждого географического расположения независимо друг от друга без использования несколькими географически развертывания.For search-driven applications that depend on refiner completeness, query each geo location independently without using Multi-Geo fan-out.
Ферма с несколькими географически поиска не поддерживает динамические сегментация для числовых уточнений.Multi-Geo search doesn’t support dynamic bucketing for numerical refiners. Используйте параметр «Discretize» для числовых уточнений.Use the “Discretize” parameter for numerical refiners.
Идентификаторы документовDocument IDs При разработке приложения на основе механизмов поиска, которое зависит от идентификаторами документов, обратите внимание на то, что идентификаторы документов в среде с несколькими географически не уникальный в географически подразделениях, они являются уникальными для географического расположения.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. Мы добавили столбец, который идентифицирует географического расположения. Используйте этот столбец для обеспечения уникальности. Этот столбец является с именем «GeoLocationSource».We’ve added a column that identifies the geo location. Use this column to achieve uniqueness. This column is named “GeoLocationSource”.
Число результатовNumber of results Страницы результатов поиска отображает объединенный результаты из географического расположения, но невозможно страницы за пределы 500 результатов.The search results page shows combined results from the geo locations, but it’s not possible to page beyond 500 results.

Что не поддерживается для поиска в среде с несколькими географически?What’s not supported for search in a Multi-Geo environment?

Некоторые функции поиска, которые могут быть знакомы, не поддерживаются в среде с несколькими географически.Some of the search features you might be familiar with, aren’t supported in a Multi-Geo environment.

Функция поискаSearch feature ПримечаниеNote
Проверка подлинности только для приложенийApp-only authentication Только проверка подлинности (привилегированный доступ из служб) не поддерживается в географически несколькими поиска.App-only authentication (privileged access from services) isn’t supported in Multi-Geo search.
ГостиGuest users Гости получить только результаты из географического расположения, они поиска из.Guest users only get results from the geo location that they’re searching from.

Как работает поиска работает в среде с несколькими географически?How does search work in a Multi-Geo environment?

Все клиенты поиска использовать существующие интерфейсы API REST поиска SharePoint для взаимодействия с индексы поиска.All the search clients use the existing SharePoint Search REST APIs to interact with the search indexes.

  1. Клиент поиска вызывает конечная точка REST поиска с помощью свойства запроса EnableMultiGeoSearch = true.A search client calls the Search REST endpoint with the query property EnableMultiGeoSearch= true.
  2. Запрос отправляется все географического расположения в клиентов.The query is sent to all geo locations in the tenant.
  3. Результаты поиска из каждого географического расположения объединенных и ранжирования.Search results from each geo location are merged and ranked.
  4. Клиент получает результаты стандартизированное.The client gets unified search results.

Обратите внимание на то, что мы не объединение результатов поиска, пока мы получили результаты из всех расположений географически. Это означает, что поиск несколькими географически дополнительные задержки, по сравнению с поисков в среде с только один географического расположения.Notice that we don’t merge the search results until we’ve received results from all the geo locations. This means that Multi-Geo searches have additional latency compared to searches in an environment with only one geo location.

Получение центра поиска, чтобы показать результаты из всех расположений географическиGet a Search Center to show results from all geo locations

Каждого центра поиска имеет несколько вертикали и должны настроить по вертикали каждого по отдельности.Each Search Center has several verticals and you have to set up each vertical individually.

  1. Убедитесь, что выполняются эти действия с использованием учетной записи, которая имеет разрешение на изменение страницы результатов поиска и веб-части результатов поиска.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. Перейдите на страницу результатов поиска (просматривать страницы результатов поиска списка )Navigate to the search results page (see the list of search results pages)

  3. Выберите вертикальная для установки, щелкните значок шестеренки Параметры в верхнем правом углу окна и выберите команду Изменить страницу. Откроется страница результатов поиска в режиме редактирования.Select the vertical to set up, click Settings gear icon in the upper, right corner, and then click Edit Page. The search results page opens in Edit mode.

  4. В веб-части результатов поиска наведите указатель на верхний правый угол веб-части щелкните стрелку и выберите в меню команду Изменить веб-часть . Откроется панель инструмента веб-части результатов поиска в разделе ленты в верхней правой части страницы.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. The Search Results Web Part tool pane opens under the ribbon in the top right of the page.

  5. В области инструментов веб-части в разделе Параметры в области результатов задают параметрывыберите Показать несколькими географически результатов для получения веб-части результатов поиска для отображения результатов из всех расположений географически.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. Нажмите кнопку ОК , чтобы сохранить изменения и закрыть панель инструментов веб-части.Click OK to save your change and close the Web Part tool pane.

  7. Проверка изменений для веб-части результатов поиска, щелкнув Возврат на вкладке Страница главного меню.Check your changes to the Search Results Web Part by clicking Check-In on the Page tab of the main menu.

  8. Публикация изменений с помощью ссылки, содержащиеся в примечание в верхней части страницы.Publish the changes by using the link provided in the note at the top of the page.

Получение настраиваемые приложения поиска для отображения результатов из всех или некоторых географического расположенияGet custom search applications to show results from all or some geo locations

Настраиваемые приложения поиска получать результаты из всех или некоторых, географического расположения, путем указания параметров запроса с запросом на API REST поиска SharePoint. В зависимости от параметров запроса запрос fanned все географического расположения или некоторые географического расположения. Например если вам требуется только для запроса подмножество географически местоположения, чтобы найти информацию, можно управлять веером только такие. Если запрос пройдет успешно, API REST поиска SharePoint возвращает данные ответа.Custom search applications get results from all, or some, geo locations by specifying query parameters with the request to the SharePoint Search REST API. Depending on the query parameters, the query is fanned out to all geo locations, or to some geo locations. 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. If the request succeeds, the SharePoint Search REST API returns response data.

Параметры запросаQuery parameters

EnableMultiGeoSearch — это логическое значение, указывает ли запрос должен fanned в работе с индексами другие расположения географически несколькими географически клиента. Значение true, чтобы проходят запросов; значение false, чтобы не проходят запроса. Значение по умолчанию — false. Если этот параметр не указан, запрос — это не fanned в работе других географического расположения. При использовании параметра в среде, где не несколькими географически параметр игнорируется.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. Set it to true to fan out the query; false to not fan out the query. The default value is false. If you don’t include this parameter, the query is not fanned out to other geo locations. If you use the parameter in an environment that isn’t Multi-Geo, the parameter is ignored.

Типа клиента — это строка. Введите имя уникальное клиента для каждого приложения поиска. Если этот параметр не указан, запрос — это не fanned в работе других географического расположения.ClientType - This is a string. Enter a unique client name for each search application. If you don’t include this parameter, the query is not fanned out to other geo locations.

MultiGeoSearchConfiguration — это необязательный список из которых географически расположений в различных-географически клиентов для проходят запрос к при EnableMultiGeoSearch имеет значение true. Если не включить этот параметр, или оставьте его пустым, запрос fanned в работе для всех географического расположения. Для каждого географического расположения введите указанные ниже представлен в формате JSON.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. If you don’t include this parameter, or leave it blank, the query is fanned out to all geo locations. For each geo location, enter the following items, in JSON format:

ЭлементItem ОписаниеDescription
DataLocationDataLocation Расположение географически, например им.The geo location, for example NAM.
Конечная точкаEndPoint Конечная точка следует подключиться, напримерhttps://contoso.sharepoint.comThe endpoint to connect to, for example https://contoso.sharepoint.com
SourceIdSourceId Идентификатор GUID источника результатов, например B81EAB55-3140-4312-B0F4-9459D1B4FFEE.The GUID of the result source, for example B81EAB55-3140-4312-B0F4-9459D1B4FFEE.

Если опустить DataLocation или конечную точку или дублируются DataLocation, не удается выполнить запрос. Вы можете получать сведения о конечной точки клиента географического расположения с помощью Microsoft Graph.If you omit DataLocation or EndPoint, or if a DataLocation is duplicated, the request fails. You can get information about the endpoint of a tenant's geo locations by using Microsoft Graph.

Данные ответаResponse data

MultiGeoSearchStatus — это свойство, которое возвращает API поиска SharePoint в ответ на запрос. Значение свойства — это строка и дает следующие сведения о результатах, возвращаемых API поиска SharePoint:MultiGeoSearchStatus – This is a property that the SharePoint Search API returns in response to a request. The value of the property is a string and gives the following information about the results that the SharePoint Search API returns:

ЗначениеValue ОписаниеDescription
Полный доступFull Полный результаты из всех расположений географически.Full results from all the geo locations.
ЧастичноPartial Частичный результаты из одного или нескольких географического расположения. Результаты не завершены из-за временные ошибки.Partial results from one or more geo locations. The results are incomplete due to a transient error.

Запрос с использованием службы RESTQuery using the REST service

Запрос GET позволяет определить параметры запроса в URL-адрес. С помощью запроса POST передайте параметров запроса в тексте запроса в формате JavaScript Object Notation (JSON).With a GET request, you specify the query parameters in the URL. With a POST request, you pass the query parameters in the body in JavaScript Object Notation (JSON) format.

Заголовки запросовRequest headers

ИмяName ЗначениеValue
Content-TypeContent-Type приложение/json; odata = verboseapplication/json;odata=verbose

Пример запроса GET, fanned в работе, чтобы все географического расположенияSample GET request that’s fanned out to all geo locations

https:// <клиента>/_api/search/query?querytext = «sharepoint» & свойства = «EnableMultiGeoSearch:true» & типа клиента = "Мои_клиента_идентификатор"https:// <tenant>/_api/search/query?querytext='sharepoint'&Properties='EnableMultiGeoSearch:true'&ClientType='my_client_id'

Пример запроса GET для проходят некоторые географического расположенияSample GET request to fan out to some geo locations

https:// /_api/search/query?querytext = «узел» & типа клиента = «my_client_id» & Свойства = "EnableMultiGeoSearch:true, MultiGeoSearchConfiguration: [{DataLocation:«Им»,конечная точка:«https: contosoNAM.sharepoint.com»,SourceId:«B81EAB55-3140-4312-B0F4-9459D1B4FFEE»},{DataLocation:«Может»,конечная точка:«https://contosoCAN.sharepoint-df.com»}] "https:// /_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"}]'

Пример запроса POST, fanned в работе, чтобы все географического расположенияSample 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"
    }
}

Пример запроса POST, fanned в работе для некоторых географического расположенияSample 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
                    }
                }
            ]
        }
    }
}

Запрос с использованием CSOMQuery using CSOM

Ниже приведен пример запроса CSOM, fanned в работе, чтобы все географического расположения: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;