Configurar a Pesquisa do Microsoft 365 Multi-Geo

Seu Locatário Multigeográfico terá recursos de pesquisa agregada, permitindo que uma consulta de pesquisa retorne resultados de qualquer lugar dentro do Locatário.

Por padrão, as pesquisas desses pontos de entrada retornarão resultados agregados, mesmo que cada índice de pesquisa esteja localizado em seu local Geography relevante:

  • OneDrive
  • Delve
  • Página inicial do SharePoint
  • Centro de Pesquisa

Além disso, os recursos de pesquisa multigeográfica podem ser configurados para seus aplicativos de pesquisa personalizados que usam a API de pesquisa do SharePoint.

Consulte Configurar Pesquisa para OneDrive Multi-Geo para obter instruções, incluindo quaisquer limitações e diferenças.

Validar a configuração do Microsoft 365 Multi-Geo

Abaixo estão alguns casos de uso básicos que você pode incluir no seu plano de validação antes de lançar amplamente o Microsoft 365 Multi-Geo na sua empresa. Depois de concluir esses testes e os casos de uso mais relevantes para sua empresa, você pode optar por prosseguir e adicionar os usuários em seu grupo piloto inicial.

OneDrive:

Selecione OneDrive no inicializador de aplicativos do Microsoft 365 e confirme que você é direcionado automaticamente para o local de Geografia apropriado para o usuário, com base no PDL do usuário. O OneDrive agora deve começar a provisionar nesse local. Uma vez provisionado, tente carregar e baixar alguns documentos.

Aplicativo Móvel do OneDrive:

Faça logon no aplicativo móvel OneDrive com as credenciais da sua conta de teste. Confirme se você pode ver seus arquivos do OneDrive e interagir com eles de seu dispositivo móvel.

Cliente de Sincronização do OneDrive:

Confirme se o cliente de Sincronização do OneDrive detecta automaticamente sua localização geográfica do OneDrive ao efetuar logon. Se precisar baixar o cliente de sincronização, você poderá clicar em Sincronizar na biblioteca do OneDrive.

Aplicativos do Office:

Confirme se você pode acessar o OneDrive fazendo logon em um aplicativo do Office, como o Word. Abra o aplicativo do Office e selecione OneDrive - <TenantName>. O Office detectará a localização do OneDrive e mostrará os arquivos que você pode abrir.

Compartilhamento:

Tente compartilhar arquivos do OneDrive. Confirme se o seletor de pessoas mostra todos os usuários do SharePoint, independentemente da localização geográfica .

Em um ambiente multigeográfico , cada localização geográfica tem seu próprio índice de pesquisa e Centro de Pesquisa. Quando um usuário pesquisa, é realizado o fan out para todos os índices e os resultados retornados são mesclados.

Por exemplo, um usuário em um local de Geografia pode pesquisar conteúdo armazenado em outro local de Geografia ou conteúdo em um site do SharePoint restrito a um local de Geografia diferente. Se o usuário tiver acesso a esse conteúdo, a pesquisa mostrará o resultado.

Quais clientes de pesquisa funcionam em um ambiente multigeográfico?

Esses clientes podem retornar resultados de todos os locais de Geografia:

  • OneDrive
  • Delve
  • A home page do SharePoint
  • O Centro de Pesquisa
  • Aplicativos de pesquisa personalizada que usam a API de pesquisa do SharePoint

OneDrive

Assim que o ambiente Multi-Geo for configurado, os usuários que pesquisarem no OneDrive obterão resultados de todos os locais de Geografia .

Delve

Assim que o ambiente Multi-Geo tiver sido configurado, os usuários que pesquisarem no Delve obterão resultados de todos os locais de Geografia .

O feed do Delve e o cartão de perfil mostram apenas as visualizações dos arquivos que estão armazenadas em uma localização central. Para arquivos armazenados em locais de Geografia de Satélite , o ícone para o tipo de arquivo é mostrado em vez disso.

A home page do SharePoint

Assim que o ambiente Multi-Geo for configurado, os usuários verão notícias, sites recentes e seguidos de vários locais geográficos em sua página inicial do SharePoint . Se eles usarem a caixa de pesquisa na página inicial do SharePoint, eles obterão resultados mesclados de vários locais de Geografia .

O Centro de Pesquisa

Depois que o ambiente multigeográfico for configurado, cada Centro de Pesquisa continuará a mostrar apenas os resultados de seu próprio local geográfico . Os administradores devem alterar as configurações de cada Centro de Pesquisa para obter resultados de todos os locais de Geografia . Posteriormente, os usuários que pesquisam no Centro de Pesquisa obtêm resultados de todos os locais de Geografia .

Aplicativos de pesquisa personalizada

Como de costume, os aplicativos de pesquisa personalizados interagem com os índices de pesquisa usando as APIs REST de pesquisa do SharePoint existentes. Para obter resultados de todos ou alguns locais de Geografia , o aplicativo deve chamar a API e incluir os novos parâmetros de consulta Multi-Geo na solicitação. Isso dispara uma distorção da consulta a todos os locais de Geografia .

Qual é a diferença na pesquisa em um ambiente Multi-Geo?

Alguns recursos de pesquisa que talvez você conheça funcionam diferente em um ambiente multigeográfico.

Recurso Como funciona Solução alternativa
Resultados promovidos Você pode criar regras de consulta com resultados promovidos em diferentes níveis: para todo o locatário, para um conjunto de sites ou para um site. Em um ambiente Multi-Geo, defina os resultados promovidos no nível do Locatário para promover os resultados para os Centros de Pesquisa em todos os locais de Geografia . Se você quiser promover apenas resultados no Centro de Pesquisa que está no local de Geografia do conjunto de sites ou site, defina os resultados promovidos no nível do conjunto de sites ou do site. Esses resultados não são promovidos em outros locais de Geografia . Se você não precisar de resultados promovidos diferentes por localização geográfica, por exemplo, regras diferentes para viajar, recomendamos definir os resultados promovidos no nível do locatário .
Refinadores de pesquisa A pesquisa retorna refinadores de todos os locais de Geografia de um Locatário e, em seguida, agrega-os. A agregação é um esforço melhor, o que significa que as contagens do refinador podem não ser 100% precisas. Para a maioria dos cenários controlados por pesquisa, essa precisão é suficiente. Para aplicativos controlados por pesquisa que dependem da integridade do refinador, consulte cada localização geográfica independentemente.
A pesquisa multigeográfica não dá suporte ao particionamento dinâmico para refinadores numéricos. Use o parâmetro "Discretize" para refinadores numéricos.
IDs do documento Se você estiver desenvolvendo um aplicativo orientado por pesquisa que depende de IDs de documento, observe que as IDs de documento em um ambiente Multi-Geo não são exclusivas entre locais de Geografia , elas são exclusivas por localização de Geografia . Adicionamos uma coluna que identifica o local da Geografia . Use essa coluna para ter exclusividade. Essa coluna é chamada de "GeoLocationSource".
Número de resultados A página de resultados da pesquisa mostra resultados combinados dos locais de Geografia , mas não é possível paginar além de 500 resultados.
Pesquisa híbrida Em um ambiente híbrido do SharePoint com pesquisa híbrida na nuvem, o conteúdo local é adicionado ao índice do Microsoft 365 do local central.

O que a pesquisa em um ambiente multigeográfico não suporta?

Alguns dos recursos de pesquisa que talvez você conheça não são suportados em um ambiente multigeográfico.

Recurso de pesquisa Observação
Autenticação somente aplicativo A autenticação somente de aplicativos (acesso privilegiado dos serviços) não tem suporte na pesquisa multigeográfica.
Convidados Os convidados só obtêm resultados do local de Geografia de onde estão pesquisando.

Como a pesquisa funciona em um ambiente multigeográfico?

Todos os clientes de pesquisa usam as APIs REST de Pesquisa existentes do SharePoint para interagir com os índices de pesquisa.

Diagrama mostrando como as APIs REST de Pesquisa do SharePoint interagem com os índices de pesquisa.

  1. Um cliente pesquisa chama o ponto de extremidade da API REST com a propriedade de consulta EnableMultiGeoSearch= true.
  2. A consulta é enviada para todos os locais de Geografia no Locatário.
  3. Os resultados da pesquisa de cada local de Geografia são mesclados e classificados.
  4. O cliente obtém resultados de pesquisa unificados.

Observe que não mesclamos os resultados da pesquisa até recebemos resultados de todas as localizações geográficas. Isso significa que pesquisas multigeográficas têm latência adicional comparadas com pesquisas em um ambiente com localização geográfica única.

Obter um centro de pesquisa para mostrar resultados de todas as localizações geográficas

Cada centro de pesquisa tem vários verticais e você precisará configurar cada vertical individualmente.

  1. Certifique-se de executar essas etapas com uma conta que tenha permissão para editar a página de resultados de pesquisa e a Web Part de resultados de pesquisa.

  2. Navegue até a página de resultados de pesquisa (confira a lista das páginas de resultados de pesquisa)

  3. Selecione a vertical para configurar , clique no ícone de engrenagem Configurações no canto superior direito e clique em Editar página. A página de resultados da pesquisa é aberta no Modo de edição.

    Edite a seleção de página em Configurações.

  4. Na Web Part de Resultados de Pesquisa, mova o ponteiro para o canto superior direito da web part, clique na seta e, em seguida, clique em Editar Web Part no menu. O painel de ferramentas da Web Part de Resultados de Pesquisa é aberto na faixa de opções no canto superior direito da página.

    Editar seleção de Web Part.

  5. No painel de ferramentas da Web Part, na seção Configurações, em Configurações de controle de resultados, marque Mostrar resultados multigeográficos para obter a Web Part de resultados de pesquisa para mostrar resultados de todas as localizações geográficas.

  6. Clique em OK para salvar as alterações e fechar o painel de ferramentas da Web Part.

  7. Verifique as suas alterações na Web Part de resultados da pesquisa clicando em Check-In na guia Página do menu principal.

  8. Publique as alterações usando o link fornecido na observação na parte superior da página.

Obter aplicativos de pesquisa personalizada para mostrar resultados de todas ou algumas localizações geográficas

Os aplicativos de pesquisa personalizados obtêm resultados de todos ou alguns locais de Geografia especificando parâmetros de consulta com a solicitação para a API REST de Pesquisa do SharePoint. Dependendo dos parâmetros de consulta, a consulta é distribuída para todos os locais de Geografia ou para alguns locais geográficos. Por exemplo, se você só precisar consultar um subconjunto de locais de Geografia para encontrar informações relevantes, poderá controlar o ventilador para apenas eles. Se a solicitação for bem-sucedida, a API REST de pesquisa do SharePoint retornará dados de resposta.

Requisito

Para cada localização geográfica, você deve garantir que todos os usuários da organização tenham recebido o nível de permissão de leitura para o site raiz (por exemplo, contosoAPAC.sharepoint.com/ e contosoEU.sharepoint.com/). Saiba mais sobre permissões.

Parâmetros de consulta

EnableMultiGeoSearch – esse é um valor booliano que especifica se a consulta deve ser distribuída para os índices de outras localizações geográficas do locatário multigeográfico. Definido como verdadeiro para realizar o fan out da consulta. falso para não realizar o fan out da consulta. Se você não incluir esse parâmetro, o valor padrão será falso, exceto ao fazer uma chamada da API REST em um site que use o modelo do Centro de Pesquisa Corporativo; nesse caso, o valor padrão será verdadeiro. Se você usa o parâmetro em um ambiente que não é multigeográfico, o parâmetro será ignorado.

ClientType - Isso é uma cadeia de caracteres. Insira um nome exclusivo do cliente para cada aplicativo de pesquisa. Se esse parâmetro não for incluído, o fan out da consulta não é feito em outra localizações geográficas.

MultiGeoSearchConfiguration – essa é uma lista opcional de quais localizações geográficas no locatário multigeográfico distribuir a consulta quando EnableMultiGeoSearch for verdadeiro. Se você não incluir este parâmetro ou deixar em branco, o fan out da consulta é feito para todas as localizações geográficas. Para cada localização geográfica, insira os seguintes itens no formato JSON:

Item Descrição
DataLocation O local de Geografia , por exemplo, NAM.
EndPoint O ponto de extremidade ao qual se conectar, por exemplo, https://contoso.sharepoint.com
SourceId O GUID da fonte de resultados, por exemplo, B81EAB55-3140-4312-B0F4-9459D1B4FFEE.

Se você omitir DataLocation ou EndPoint, ou se um DataLocation for duplicado, a solicitação falhará. Você pode obter informações sobre o ponto de extremidade das localizações geográficas de um locatário usando o Microsoft Graph.

Dados de resposta

MultiGeoSearchStatus - Essa é uma propriedade que a API de Pesquisa do SharePoint retorna em resposta a uma solicitação. O valor da propriedade é uma cadeia de caracteres e fornece as seguintes informações sobre os resultados retornados pela API de Pesquisa do SharePoint:

Valor Descrição
Completo Resultados completos de todos os locais de Geografia .
Parcial Resultados parciais de um ou mais locais de Geografia . Os resultados estão incompletos devido a um erro transitório.

Consulta usando o serviço REST

Com uma solicitação GET, você especifica os parâmetros de consulta na URL. Com uma solicitação POST, você passa os parâmetros de consulta no corpo no formato JSON (JavaScript Object Notation).

Cabeçalhos de solicitação

Nome Valor
Content-Type application/json;odata=verbose

Exemplo de solicitação GET da qual se realiza fan-out para todas as localizações geográficas

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

Exemplo de solicitação GET da qual realizar fan-out para algumas localizações geográficas

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"}]'

Observação

Vírgulas e dois-pontos na lista de localizações geográficas para a propriedade MultiGeoSearchConfiguration são precedidas pelo caractere barra invertida. Isso ocorre porque solicitações GET usam dois-pontos para separar propriedades e vírgulas para separar os argumentos das propriedades. Sem uma barra invertida como um caractere de escape, a propriedade MultiGeoSearchConfiguration será interpretada incorretamente.

Exemplo de solicitação POST da qual se realiza fan-out para todas as localizações geográficas

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

Exemplo de solicitação POST da qual se realiza fan-out para algumas localizações geográficas

    {
        "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
                        }
                    }
                ]
            }
        }
    }

Consulta usando o CSOM

Aqui está um exemplo de consulta CSOM distribuída para todos os locais de Geografia:

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