Criar uma conexão com o SharePoint

info

Beta

Este recurso está em Beta. Os administradores do espaço de trabalho podem controlar o acesso a esse recurso na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.

Crie uma conexão do Microsoft SharePoint no Catalog Explorer para armazenar credenciais de autenticação para a ingestão do LakeFlow Connect. Qualquer usuário com o privilégio USE CONNECTION na conexão pode, então, criar pipelines de ingestão do SharePoint sem precisar de acesso direto às credenciais.

Alternativamente, usuários administradores podem criar uma conexão e um pipeline ao mesmo tempo na interface de usuário de ingestão de dados. Veja Criar um pipeline de ingestão.

Para requisitos de privilégio, consulte Conectar-se a fontes de ingestão gerenciadas.

Os seguintes métodos de autenticação são suportados:

• M2M OAuth (recomendado)
• U2M OAuth
• OAuth com refresh manual de tokens

Na maioria dos cenários, a Databricks recomenda OAuth machine-to-machine (M2M). Permissões do conector de escopos M2M para um site específico. No entanto, se desejar restringir as permissões ao que o usuário autenticador pode acessar, opte, em vez disso, pelo OAuth user-to-machine (U2M). Ambos os métodos oferecem refresh automático de tokens e segurança reforçada.

Pré-requisitos

Conclua a configuração de origem que corresponda ao método de autenticação escolhido. Utilize os detalhes de autenticação obtidos para criar a conexão.

Criar uma conexão

M2M

1. Conclua a configuração de origem M2M. Você usará os detalhes de autenticação que obtiver para criar a conexão.

2. No workspace do Databricks, clique em Catálogo > Criar > Criar uma conexão.

3. Na página Noções básicas de conexão do assistente Configurar conexão , especifique um Nome da conexão exclusivo.

4. No menu suspenso Tipo de conexão , selecione Microsoft SharePoint .

5. No menu suspenso Tipo de autenticação , selecione OAuth máquina para máquina .

6. (Opcional) Adicione um comentário.

7. Clique em Avançar .

8. Na página **Autenticação**, insira as seguintes credenciais para seu aplicativo Microsoft Entra ID:

   • Segredo do cliente : o segredo do cliente que você recuperou na configuração de origem.
   • ID do cliente : o ID do cliente recuperado na configuração de origem.
   • Domínio: O URL da instância do SharePoint no seguinte formato: https://MYINSTANCE.sharepoint.com
   • ID do tenant : o ID do tenant obtido na configuração de origem.

9. Clique em **Entrar com o Microsoft SharePoint**.

   Uma nova janela abre. Após o login com suas credenciais do SharePoint, as permissões concedidas ao aplicativo do Entra ID são mostradas.

10. Clique em Aceitar .

    Uma mensagem de **Autorizado com sucesso** é exibida, e você é redirecionado para o workspace do Databricks.

11. Clique em Criar conexão .

U2M

1. Conclua a configuração de origem U2M. Você usará os detalhes de autenticação que obtiver para criar a conexão.

2. No workspace do Databricks, clique em Catálogo > Criar > Criar uma conexão.

3. Na página Noções básicas de conexão do assistente Configurar conexão , especifique um Nome da conexão exclusivo.

4. No menu suspenso Tipo de conexão , selecione Microsoft SharePoint .

5. No menu suspenso Tipo de autenticação , selecione OAuth .

6. (Opcional) Adicione um comentário.

7. Clique em Avançar .

8. Na página **Autenticação**, insira as seguintes credenciais para seu aplicativo Microsoft Entra ID:

   • Segredo do cliente : o segredo do cliente que você recuperou na configuração de origem.
   • ID do cliente : o ID do cliente recuperado na configuração de origem.
   • Domínio: O URL da instância do SharePoint no seguinte formato: https://MYINSTANCE.sharepoint.com
   • ID do tenant : o ID do tenant obtido na configuração de origem.

   

9. Clique em **Entrar com o Microsoft SharePoint**.

   Uma nova janela abre. Após o login com suas credenciais do SharePoint, as permissões concedidas ao aplicativo do Entra ID são mostradas.

10. Clique em Aceitar .

    Uma mensagem de **Autorizado com sucesso** é exibida, e você é redirecionado para o workspace do Databricks.

11. Clique em Criar conexão .

Manual refresh token

1. Conclua a configuração da fonte para refresh de token manual. Você usará os detalhes de autenticação que obtiver para criar a conexão.

2. No workspace do Databricks, clique em Catálogo > Criar > Criar uma conexão.

3. Na página Noções básicas de conexão do assistente Configurar conexão , especifique um Nome da conexão exclusivo.

4. No menu suspenso Tipo de conexão , selecione Microsoft SharePoint .

5. No menu suspenso **Tipo de autenticação**, selecione **Token de refresh OAuth**.

6. (Opcional) Adicione um comentário.

7. Clique em Avançar .

8. Na página **Autenticação**, insira as seguintes credenciais para seu aplicativo Microsoft Entra ID:

   • ID do tenant : o ID do tenant obtido na configuração de origem.
   • ID do cliente : o ID do cliente recuperado na configuração de origem.
   • Segredo do cliente : o segredo do cliente que você recuperou na configuração de origem.
   • Token de atualização : O token de atualização que foi recuperado na configuração de origem.

   

9. Clique em Criar conexão .

Passos seguintes

Criar pipeline de ingestão.