external-metadata grupo de comando

O external-metadata grupo de comandos dentro da CLI Databricks contém comandos para registar e gerir metadados sobre sistemas externos dentro do Unity Catalog.

databricks metadados externos criar-metadados externos

Crie um novo objeto externo de metadados na metastore pai se o chamador for administrador da metastore ou tiver o privilégio CREATE_EXTERNAL_METADATA . Concede NAVEGAR a todos os utilizadores da conta aquando da criação por defeito.

databricks external-metadata create-external-metadata NAME SYSTEM_TYPE ENTITY_TYPE [flags]

Arguments

NAME

    Nome do objeto de metadados externo.

SYSTEM_TYPE

    Tipo de sistema externo. Valores suportados: AMAZON_REDSHIFT, AZURE_SYNAPSE, CONFLUENTDATABRICKS, GOOGLE_BIGQUERY, KAFKA, LOOKER, MICROSOFT_FABRIC, ORACLESTREAM_NATIVEWORKDAYTERADATATABLEAUSNOWFLAKESERVICENOWSAPSALESFORCEPOSTGRESQLMYSQLPOWER_BIMICROSOFT_SQL_SERVERMONGODBOTHER.

ENTITY_TYPE

    Tipo de entidade dentro do sistema externo.

Opções

--description string

    Descrição de texto de forma livre fornecida pelo usuário.

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação

--owner string

    Proprietário do objeto de metadados externos.

--url string

    URL associada ao objeto de metadados externo.

Bandeiras globais

Exemplos

O exemplo seguinte cria um objeto de metadados externo para uma tabela Snowflake:

databricks external-metadata create-external-metadata my_snowflake_table SNOWFLAKE TABLE --description "Production sales table" --url "https://example.snowflakecomputing.com/table/sales"

O exemplo seguinte cria um objeto de metadados externo usando JSON:

databricks external-metadata create-external-metadata tableau_dashboard TABLEAU DASHBOARD --json '{"description": "Sales dashboard", "owner": "user@example.com"}'

O exemplo seguinte cria um objeto de metadados externo usando um ficheiro JSON:

databricks external-metadata create-external-metadata bigquery_dataset GOOGLE_BIGQUERY DATASET --json @external-metadata.json

Databricks metadados externos eliminar metadados externos

Elimine o objeto de metadados externo que corresponda ao nome fornecido. O chamador deve ser um administrador da metastore, o proprietário do objeto de metadados externo ou um utilizador que tenha o privilégio GERIR .

databricks external-metadata delete-external-metadata NAME [flags]

Arguments

NAME

    Nome do objeto de metadados externo a eliminar.

Opções

Bandeiras globais

Exemplos

O exemplo seguinte elimina um objeto de metadados externo:

databricks external-metadata delete-external-metadata my_snowflake_table

databricks external-metadata get-external-metadata

Obtenha o objeto de metadados externo especificado numa metastore. O chamador deve ser um administrador da metastore, o proprietário do objeto de metadados externo ou um utilizador que tenha o privilégio NAVEGAR .

databricks external-metadata get-external-metadata NAME [flags]

Arguments

NAME

    Nome do objeto de metadados externo a obter.

Opções

Bandeiras globais

Exemplos

O exemplo seguinte recebe um objeto de metadados externo:

databricks external-metadata get-external-metadata my_snowflake_table

Databricks External-Metadata List-External-Metadata

Liste objetos de metadados externos na metastore. Se o chamador for o administrador da metastore, todos os objetos de metadados externos serão recuperados. Caso contrário, apenas os objetos de metadados externos em que o chamador tem BROWSE serão recuperados. Não há garantia de uma ordenação específica dos elementos na matriz.

databricks external-metadata list-external-metadata [flags]

Opções

--page-size int

    Número máximo de objetos de metadados externos a devolver por página.

--page-token string

    Token para recuperar a próxima página de resultados.

Bandeiras globais

Exemplos

O exemplo seguinte lista todos os objetos de metadados externos:

databricks external-metadata list-external-metadata

O exemplo seguinte lista objetos de metadados externos com paginação:

databricks external-metadata list-external-metadata --page-size 10

databricks External-Metadata Update-External-Metadata

Atualize o objeto de metadados externo que corresponda ao nome fornecido. O interlocutor só pode atualizar o proprietário ou outros campos de metadados num pedido. O chamador deve ser um administrador de metastore, o proprietário do objeto de metadados externo ou um utilizador que tenha o privilégio MODIFICAR . Se o interlocutor estiver a atualizar o proprietário, também deve ter o privilégio de GERIR .

databricks external-metadata update-external-metadata NAME UPDATE_MASK SYSTEM_TYPE ENTITY_TYPE [flags]

Arguments

NAME

    Nome do objeto de metadados externo.

UPDATE_MASK

    A máscara de campo deve ser uma única cadeia de caracteres, com vários campos separados por vírgulas (sem espaços). O caminho do campo é relativo ao objeto de recurso, usando um ponto (.) para navegar em subcampos (por exemplo, author.given_name). A especificação de elementos em campos de sequência ou mapa não é permitida, pois apenas todo o campo de coleta pode ser especificado. Os nomes de campo devem corresponder exatamente aos nomes de campo de recurso.

    Uma máscara de campo de asterisco (*) indica substituição completa. Recomenda-se sempre listar explicitamente os campos que estão sendo atualizados e evitar o uso de curingas, pois isso pode levar a resultados não intencionais se a API mudar no futuro.

SYSTEM_TYPE

    Tipo de sistema externo. Valores suportados: AMAZON_REDSHIFT, AZURE_SYNAPSE, CONFLUENTDATABRICKS, GOOGLE_BIGQUERY, KAFKA, LOOKER, MICROSOFT_FABRIC, ORACLESTREAM_NATIVEWORKDAYTERADATATABLEAUSNOWFLAKESERVICENOWSAPSALESFORCEPOSTGRESQLMYSQLPOWER_BIMICROSOFT_SQL_SERVERMONGODBOTHER.

ENTITY_TYPE

    Tipo de entidade dentro do sistema externo.

Opções

--description string

    Descrição de texto de forma livre fornecida pelo usuário.

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação

--owner string

    Proprietário do objeto de metadados externos.

--url string

    URL associada ao objeto de metadados externo.

Bandeiras globais

Exemplos

O exemplo seguinte atualiza a descrição de um objeto de metadados externo:

databricks external-metadata update-external-metadata my_snowflake_table "description" SNOWFLAKE TABLE --description "Updated production sales table"

O exemplo seguinte atualiza o proprietário de um objeto de metadados externo:

databricks external-metadata update-external-metadata my_snowflake_table "owner" SNOWFLAKE TABLE --owner "newowner@example.com"

O exemplo seguinte atualiza um objeto de metadados externo usando JSON:

databricks external-metadata update-external-metadata my_snowflake_table "description,url" SNOWFLAKE TABLE --json '{"description": "Latest sales data", "url": "https://example.snowflakecomputing.com/table/sales_v2"}'

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