Compartilhar via


Azure Data Lake Storage Gen2 conector do Microsoft Graph

O conector Azure Data Lake Storage Gen2 Microsoft Graph permite que os utilizadores na sua organização procurem ficheiros armazenados em contas de Armazenamento do Armazenamento de Blobs do Azure e do Azure Data Lake Gen2.

Observação

Leia o artigo Configurar o conector do Microsoft Graph para compreender as instruções gerais de configuração dos conectores.

Este artigo destina-se a qualquer pessoa que configure, execute e monitorize um conector Azure Data Lake Storage Gen2. Complementa o processo de configuração geral e mostra instruções que se aplicam apenas ao conector Azure Data Lake Storage Gen2. Este artigo também inclui informações sobre Limitações.

No artigo, utilizamos o Armazenamento do Azure como um termo genérico para Armazenamento de Blobs do Azure e o Armazenamento do Azure Data Lake Gen2.

Passo 1: adicionar um conector no Centro de administração do Microsoft 365

Adicionar conector Azure Data Lake Storage Gen2

(Veja as instruções gerais de configuração para obter mais detalhes)

Passo 2: atribuir um nome à ligação

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

Passo 3: Configurar as definições de ligação

Introduza o seu cadeia de conexão de armazenamento principal. Esta cadeia de carateres é necessária para permitir o acesso à sua conta de armazenamento. Para localizar a sua cadeia de conexão, aceda à portal do Azure e navegue para a secção Chaves da sua conta de Armazenamento do Azure relevante.

Se preferir não fornecer a AccountKey (um parâmetro na cadeia de conexão de armazenamento principal), conceda acesso ao serviço de conectores do Microsoft Graph para as seguintes funções:

  • Leitor de Dados do Blob de Armazenamento
  • Contribuidor de Dados da Fila de Armazenamento
  • Delegador de Blobs de Armazenamento

Navegue para o separador Controle de Acesso da sua conta de Armazenamento do Azure e siga as instruções para conceder acesso à seguinte aplicação:

  • ID da Aplicação Original: 56c1da01-2129-48f7-9355-af6d59d42766
  • Nome da Aplicação Original: Graph Connector Service

Notificações da conta de armazenamento e da fila (Opcional)

O suporte para processar alterações em tempo real no Graph Connectors Service poderá ser adicionado no futuro. Nesse caso, vamos monitorizar as notificações de alteração do Armazenamento do Microsoft Azure armazenadas numa fila. Terá de criar uma fila na mesma conta que a sua conta de Armazenamento do Azure.

Depois de criar uma fila, aceda ao separador Eventos na página da fila para configurar a Subscrição de Eventos. Escolha todos os eventos de Blob que a fila irá receber e ligue a fila à conta de Armazenamento do Azure.

Testar a conexão

Teste a ligação ao clicar no botão Testar Ligação

Observação

A Ligação de Teste tem de ter êxito antes de poder passar para a próxima secção de configuração. A conta de armazenamento ativada do ADLS gen2 tem de ter um Contentor E , pelo menos, um ficheiro no mesmo como mínimo para que a Ligação de Teste tenha êxito. Será gerado um erro de ligação se o conteúdo não existir.

Passo 4: Atribuir etiquetas de propriedade

Pode atribuir uma propriedade de origem a cada etiqueta ao escolher a partir de um menu de opções. Embora este passo não seja obrigatório, ter algumas etiquetas de propriedade irá melhorar a relevância da pesquisa e garantir melhores resultados de pesquisa para os utilizadores finais.

Passo 5: Gerir o esquema

No ecrã Gerir Esquema , pode alterar os atributos de esquema associados às propriedades, as opções são Consulta, Procurar, Obter e Refinar. Também pode adicionar aliases opcionais e escolher a propriedade Conteúdo .

Passo 6: Gerir permissões de pesquisa

Azure Data Lake Gen2

Pode optar por ingerir o Controle de Acesso Listas (ACLs) da sua conta de Armazenamento do Azure Data Lake Gen2. Quando estas permissões de pesquisa são definidas, o conteúdo da pesquisa é cortado com base nas permissões do utilizador com sessão iniciada Microsoft Entra ID. Em alternativa, pode optar por tornar todos os conteúdos indexados da sua conta de armazenamento visíveis para todas as pessoas na sua organização. Neste caso, todas as pessoas na sua organização terão acesso a todos os dados na sua conta de armazenamento.

O conector Azure Data Lake Storage Gen2 suporta permissões de pesquisa visíveis para Todos ou Apenas pessoas com acesso a esta origem de dados. Os dados indexados que aparecem nos resultados da pesquisa podem ser visíveis para os utilizadores na organização que têm acesso a cada item.

Azure Storage Blob

Para uma ligação ao Armazenamento de Blobs do Azure, todos os conteúdos indexados a partir da origem configurada são visíveis para todas as pessoas na sua organização. As listas de controlo de acesso não são suportadas ao nível do Blob no Armazenamento de Blobs do Azure.

Passo 7: Definir a agenda de atualização

No ecrã Definições de Atualização , pode definir o intervalo de pesquisa incremental e o intervalo de pesquisa completo. Os intervalos predefinidos para o conector Azure Data Lake Storage Gen2 são de 15 minutos para uma pesquisa incremental e uma semana para uma pesquisa completa.

Passo 8: rever a ligação

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

Limitações

Uma ligação publicada para Armazenamento de Blobs do Azure não pode ser reconfigurada para Azure Data Lake Storage Gen2 origem e para o contrário. Nestes cenários, é recomendado configurar uma nova ligação.

Além disso, o tamanho dos ficheiros tem de ser de 4 MB ou menos para que seja pesquisado. Os tipos de ficheiro atualmente suportados são:

  • Word (docx, .docm, .dotx, .dotm)
  • PowerPoint (.pptm, .pptx, .potm, .potx, .ppam, .ppsm, .ppsx)
  • Excel (.xlsx, .xlsm)
  • Formatos legados do Office (.doc, .dot, etc.)
  • Texto (.txt)
  • HTML
  • PDF

Os ficheiros binários como imagens (.jpg, .bmp, etc.) não são suportados. Por exemplo, se um ficheiro .docx contiver apenas imagens, poderá ser ignorado porque não devolveu qualquer conteúdo.

Solução de problemas

Depois de publicar a ligação, pode rever a status no separador Origens de Dados no centro de administração. Para saber como fazer atualizações e eliminações, consulte Gerir o conector.

Se tiver outros problemas ou quiser fornecer comentários, contacte-nos no Microsoft Graph | Suporte