tables grupo de comando

O tables grupo de comandos dentro da CLI Databricks contém comandos para gerir 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.

Excluir tabelas Databricks

Exclua uma tabela do catálogo pai e do esquema especificados. O chamador deve ser o proprietário do catálogo pai, ter o USE_CATALOG privilégio no catálogo pai e ser o proprietário do esquema pai, ou, alternativamente, ser o proprietário da tabela e ter o USE_CATALOG privilégio no catálogo pai e o USE_SCHEMA privilégio no esquema pai.

databricks tables delete FULL_NAME [flags]

Arguments

FULL_NAME

    Nome completo da tabela.

Opções

Bandeiras globais

Examples

O exemplo a seguir exclui uma tabela:

databricks tables delete my_catalog.my_schema.my_table

As tabelas Databricks existem

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

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

databricks tables exists FULL_NAME [flags]

Arguments

FULL_NAME

    Nome completo da tabela.

Opções

Bandeiras globais

Examples

O exemplo a seguir verifica se existe uma tabela:

databricks tables exists my_catalog.my_schema.my_table

Obter tabelas Databricks

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

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

databricks tables get FULL_NAME [flags]

Arguments

FULL_NAME

    Nome completo da tabela.

Opções

--include-browse

    Se as tabelas devem ser incluídas na resposta para as quais o principal só pode acessar metadados seletivos.

--include-delta-metadata

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

--include-manifest-capabilities

    Incluir ou não um manifesto que contenha as capacidades da tabela.

Bandeiras 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 todas as tabelas do metastore atual que estão dentro do catálogo principal e esquema associados. O chamador deve ser um administrador de metastore ou proprietário da tabela (ou ter o privilégio SELECT sobre esta). Para o último caso, o chamador também deve ser o proprietário ou ter o USE_CATALOG privilégio no catálogo pai e o USE_SCHEMA privilégio 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 principal de tabelas.

Opções

--include-browse

    Se as tabelas devem ser incluídas na resposta para as quais o principal só pode acessar metadados seletivos.

--include-delta-metadata

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

--include-manifest-capabilities

    Incluir ou não um manifesto que contenha as capacidades da tabela.

--max-results int

    Número máximo de tabelas a devolver.

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

    Omitir ou não o nome de utilizador da tabela (por exemplo,

--page-token string

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

Bandeiras 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

databricks tabelas list-resumos

Liste os resumos das tabelas de um esquema e de um catálogo num metastore. Os resumos das tabelas devolvidos são ou:

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

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

    Incluir ou não um manifesto que contenha as capacidades da tabela.

--max-results int

    Número máximo de resumos de tabelas a serem retornados.

--page-token string

    Token de paginação opaco para 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.

Bandeiras globais

Examples

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

databricks tables list-summaries my_catalog

O exemplo a seguir lista resumos de tabelas com o padrão de nome do esquema:

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

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

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

Bandeiras globais

--debug

  Se o log de depuração deve ser habilitado.

-h ou --help

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

--log-file string

    Uma cadeia de caracteres que representa o ficheiro onde os registos de saída são gravados. Se esse sinalizador não for especificado, o padrão é gravar logs de saída no stderr.

--log-format Formato

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

--log-level string

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

-o, --output tipo

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

-p, --profile string

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

--progress-format Formato

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

-t, --target string

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