Compartilhar via


Grupo de comandos database

Observação

Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Visualização Pública.

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

O database grupo de comandos dentro da CLI do Databricks contém comandos para gerenciar instâncias de banco de dados. As instâncias de banco de dados gerenciam recursos de armazenamento e computação e fornecem os pontos de extremidade aos quais os usuários se conectam.

Veja o que é uma instância de banco de dados?.

banco de dados databricks criar-catalogo-de-banco-de-dados

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 Catálogo do Unity.

DATABASE_INSTANCE_NAME

    O nome do DatabaseInstance 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

    A cadeia de caracteres JSON inserida em linha ou o arquivo JSON @path com o corpo da solicitação. Para referência de JSON, consulte Catálogo de Banco de Dados.

Sinalizadores globais

Exemplos

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

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

databricks banco de dados criar-instância-de-database

Crie uma instância de banco de dados.

Observação

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

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

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o arquivo JSON @path com o corpo da solicitação. Para referência JSON, consulte Instância de Banco de Dados.

--stopped

    Se a instância foi interrompida.

Sinalizadores globais

Exemplos

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

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

banco de dados do databricks create-database-table

Crie uma tabela de banco de dados.

databricks database create-database-table NAME [flags]

Argumentos

NAME

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

Opções

--database-instance-name string

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

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o arquivo JSON @path com o corpo da solicitação. Para referência JSON, consulte Tabela de 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.

Sinalizadores globais

Exemplos

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

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

banco de dados databricks create-synced-database-table

Crie uma tabela de banco de dados sincronizada.

Observação

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 de três partes (catálogo, esquema, tabela) da tabela.

Opções

--database-instance-name string

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

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o arquivo JSON @path com o corpo da solicitação. Para referência de JSON, consulte a Tabela de Banco de Dados Sincronizada.

--logical-database-name string

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

Sinalizadores globais

Exemplos

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

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"}}'

databricks banco de dados 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

Sinalizadores globais

Exemplos

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

databricks database delete-database-catalog my-catalog

banco de dados do databricks excluir-instância-do-banco-de-dados

Exclua uma instância de banco de dados.

databricks database delete-database-instance NAME [flags]

Argumentos

NAME

    Nome da instância a ser excluída.

Opções

--force

    Por padrão, uma instância não poderá ser excluída se tiver instâncias descendentes criadas via PITR.

--purge

    Observe que purge=false está em desenvolvimento.

Sinalizadores globais

Exemplos

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

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

banco de dados databricks delete-database-table

Excluir uma tabela de 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

Sinalizadores globais

Exemplos

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

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

banco-de-dados databricks excluir-tabela-de-dados-sincronizados

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

Sinalizadores globais

Exemplos

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

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

databricks banco de dados encontrar-instância-de-banco-de-dados-por-uid

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

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

Opções

--uid string

    UID do cluster a ser obtido.

Sinalizadores globais

Exemplos

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

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

databricks banco de dados gerar-credencial-do-banco-de-dados

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

databricks database generate-database-credential [flags]

Opções

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o arquivo JSON @path com o corpo da solicitação.

--request-id string

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

Sinalizadores globais

Exemplos

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

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

Comando de Databricks para obter o catálogo de banco de dados

Obter 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

Sinalizadores globais

Exemplos

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

databricks database get-database-catalog my-catalog

Comando: databricks database get-database-instance

Obtenha uma instância de banco de dados.

databricks database get-database-instance NAME [flags]

Argumentos

NAME

    Nome do cluster a ser obtido.

Opções

Sinalizadores globais

Exemplos

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

databricks database get-database-instance my-instance

databricks banco de dados get-database-table

Obter 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 obtido.

Opções

Sinalizadores globais

Exemplos

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

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

O comando "databricks database get-synced-database-table" é usado para acessar tabelas sincronizadas no banco de dados do Databricks.

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 obtido.

Opções

Sinalizadores globais

Exemplos

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

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

banco de dados databricks list-database-instances

Listar instâncias de banco de dados.

databricks database list-database-instances [flags]

Opções

--page-size int

    Limite superior para itens retornados.

--page-token string

    Token de paginação para ir para a próxima página de instâncias de banco de dados.

Sinalizadores globais

Exemplos

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

databricks database list-database-instances

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

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

databricks banco de dados atualizar-instância-de-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

    A cadeia de caracteres JSON inserida em linha ou o arquivo JSON @path com o corpo da solicitação.

--stopped

    Se a instância foi interrompida.

Sinalizadores globais

Exemplos

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

databricks database update-database-instance my-instance --capacity large

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

databricks database update-database-instance my-instance --stopped

Sinalizadores globais

--debug

  Optar por habilitar o registro de log de depuração.

-h ou --help

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

--log-file corda

    Uma cadeia de caracteres que representa o arquivo onde serão gravados os logs de saída. Se esse sinalizador não for especificado, o padrão será gravar logs de saída no stderr.

--log-format formato

    O tipo de formato de log, text ou json. O valor padrão é text.

--log-level corda

    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á desabilitado.

-o, --output tipo

    O tipo de saída do comando, text ou json. O valor padrão é text.

-p, --profile corda

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

--progress-format formato

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

-t, --target corda

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