connections grupo de comando

Note

O uso da CLI do Databricks está sujeito à Licença do Databricks e ao Aviso de Privacidade do Databricks, incluindo quaisquer disposições de Dados de Uso.

O connections grupo de comandos dentro da CLI Databricks permite-lhe criar e gerir ligações a fontes de dados externas. Consulte Conectar-se a fontes de dados e serviços externos.

Este grupo de comando cobre dois tipos de ligações:

  • Ligações à Federação Lakehouse: Ligações a bases de dados externas para consultas federadas. Consulte Gerenciar conexões para a Lakehouse Federation.
  • Ligações de ingestão gerida (Lakeflow Connect): Ligações a aplicações SaaS e bases de dados para pipelines de ingestão geridos. Suportado para conectores que usam autenticação apenas por API. Ver Desdobramento.

Criar conexões no Databricks

Crie uma nova conexão com uma fonte de dados externa. Ele permite que os usuários especifiquem detalhes de conexão e configurações para interação com o servidor externo.

databricks connections create [flags]

Opções

--comment string

    Descrição de texto de forma livre fornecida pelo usuário.

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação

--read-only

    Se a conexão for somente leitura.

Bandeiras globais

Examples

O exemplo a seguir cria uma conexão com um comentário:

databricks connections create --comment "Connection to external database"

O exemplo a seguir cria uma ligação de apenas leitura:

databricks connections create --read-only

Para especificar o tipo de ligação e as credenciais, passe um corpo do pedido com --json. O corpo JSON segue o mesmo esquema da API Connections REST. O exemplo seguinte cria uma ligação de ingestão gerida para uma fonte PostgreSQL:

databricks connections create --json '{
  "name": "my-connection",
  "connection_type": "POSTGRESQL",
  "options": {
    "host": "postgresql-instance.example.com",
    "port": "5432",
    "user": "databricks_replication",
    "password": "your_secure_password"
  }
}'

Excluir Conexões Databricks

Exclua a conexão que corresponde ao nome fornecido.

databricks connections delete NAME [flags]

Arguments

NAME

    O nome da conexão a ser eliminada.

Opções

Bandeiras globais

Examples

O exemplo a seguir exclui uma conexão chamada my-connection:

databricks connections delete my-connection

obter conexões do Databricks

Obtenha uma ligação através do seu nome.

databricks connections get NAME [flags]

Arguments

NAME

    Nome da conexão.

Opções

Bandeiras globais

Examples

O exemplo a seguir obtém informações sobre uma conexão chamada my-connection:

databricks connections get my-connection

Lista de Conexões do Databricks

Liste todas as conexões.

databricks connections list [flags]

Opções

--max-results int

    Número máximo de conexões a serem retornadas.

--page-token string

    Token de paginação opaco para avançar para a próxima página com base na consulta anterior.

Bandeiras globais

Examples

O exemplo a seguir lista todas as conexões:

databricks connections list

O exemplo a seguir lista conexões com um máximo de 10 resultados:

databricks connections list --max-results 10

Atualização das conexões do Databricks

Atualize a conexão que corresponde ao nome fornecido.

databricks connections update NAME [flags]

Arguments

NAME

    Nome da conexão.

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação

--new-name string

    Novo nome para a conexão.

--owner string

    Nome de usuário do proprietário atual da conexão.

Bandeiras globais

Examples

O exemplo a seguir renomeia uma conexão:

databricks connections update my-connection --new-name my-renamed-connection

O exemplo a seguir altera o proprietário de uma conexão:

databricks connections update my-connection --owner someone@example.com

Bandeiras globais

--debug

  Se o log de depuração deve ser habilitado.

-h ou --help

    Exiba a ajuda para a CLI do Databricks ou para o grupo de comandos relacionado ou para o comando relacionado.

--log-file String

    Uma cadeia de caracteres que representa o ficheiro onde os registos de saída são gravados. Se esse sinalizador não for especificado, o padrão é gravar logs de saída no stderr.

--log-format Formato

    O tipo de formato de log, text ou json. O valor predefinido é text.

--log-level String

    Uma cadeia de caracteres que representa o nível de formato de log. Se não for especificado, o nível de formato de log será desativado.

-o, --output tipo

    O tipo de saída do comando, text ou json. O valor predefinido é text.

-p, --profile String

    O nome do perfil no arquivo ~/.databrickscfg a ser usado para executar o comando. Se esse sinalizador não for especificado, se ele existir, o perfil nomeado DEFAULT será usado.

--progress-format Formato

    O formato para exibir logs de progresso: default, append, inplace, ou json

-t, --target String

    Se aplicável, o destino do pacote a ser usado