tables
grupo de comando
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 tables
dentro do Databricks CLI contém comando para gerenciar tabelas no Unity Catalog. Uma tabela reside na terceira camada do namespace de três níveis do Unity Catalog. Ele contém linhas de dados.
tabelas do databricks excluir
Exclua uma tabela do catálogo principal e do esquema especificados. O chamador deve ser o proprietário do catálogo principal, ter o privilégio USE_CATALOG
no catálogo principal e ser o proprietário do esquema pai, ou ser o proprietário da tabela e ter o privilégio USE_CATALOG
no catálogo principal e o privilégio USE_SCHEMA
no esquema pai.
databricks tables delete FULL_NAME [flags]
Argumentos
FULL_NAME
Nome completo da tabela.
Opções
Exemplos
O exemplo a seguir exclui uma tabela:
databricks tables delete my_catalog.my_schema.my_table
existem tabelas de databricks
Veja se existe uma tabela no metastore para um catálogo e esquema específicos. O chamador deve atender a um dos seguintes requisitos:
- Seja um administrador da metastore
- Seja o proprietário do catálogo principal
- Seja o proprietário do esquema principal e tenha o privilégio
USE_CATALOG
no catálogo principal - Tenha o privilégio
USE_CATALOG
no catálogo principal e o privilégioUSE_SCHEMA
no esquema pai e seja o proprietário da tabela ou tenha o privilégioSELECT
na tabela. - Tenha o privilégio
BROWSE
no catálogo principal - Tenha o privilégio
BROWSE
no esquema principal.
databricks tables exists FULL_NAME [flags]
Argumentos
FULL_NAME
Nome completo da tabela.
Opções
Exemplos
O exemplo a seguir verifica se existe uma tabela:
databricks tables exists my_catalog.my_schema.my_table
tabelas de databricks obtêm
Obtenha uma tabela do metastore para um catálogo e esquema específicos. O chamador deve atender a um dos seguintes requisitos:
- Seja um administrador da metastore
- Seja o proprietário do catálogo principal
- Seja o proprietário do esquema principal e tenha o privilégio
USE_CATALOG
no catálogo principal - Tenha o privilégio
USE_CATALOG
no catálogo principal e o privilégioUSE_SCHEMA
no esquema pai e seja o proprietário da tabela ou tenha o privilégioSELECT
na tabela.
databricks tables get FULL_NAME [flags]
Argumentos
FULL_NAME
Nome completo da tabela.
Opções
--include-browse
Se deve incluir tabelas na resposta para as quais o diretor só pode acessar metadados seletivos.
--include-delta-metadata
Se os metadados delta devem ser incluídos na resposta.
--include-manifest-capabilities
Se deve incluir um manifesto contendo os recursos que a tabela tem.
Exemplos
O exemplo a seguir obtém informações sobre uma tabela:
databricks tables get my_catalog.my_schema.my_table
O exemplo a seguir mostra uma tabela com metadados delta incluídos:
databricks tables get my_catalog.my_schema.my_table --include-delta-metadata
lista de tabelas do databricks
Liste todas as tabelas do metastore atual no catálogo e no esquema principais. O chamador deve ser administrador da metastore ou proprietário (ou ter o privilégio SELECT
) da tabela. No último caso, o chamador também deve ser o proprietário ou ter o privilégio USE_CATALOG
no catálogo principal e o privilégio USE_SCHEMA
no esquema principal. Não há garantia de uma ordem específica dos elementos na matriz.
databricks tables list CATALOG_NAME SCHEMA_NAME [flags]
Argumentos
CATALOG_NAME
Nome do catálogo principal para tabelas de interesse.
SCHEMA_NAME
Esquema principal das tabelas.
Opções
--include-browse
Se deve incluir tabelas na resposta para as quais o diretor só pode acessar metadados seletivos.
--include-delta-metadata
Se os metadados delta devem ser incluídos na resposta.
--include-manifest-capabilities
Se deve incluir um manifesto contendo os recursos que a tabela tem.
--max-results int
Número máximo de mesas a serem devolvidas.
--omit-columns
Se as colunas da tabela devem ser omitidas da resposta ou não.
--omit-properties
Se as propriedades da tabela devem ser omitidas da resposta ou não.
--omit-username
Se deve omitir o nome de usuário da tabela (por exemplo.
--page-token string
Tokens opacos a serem enviados para a próxima página de resultados (paginação).
Exemplos
O exemplo a seguir lista todas as tabelas em um catálogo e esquema:
databricks tables list my_catalog my_schema
O exemplo a seguir lista tabelas com colunas omitidas:
databricks tables list my_catalog my_schema --omit-columns
resumos da lista de tabelas do databricks
Liste os resumos das tabelas de um esquema e catálogo dentro do metastore. Os resumos da tabela retornados são:
- resumos de tabelas (dentro do metastore atual e do catálogo e esquema principais), quando o usuário é administrador do metastore,
- ou resumos de tabelas e esquemas (no metastore atual e no catálogo principal) dos quais o usuário tenha propriedade ou o privilégio
SELECT
na tabela e a propriedade ou o privilégioUSE_SCHEMA
no esquema, desde que o usuário também tenha a propriedade ou o privilégioUSE_CATALOG
no catálogo principal.
Não há garantia de uma ordem específica dos elementos na matriz.
databricks tables list-summaries CATALOG_NAME [flags]
Argumentos
CATALOG_NAME
Nome do catálogo principal para tabelas de interesse.
Opções
--include-manifest-capabilities
Se deve incluir um manifesto contendo os recursos que a tabela tem.
--max-results int
Número máximo de resumos para as tabelas retornarem.
--page-token string
Tokens de paginação opacos para avançar para a próxima página com base na consulta anterior.
--schema-name-pattern string
Um padrão sql LIKE (% e _) para nomes de esquemas.
--table-name-pattern string
Um padrão sql LIKE (% e _) para nomes de tabelas.
Exemplos
O exemplo a seguir lista os resumos das tabelas de um catálogo:
databricks tables list-summaries my_catalog
O exemplo a seguir lista resumos de tabelas com padrão de nome de esquema:
databricks tables list-summaries my_catalog --schema-name-pattern "prod_%"
O exemplo a seguir lista resumos de tabelas com o padrão de nome de tabela:
databricks tables list-summaries my_catalog --table-name-pattern "fact_%"
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