Conector CSV

  • Artigo

O conector do CSV Graph permite que sua organização ingera conteúdo de arquivos CSV armazenados em bibliotecas do SharePoint e Azure Data Lake Storage (ADLS). Depois de configurar o conector e o conteúdo de índice dessas fontes, os usuários finais poderão encontrar arquivos CSV no Microsoft Search.

Observação

Leia o artigo Configuração do conector do Graph para entender as instruções gerais de instalação dos conectores do Graph.

Este artigo é para qualquer pessoa que configure, execute e monitore um conector CSV. Ele complementa o processo de instalação geral e mostra instruções que se aplicam apenas a esse conector.

Antes de começar

Verifique se não há espaço em branco nos cabeçalhos CSV. Para uma fonte de dados do SharePoint, você precisará criar um aplicativo do SharePoint com a configuração do Oauth. Para uma fonte de dados do ADLS, você precisará criar uma conta de armazenamento do ADLS.

Criar um aplicativo do SharePoint com a configuração do Oauth

Verifique se os arquivos .csv que você deseja indexar foram carregados em uma biblioteca de documentos do SharePoint. Você pode usar um site do SharePoint existente ou criar um novo.

Criar um aplicativo do SharePoint

  1. Saiba mais em https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appregnew.aspx.
  2. Nos campos ID do Cliente e Segredo do Cliente, selecione Gerar.
  3. Para Título, insira um nome de aplicativo.
  4. No campo Domínio do Aplicativo, insira www.gcs.com.
  5. No campo URL de redirecionamento, insira https://www.gcs.com.
  6. Selecione Criar.
  7. Copie as informações de configuração do aplicativo, incluindo a ID do cliente e o Segredo do Cliente. Você precisará dele quando configurar o conector CSV.

Habilitar permissões de aplicativo para permitir CustomAppAuthentication

No PowerShell (Shell de Gerenciamento online do SharePoint), execute esses comandos no modo administrativo. Use o endereço de email do administrador que configura o conector e o nome da organização. Quando o pop-up de senha for exibido, o administrador deverá inserir sua senha.

Install-Module -Name Microsoft.Online.SharePoint.PowerShell
$adminUPN=”<admin@contoso.onmicrosoft.com>”
$orgName=“<contoso>”
$userCredential = Get-Credential -UserName $adminUPN -Message "Enter your password."
Connect-SPOService -Url https://$orgName-admin.sharepoint.com -Credential $userCredential
Set-spotenant –DisableCustomAppAuthentication $false

Observação

Se você estiver usando o PowerShell 7, use este comando primeiro Import-Module microsoft.online.sharepoint.powershell -UseWindowsPowerShell

Observação

Se você estiver usando a autenticação multifator, use Connect-SPOService -Url https://$orgName-admin.sharepoint.com.

Concluir a configuração do aplicativo

  1. Saiba mais em https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appinv.aspx.
  2. No campo ID do aplicativo, cole a ID do cliente do aplicativo do SharePoint e selecione Pesquisa.
  3. No campo XML da Solicitação de Permissão, cole esse código e selecione Criar.
<AppPermissionRequests AllowAppOnlyPolicy="true">
    <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read" />
</AppPermissionRequests>
  1. Selecione o botão Confiar.

Criar uma conta de armazenamento do ADLS

Para obter diretrizes passo a passo, consulte Criar uma conta de armazenamento. Para permitir recursos de armazenamento de arquivos, na guia Avançado, selecione Habilitar namespace hierárquico e Criar um contêiner para este site.

Ao configurar o conector CSV, você precisará fornecer um cadeia de conexão de armazenamento primário. Para encontrá-lo, abra a conta de armazenamento que você criou e selecione Chaves de Acesso. Selecione Mostrar Chaves e copie o cadeia de conexão para Key1.

Etapa 1: Adicionar um conector do Graph no Centro de administração do Microsoft 365

Adicionar conector CSV

Siga as instruções de configuração geral.

Etapa 2: selecionar experiências

Atualmente, o conector CSV dá suporte apenas a experiências de pesquisa.

Conector CSV com a experiência de Pesquisa da Microsoft selecionada.

Etapa 3: nomear a conexão

Siga as instruções de configuração geral.

Etapa 4: configurar configurações de conexão

As configurações de fonte de dados são diferentes para SharePoint e ADLS.

Observação

Verifique se o arquivo csv não tem nenhuma formatação ou espaços (' ') presentes em linhas de cabeçalho.

Para uma fonte do SharePoint

  1. Nas configurações da Fonte de Dados, selecione SharePoint como sua fonte de dados.
  2. No site do SharePoint, insira a URL do site, https://Org-Name.sharepoint.com/Site-Name, por exemplo.
  3. Na Biblioteca de Documentos, insira o nome da biblioteca em que os arquivos .csv são armazenados.
  4. Em Tipo de Autenticação, selecione Oauth2.0(credenciais do cliente).
  5. Insira a ID do Cliente e o Segredo do Cliente copiados quando você criou o aplicativo do SharePoint.
  6. Selecione Testar Conexão. Você deve obter uma mensagem A conexão é bem-sucedida .

Conector CSV com Configurações de Fonte de Dados para um site do SharePoint.

Para controlar o acesso em um nível de arquivo, insira Microsoft Entra usuários ou grupos.

Lista de controle de acesso com usuário e grupo incluídos.

Para uma fonte do ADLS

  1. Nas configurações da Fonte de Dados, selecione Azure Data Lake Storage(ADLS) como sua fonte de dados.
  2. No cadeia de conexão de armazenamento primário, insira o cadeia de conexão copiado.
  3. Insira o nome do contêiner e o nome do arquivo.
  4. Selecione Testar Conexão. Você deve obter uma mensagem A conexão é bem-sucedida .

Conector CSV com Configurações de Fonte de Dados para uma fonte de Azure Data Lake Storage.

Observação

Se a fonte de dados contiver vários arquivos .csv com os mesmos cabeçalhos, selecione incluir todos os arquivos CSV no local.

Para controlar o acesso em um nível de arquivo, insira Microsoft Entra usuários ou grupos.

Lista de controle de acesso com usuário e grupo incluídos.

Etapa 5: Delimitador de vários itens (opcional)

Se suas colunas de origem puderem ter vários valores, insira um delimitador de vários itens, um ponto e vírgula (;) por exemplo.

Etapa 6: Configurações de propriedades analisadas

Esta página retorna a primeira linha do arquivo .csv como Propriedades de Origem. Para modificar o Datatype, na lista Identificador Exclusivo , selecione pelo menos uma opção.

Para controlar o acesso em um nível de item, selecione colunas mapeadas para Usuários Permitidos e Grupos Permitidos. Você deve incluir duas colunas, AllowedUsers e AllowedGroups, no arquivo .csv. Cada linha deve conter as IDs Microsoft Entra.

Configurações de controle de acesso no nível do item.

Observação

O conector CSV dá suporte ao controle de acesso em nível de arquivo ou item. Se ambos estiverem habilitados, somente o controle de acesso no nível do arquivo será aplicado.

Etapa 7: Atribuir rótulos de propriedade

Siga as instruções de configuração geral.

Observação

O rótulo IconURL é preenchido por padrão e o mapeamento não pode ser alterado.

Etapa 8: Gerenciar esquema

Siga as instruções de configuração geral.

Etapa 9: Gerenciar permissões de pesquisa

  • Para controle de acesso em nível de arquivo ou item, selecione Somente pessoas com acesso a essa fonte de dados.
  • Selecionar Todos permite que todos em sua organização vejam os resultados da pesquisa desta fonte de dados.

Configurações de permissão de pesquisa com apenas pessoas com acesso a essa fonte de dados selecionadas.

Etapa 10: escolher configurações de atualização

Siga as instruções de configuração geral.

Etapa 11: Revisar conexão

Siga as instruções de configuração geral.

Limitações

Veja a seguir as limitações conhecidas do conector CSV:

  • Não há suporte para cenários de enriquecimento de perfil no momento.