Pular para o conteúdo principal

database grupo de comando

nota

Esta informação se aplica a Databricks CLI versões 0.205 e acima. A CLI do Databricks está em pré-visualização pública.

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.

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 [flags]

Argumentos

NAME

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

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 large

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