Grupo de comandos tables

O grupo de tablescomandos dentro da CLI do Databricks contém comandos para gerenciar tabelas no Unity Catalog. Uma tabela reside na terceira camada do namespace de três níveis do Catálogo do Unity. Ele contém linhas de dados.

criar tabelas do databricks

Crie uma nova tabela no catálogo e no esquema especificados.

Para criar uma tabela Delta externa, o chamador deve ter EXTERNAL_USE_SCHEMA no esquema pai e EXTERNAL_USE_LOCATION no local externo, além dos privilégios padrãoUSE_CATALOG, CREATE_TABLEUSE_SCHEMAe CREATE_EXTERNAL_TABLE privilégios. O columns campo deve estar em um formato compatível com Spark.

databricks tables create NAME CATALOG_NAME SCHEMA_NAME TABLE_TYPE DATA_SOURCE_FORMAT STORAGE_LOCATION [flags]

Arguments

NAME

    Nome da tabela, em relação ao esquema pai.

CATALOG_NAME

    Nome do catálogo pai.

SCHEMA_NAME

    Nome do esquema pai, em relação ao catálogo pai.

TABLE_TYPE

    O tipo da tabela. Valores com suporte: EXTERNAL, , EXTERNAL_SHALLOW_CLONE, FOREIGN, MANAGED, MANAGED_SHALLOW_CLONE, , MATERIALIZED_VIEW, METRIC_VIEW, , STREAMING_TABLE, . VIEW

DATA_SOURCE_FORMAT

    O formato da fonte de dados da tabela. Valores com suporte: AVRO, , CSV, DELTA, DELTASHARING, HIVE, , ICEBERG, JSON, , ORC, PARQUET, , e TEXToutros.

STORAGE_LOCATION

    URL raiz de armazenamento para a tabela (necessária para e EXTERNAL tabelasMANAGED).

Opções

--json JSON

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

Sinalizadores globais

Examples

O exemplo a seguir cria uma tabela Delta externa:

databricks tables create my_table my_catalog my_schema EXTERNAL DELTA s3://my-bucket/my-table

excluir tabelas do databricks

Exclua uma tabela do catálogo principal e do esquema especificados. É necessário que o chamador seja o proprietário do catálogo pai, tenha o privilégio USE_CATALOG no catálogo pai e seja proprietário do esquema pai, ou seja o proprietário da tabela e tenha o privilégio USE_CATALOG no catálogo pai e o privilégio USE_SCHEMA no esquema pai.

databricks tables delete FULL_NAME [flags]

Arguments

FULL_NAME

    Nome completo da tabela.

Opções

Sinalizadores globais

Examples

O exemplo a seguir exclui uma tabela:

databricks tables delete my_catalog.my_schema.my_table

existem tabelas do databricks

Obtenha se existe uma tabela no metastore para um catálogo e um esquema específicos. O chamador deve atender a um dos seguintes requisitos:

• Ser um administrador do metastore
• Seja o proprietário do catálogo pai
• Seja o proprietário do esquema pai e tenha privilégio USE_CATALOG no catálogo pai
• Tenha o privilégio USE_CATALOG no catálogo pai e o privilégio USE_SCHEMA no esquema pai e seja o proprietário da tabela ou tenha o privilégio SELECT na tabela.
• Tenha o privilégio BROWSE no catálogo pai
• Ter o privilégio BROWSE no esquema pai.

databricks tables exists FULL_NAME [flags]

Arguments

FULL_NAME

    Nome completo da tabela.

Opções

Sinalizadores globais

Examples

O exemplo a seguir verifica se existe uma tabela:

databricks tables exists my_catalog.my_schema.my_table

obter tabelas do databricks

Obtenha uma tabela do metastore para um catálogo e esquema específicos. O chamador deve atender a um dos seguintes requisitos:

• Ser um administrador do metastore
• Seja o proprietário do catálogo pai
• Seja o proprietário do esquema pai e tenha privilégio USE_CATALOG no catálogo pai
• Tenha o privilégio USE_CATALOG no catálogo pai e o privilégio USE_SCHEMA no esquema pai e seja o proprietário da tabela ou tenha o privilégio SELECT na tabela.

databricks tables get FULL_NAME [flags]

Arguments

FULL_NAME

    Nome completo da tabela.

Opções

--include-browse

    Indica se deve incluir na resposta as tabelas para as quais a entidade de segurança tem acesso apenas a metadados seletivos.

--include-delta-metadata

    Se os metadados delta devem ser incluídos na resposta.

--include-manifest-capabilities

    Se deve incluir um manifesto contendo funcionalidades que a tabela possui.

Sinalizadores globais

Examples

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

databricks tables get my_catalog.my_schema.my_table

O exemplo a seguir obtém 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 todos os volumes para o metastore atual no catálogo pai e no esquema. O chamador deve ser um administrador do metastore ou um proprietário da tabela (ou ter o privilégio SELECT). Para o último caso, o chamador também deve ser o proprietário ou ter o privilégio USE_CATALOG no catálogo pai e o privilégio USE_SCHEMA no esquema pai. Não há garantia de uma ordenação específica dos elementos na matriz.

databricks tables list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    Nome do catálogo pai para tabelas de interesse.

SCHEMA_NAME

    Esquema pai de tabelas.

Opções

--include-browse

    Indica se deve incluir na resposta as tabelas para as quais a entidade de segurança tem acesso apenas a metadados seletivos.

--include-delta-metadata

    Se os metadados delta devem ser incluídos na resposta.

--include-manifest-capabilities

    Se deve incluir um manifesto contendo funcionalidades que a tabela possui.

--max-results int

    Número máximo de tabelas a serem retornadas.

--omit-columns

    Se deve omitir as colunas da tabela da resposta ou não.

--omit-properties

    Se deve omitir as propriedades da tabela da resposta ou não.

--omit-username

    Se deve omitir o nome de usuário da tabela (por exemplo,

--page-token string

    Token opaco para enviar à próxima página de resultados (paginação).

Sinalizadores globais

Examples

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

listas-resumos de tabelas do Databricks

Listar sumários das tabelas para um esquema e catálogo dentro do metastore. Os resumos da tabela retornados são:

• resumos para tabelas (dentro do metastore atual, catálogo pai e esquema), quando o usuário é o administrador do metastore.
• ou resumos para tabelas e esquemas (dentro do metastore atual e do catálogo principal), para os quais o usuário tem propriedade ou o privilégio SELECT na tabela, e tem propriedade ou o privilégio USE_SCHEMA no esquema, desde que o usuário também tenha propriedade ou o privilégio USE_CATALOG no catálogo principal.

Não há garantia de uma ordenação específica dos elementos na matriz.

databricks tables list-summaries CATALOG_NAME [flags]

Arguments

CATALOG_NAME

    Nome do catálogo pai para tabelas de interesse.

Opções

--include-manifest-capabilities

    Se deve incluir um manifesto contendo funcionalidades que a tabela possui.

--max-results int

    Número máximo de resumos para que as tabelas retornem.

--page-token string

    Token de paginação não transparente que permite ir para a próxima página com base na consulta anterior.

--schema-name-pattern string

    Um padrão SQL LIKE (% e _) para nomes de esquema.

--table-name-pattern string

    Um padrão SQL LIKE (% e _) para nomes de tabela.

Sinalizadores globais

Examples

O exemplo a seguir lista resumos de tabela para um catálogo:

databricks tables list-summaries my_catalog

O seguinte exemplo lista resumos de tabela com o padrão de nome de esquema:

databricks tables list-summaries my_catalog --schema-name-pattern "prod_%"

O exemplo a seguir lista resumos de tabela com o padrão de nome da tabela:

databricks tables list-summaries my_catalog --table-name-pattern "fact_%"

Sinalizadores globais

--debug

  Indica se deve habilitar o registro em 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 para o qual gravar 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 de comando, text ou json. O valor padrão é text.

-p, --profile corda

    O nome do perfil no arquivo ~/.databrickscfg para usar ao 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