Partilhar via


Conectar-se à predefinição

Preset fornece inteligência de negócios moderna para toda a sua organização. Preset fornece uma plataforma de exploração e visualização de dados poderosa e fácil de usar, alimentada por código aberto Apache Superset.

Você pode integrar seus armazéns SQL Databricks (anteriormente pontos de extremidade SQL Databricks) e clusters do Azure Databricks com Predefinição.

Conectar-se à predefinição usando o Partner Connect

Para conectar seu espaço de trabalho do Azure Databricks à Predefinição usando o Partner Connect, consulte Conectar-se a parceiros de BI usando o Partner Connect.

Nota

O Partner Connect suporta apenas armazéns SQL Databricks para Predefinição. Para conectar um cluster em seu espaço de trabalho do Azure Databricks à Predefinição, conecte-se à Predefinição manualmente.

Conectar-se à predefinição manualmente

Nesta seção, você conecta um SQL warehouse ou cluster existente em seu espaço de trabalho do Azure Databricks à Predefinição.

Nota

Para armazéns SQL, você pode usar o Partner Connect para simplificar o processo de conexão.

Requerimentos

Antes de integrar com a predefinição manualmente, você deve ter o seguinte:

  • Um cluster ou armazém SQL no seu espaço de trabalho do Azure Databricks.

  • Os detalhes de conexão para seu cluster ou SQL warehouse, especificamente os valores Nome do host do servidor, Porta e Caminho HTTP.

  • Um token de acesso pessoal do Azure Databricks ou um token de ID do Microsoft Entra (anteriormente Azure Ative Directory). Para criar um token de acesso pessoal, faça o seguinte:

    1. No seu espaço de trabalho do Azure Databricks, clique no seu nome de utilizador do Azure Databricks na barra superior e, em seguida, selecione Definições na lista pendente.
    2. Clique em Desenvolvedor.
    3. Ao lado de Tokens de acesso, clique em Gerenciar.
    4. Clique em Gerar novo token.
    5. (Opcional) Insira um comentário que o ajude a identificar esse token no futuro e altere o tempo de vida padrão do token de 90 dias. Para criar um token sem tempo de vida (não recomendado), deixe a caixa Tempo de vida (dias) vazia (em branco).
    6. Clique em Generate (Gerar).
    7. Copie o token exibido para um local seguro e clique em Concluído.

    Nota

    Certifique-se de salvar o token copiado em um local seguro. Não partilhe o seu token copiado com outras pessoas. Se você perder o token copiado, não poderá regenerar exatamente o mesmo token. Em vez disso, você deve repetir esse procedimento para criar um novo token. Se você perder o token copiado ou acreditar que o token foi comprometido, o Databricks recomenda que você exclua imediatamente esse token do seu espaço de trabalho clicando no ícone da lixeira (Revogar) ao lado do token na página de tokens do Access.

    Se você não conseguir criar ou usar tokens em seu espaço de trabalho, isso pode ser porque o administrador do espaço de trabalho desabilitou tokens ou não lhe deu permissão para criar ou usar tokens. Consulte o administrador do espaço de trabalho ou o seguinte:

    Nota

    Como prática recomendada de segurança, quando você se autentica com ferramentas, sistemas, scripts e aplicativos automatizados, o Databricks recomenda que você use tokens de acesso pessoal pertencentes a entidades de serviço em vez de usuários do espaço de trabalho. Para criar tokens para entidades de serviço, consulte Gerenciar tokens para uma entidade de serviço.

Etapas para se conectar

Para se conectar à predefinição manualmente, faça o seguinte:

  1. Crie uma nova conta Predefinida ou inicie sessão na sua conta Predefinida existente.

  2. Clique em + Espaço de trabalho.

  3. Na caixa de diálogo Adicionar Novo Espaço de Trabalho, insira um nome para o espaço de trabalho, selecione a região do espaço de trabalho mais próxima de você e clique em Salvar.

  4. Abra o espaço de trabalho clicando no bloco do espaço de trabalho.

  5. Na barra de ferramentas, clique em Catálogos>de Bancos de Dados.

  6. Clique em + Banco de dados.

  7. Na caixa de diálogo Conectar um banco de dados, na lista Bancos de dados suportados, selecione uma das seguintes opções:

    • Para um SQL warehouse, selecione Databricks SQL Warehouse.
    • Para um cluster, selecione Databricks Interactive Cluster.
  8. Para SQLAlchemy URI, insira o seguinte valor:

    Para um armazém SQL:

    databricks+pyodbc://token:{access token}@{server hostname}:{port}/{database name}
    

    Para um cluster:

    databricks+pyhive://token:{access token}@{server hostname}:{port}/{database name}
    

    Substituir:

    • {access token} com o valor< do token de acesso pessoal do Azure Databricks!– ou o valor do token do Azure Ative Directory –> dos requisitos.
    • {server hostname} com o valor Server Hostname dos requisitos.
    • {port} com o valor da porta dos requisitos.
    • {database name} com o nome do banco de dados de destino em seu espaço de trabalho do Azure Databricks.

    Por exemplo, para um armazém SQL:

    databricks+pyodbc://token:dapi...@adb-1234567890123456.7.azuredatabricks.net:443/default
    

    Por exemplo, para um cluster:

    databricks+pyhive://token:dapi...@adb-1234567890123456.7.azuredatabricks.net:443/default
    
  9. Clique na guia Avançado e expanda Outro.

  10. Para Parâmetros do mecanismo, insira o seguinte valor:

    Para um armazém SQL:

    {"connect_args": {"http_path": "sql/1.0/warehouses/****", "driver_path": "/opt/simba/spark/lib/64/libsparkodbc_sb64.so"}}
    

    Para um cluster:

    {"connect_args": {"http_path": "sql/protocolv1/o/****"}}
    

    Substitua sql/protocolv1/o/**** pelo valor HTTP Path dos requisitos.

    Por exemplo, para um armazém SQL:

    {"connect_args": {"http_path": "sql/1.0/warehouses/ab12345cd678e901", "driver_path": "/opt/simba/spark/lib/64/libsparkodbc_sb64.so"}}
    

    Por exemplo, para um cluster:

    {"connect_args": {"http_path": "sql/protocolv1/o/1234567890123456/1234-567890-buyer123"}}
    
  11. Clique no separador Básico e, em seguida, clique em Testar Ligação.

    Nota

    Para solução de problemas de conexão, consulte Passo a passo de conexão de banco de dados para Databricks no site Predefinido.

  12. Depois que a conexão for bem-sucedida, clique em Conectar.

Próximos passos

Explore um ou mais dos seguintes recursos no site Preset: