Pular para o conteúdo principal

database grupo de comando

nota

Databricks CLI O uso está sujeito à LicençaDatabricks e à Política de PrivacidadeDatabricks, incluindo qualquer disposição sobre Dados de Uso.

O grupo de comandos database dentro do Databricks CLI contém comandos para gerenciar instâncias de banco de dados. As instâncias de banco de dados gerenciam o armazenamento e o recurso de e compute, além de fornecerem o ponto de conexão para os usuários.

Veja provisionamentoLakebase.

banco de dados databricks create-database-catalog​

Crie um catálogo de banco de dados.

databricks database create-database-catalog NAME DATABASE_INSTANCE_NAME DATABASE_NAME [flags]

Argumentos​

NAME

O nome do catálogo no Unity Catalog.

DATABASE_INSTANCE_NAME

O nome da instância de banco de dados que abriga o banco de dados.

DATABASE_NAME

O nome do banco de dados (em uma instância) associado ao catálogo.

Opções​

--create-database-if-not-exists

Crie o banco de dados se ele não existir.

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição. Para obter informações sobre JSON, consulte o Catálogo do Banco de Dados.

Bandeiras globais

Exemplos​

O exemplo a seguir cria um catálogo de banco de dados:

Bash
databricks database create-database-catalog my-catalog my-instance my-database

banco de dados databricks create-database-instance​

Crie uma instância de banco de dados.

nota

Para definir campos aninhados que não estão disponíveis como argumentos, use a opção --json para especificar o corpo completo da solicitação.

databricks database create-database-instance NAME [flags]

Argumentos​

NAME

O nome da instância. Esse é o identificador exclusivo da instância.

Opções​

--capacity string

O SKU de capacidade da instância. Os valores válidos são: CU_1, CU_2, CU_4, CU_8.

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição. Para obter uma referência em JSON, consulte Instância de banco de dados.

--stopped

Se a instância foi interrompida.

Bandeiras globais

Exemplos​

O exemplo a seguir cria uma instância de banco de dados:

Bash
databricks database create-database-instance my-instance --capacity CU_1

banco de dados databricks create-database-table​

Crie uma tabela de banco de dados.

databricks database create-database-table NAME [flags]

Argumentos​

NAME

Nome completo da tabela em três partes (catálogo, esquema, tabela).

Opções​

--database-instance-name string

Nome da instância do banco de dados de destino.

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição. Para obter uma referência em JSON, consulte a tabela do banco de dados.

--logical-database-name string

Nome do objeto de banco de dados Postgres de destino (banco de dados lógico) para esta tabela.

Bandeiras globais

Exemplos​

O exemplo a seguir cria uma tabela de banco de dados:

Bash
databricks database create-database-table my-catalog.my-schema.my-table --database-instance-name my-instance --logical-database-name dbname

banco de dados databricks criar tabela de banco de dados sincronizada​

Crie uma tabela de banco de dados sincronizada.

nota

Para definir campos aninhados que não estão disponíveis como argumentos, use a opção --json para especificar o corpo completo da solicitação.

databricks database create-synced-database-table NAME [flags]

Argumentos​

NAME

Nome completo da tabela em três partes (catálogo, esquema, tabela).

Opções​

--database-instance-name string

Nome da instância do banco de dados de destino.

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição. Para obter informações sobre o formato JSON, consulte a tabela de banco de dados sincronizado.

--logical-database-name string

Nome do objeto de banco de dados Postgres de destino (banco de dados lógico) para esta tabela.

Bandeiras globais

Exemplos​

O exemplo a seguir cria uma tabela de banco de dados sincronizada:

Bash
databricks database create-synced-database-table --json '{"name": "main.my-schema.my-table", "database_instance_name": "my-instance", "logical_database_name": "testdb", "spec": {"primary_key_columns": ["col1"], "existing_pipeline_id": "999999z9-dz9b-4zf7-c178-15b777772e6z", "scheduling_policy": "SNAPSHOT", "source_table_full_name": "main.my-instance.t"}}'

banco de dados databricks delete-database-catalog​

Excluir um catálogo de banco de dados.

databricks database delete-database-catalog NAME [flags]

Argumentos​

NAME

O nome do catálogo a ser excluído.

Opções​

Bandeiras globais

Exemplos​

O exemplo a seguir exclui um catálogo de banco de dados:

Bash
databricks database delete-database-catalog my-catalog

banco de dados databricks delete-database-instance​

Exclua uma instância do banco de dados.

databricks database delete-database-instance NAME [flags]

Argumentos​

NAME

Nome da instância a ser excluída.

Opções​

--force

Por default, uma instância não pode ser excluída se tiver instâncias descendentes criadas por meio do PITR.

--purge

Observe que purge=false está em desenvolvimento.

Bandeiras globais

Exemplos​

O exemplo a seguir exclui uma instância de banco de dados:

Bash
databricks database delete-database-instance my-instance --force

banco de dados databricks delete-database-table​

Exclua uma tabela do banco de dados.

databricks database delete-database-table NAME [flags]

Argumentos​

NAME

Nome completo de três partes (catálogo, esquema, tabela) da tabela a ser excluída.

Opções​

Bandeiras globais

Exemplos​

O exemplo a seguir exclui uma tabela de banco de dados:

Bash
databricks database delete-database-table catalog.schema.table

banco de dados databricks excluir tabela de banco de dados sincronizada​

Exclua uma tabela de banco de dados sincronizada.

databricks database delete-synced-database-table NAME [flags]

Argumentos​

NAME

Nome completo de três partes (catálogo, esquema, tabela) da tabela sincronizada a ser excluída.

Opções​

Bandeiras globais

Exemplos​

O exemplo a seguir exclui uma tabela de banco de dados sincronizada:

Bash
databricks database delete-synced-database-table catalog.schema.table

banco de dados databricks localiza-banco de dados instância-por-uid​

Encontre uma instância de banco de dados por uid.

databricks database find-database-instance-by-uid [flags]

Opções​

--uid string

UID do agrupamento a ser obtido.

Bandeiras globais

Exemplos​

O exemplo a seguir localiza uma instância de banco de dados por UID:

Bash
databricks database find-database-instance-by-uid --uid 12345-abcdef-67890

banco de dados databricks generate-database-credencial​

Gera uma credencial que pode ser usada para acessar instâncias do banco de dados.

databricks database generate-database-credential [flags]

Opções​

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

--request-id string

ID de solicitação para a geração da credencial.

Bandeiras globais

Exemplos​

O exemplo a seguir gera uma credencial de banco de dados:

Bash
databricks database generate-database-credential --request-id my-request-123

banco de dados databricks get-database-catalog​

Obtenha um catálogo de banco de dados.

databricks database get-database-catalog NAME [flags]

Argumentos​

NAME

O nome do catálogo a ser obtido.

Opções​

Bandeiras globais

Exemplos​

O exemplo a seguir obtém informações sobre um catálogo de banco de dados:

Bash
databricks database get-database-catalog my-catalog

banco de dados databricks get-database-instance​

Obtenha uma instância de banco de dados.

databricks database get-database-instance NAME [flags]

Argumentos​

NAME

Nome do agrupamento a ser obtido.

Opções​

Bandeiras globais

Exemplos​

O exemplo a seguir obtém informações sobre uma instância de banco de dados:

Bash
databricks database get-database-instance my-instance

banco de dados databricks get-database-table​

Obtenha uma tabela de banco de dados.

databricks database get-database-table NAME [flags]

Argumentos​

NAME

Nome completo de três partes (catálogo, esquema, tabela) da tabela a ser obtida.

Opções​

Bandeiras globais

Exemplos​

O exemplo a seguir obtém informações sobre uma tabela do banco de dados:

Bash
databricks database get-database-table catalog.schema.table

banco de dados databricks get-synced-database-table​

Obtenha uma tabela de banco de dados sincronizada.

databricks database get-synced-database-table NAME [flags]

Argumentos​

NAME

Nome completo de três partes (catálogo, esquema, tabela) da tabela sincronizada a ser obtida.

Opções​

Bandeiras globais

Exemplos​

O exemplo a seguir obtém informações sobre uma tabela de banco de dados sincronizada:

Bash
databricks database get-synced-database-table catalog.schema.table

lista de banco de dados databricks - instâncias de banco de dados​

Listar instâncias do banco de dados.

databricks database list-database-instances [flags]

Opções​

--page-size int

Limite superior para itens devolvidos.

--page-token string

Tokens de paginação para avançar para a próxima página das instâncias do banco de dados.

Bandeiras globais

Exemplos​

O exemplo a seguir lista todas as instâncias do banco de dados:

Bash
databricks database list-database-instances

O exemplo a seguir lista instâncias de banco de dados com paginação:

Bash
databricks database list-database-instances --page-size 10

atualização do banco de dados databricks - instância do banco de dados​

Atualize uma instância de banco de dados.

databricks database update-database-instance NAME UPDATE_MASK [flags]

Argumentos​

NAME

O nome da instância. Esse é o identificador exclusivo da instância.

UPDATE_MASK

Uma máscara que especifica quais campos devem ser atualizados. Use * para atualizar todos os campos especificados.

Opções​

--capacity string

O SKU da instância.

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

--stopped

Se a instância foi interrompida.

Bandeiras globais

Exemplos​

O exemplo a seguir atualiza a capacidade de uma instância de banco de dados:

Bash
databricks database update-database-instance my-instance '*' --capacity CU_4

O exemplo a seguir interrompe uma instância de banco de dados:

Bash
databricks database update-database-instance my-instance '*' --stopped

Bandeiras globais​

--debug

Se deve habilitar o registro de depuração.

-h ou --help

Exibir ajuda para o comando Databricks CLI ou para o grupo de comandos relacionado ou para o comando relacionado.

--log-file string

Uma string que representa o arquivo no qual a saída logs deve ser gravada. Se este sinalizador não for especificado, o default deverá gravar a saída logs no stderr.

--log-format Formato

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

--log-level string

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

-o, --output Tipo

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

-p, --profile string

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

--progress-format Formato

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

-t, --target string

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