Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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.
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
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
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.
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.
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