Partilhar via

shares grupo de comando

Note

Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Pré-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 disposições de Dados de Uso.

O shares grupo de comandos dentro da CLI do Databricks permite gerenciar compartilhamentos no Unity Catalog.

Um compartilhamento é um contêiner instanciado com shares create. Uma vez criada, pode iterativamente registrar uma coleção de ativos de dados existentes definidos no metastore usando shares update. Você pode registrar ativos de dados sob seu nome original, qualificados por seu esquema original, ou fornecer nomes expostos alternativos.

criação de compartilhamentos databricks

Crie um novo compartilhamento para objetos de dados. Os objetos de dados podem ser adicionados após a criação com update. O chamador deve ser um administrador do metastore ou ter o CREATE_SHARE privilégio no metastore.

databricks shares create NAME [flags]

Arguments

NAME

    Nome da ação.

Opções

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

--storage-root string

    URL raiz de armazenamento para ficheiros de caderno na partilha.

Bandeiras globais

Examples

Os exemplos a seguir criam um compartilhamento nomeado my-analytics-share com um comentário:

databricks shares create my-analytics-share --comment "Sales analytics data share"

O exemplo a seguir cria um compartilhamento com uma raiz de armazenamento específica:

databricks shares create my-analytics-share --storage-root "s3://my-bucket/share-data"

Exclusão de ações da Databricks

Exclua um compartilhamento do metastore. O chamador deve ser um proprietário do compartilhamento.

databricks shares delete NAME [flags]

Arguments

NAME

    O nome do compartilhamento.

Opções

Bandeiras globais

Examples

O exemplo a seguir exclui um compartilhamento chamado my-analytics-share:

databricks shares delete my-analytics-share

ações da Databricks adquirem

Obtenha um compartilhamento do metastore. O chamador deve ser um administrador de metastore ou o proprietário do compartilhamento.

databricks shares get NAME [flags]

Arguments

NAME

    O nome do compartilhamento.

Opções

--include-shared-data

    Consulta de dados a serem incluídos no compartilhamento.

Bandeiras globais

Examples

O exemplo a seguir obtém informações sobre um compartilhamento chamado my-analytics-share:

databricks shares get my-analytics-share

O exemplo a seguir obtém um compartilhamento com detalhes sobre os dados compartilhados:

databricks shares get my-analytics-share --include-shared-data

Lista de compartilhamentos de databricks (preterida)

Deprecated. Listar compartilhamentos do metastore. O chamador deve ser um administrador de metastore ou o proprietário do compartilhamento. A ordem dos elementos na matriz não é garantida.

databricks shares list [flags]

Arguments

None

Opções

--max-results int

    Número máximo de ações (de empresa) a devolver.

--page-token string

    Token de paginação opaco para avançar para a próxima página com base na consulta anterior.

Bandeiras globais

Databricks compartilha compartilhamentos de lista

Listar compartilhamentos do metastore. O chamador deve ser um administrador de metastore ou o proprietário do compartilhamento. A ordem dos elementos na matriz não é garantida.

databricks shares list-shares [flags]

Arguments

None

Opções

--max-results int

    Número máximo de ações (de empresa) a devolver.

--page-token string

    Token de paginação opaco para avançar para a próxima página com base na consulta anterior.

Bandeiras globais

Examples

O exemplo a seguir lista todos os compartilhamentos:

databricks shares list-shares

Atualização de compartilhamentos do Databricks

Atualize o compartilhamento com as alterações e objetos de dados na solicitação. O chamador deve ser proprietário da partilha ou um administrador de metastore.

Quando o chamador é um administrador de metastore, apenas o owner campo pode ser atualizado.

No caso de o nome do compartilhamento ser alterado, updateShare requer que o chamador seja o proprietário do compartilhamento e tenha o CREATE_SHARE privilégio.

Se houver ficheiros de notebooks na partilha, o storage_root campo não poderá ser atualizado.

Para cada tabela adicionada por meio desse método, o proprietário do compartilhamento também deve ter SELECT privilégio na tabela. Esse privilégio deve ser mantido indefinidamente para que os destinatários possam acessar a tabela. Normalmente, você deve usar um grupo como proprietário do compartilhamento.

As remoções de tabelas através de update não exigem privilégios adicionais.

databricks shares update NAME [flags]

Arguments

NAME

    O nome do compartilhamento.

Opções

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

--new-name string

    Novo nome para o compartilhamento.

--owner string

    Nome de usuário do proprietário atual do compartilhamento.

--storage-root string

    URL raiz de armazenamento para ficheiros de caderno na partilha.

Bandeiras globais

Examples

O exemplo a seguir atualiza o comentário de um compartilhamento:

databricks shares update my-analytics-share --comment "Updated sales analytics data share"

O exemplo a seguir altera o nome de um compartilhamento:

databricks shares update my-analytics-share --new-name "sales-analytics-share"

O exemplo a seguir atualiza o proprietário de um compartilhamento:

databricks shares update my-analytics-share --owner "someone@example.com"

O exemplo a seguir atualiza um compartilhamento usando a configuração JSON:

databricks shares update my-analytics-share --json '{
  "comment": "Updated share with new tables",
  "objects": [
    {
      "name": "sales.customers",
      "data_object_type": "TABLE"
    }
  ]
}'

O Databricks compartilha permissões de compartilhamento

Obtenha permissões para um compartilhamento de dados do metastore. O chamador deve ser um administrador de metastore ou o proprietário do compartilhamento.

databricks shares share-permissions NAME [flags]

Arguments

NAME

    O nome do compartilhamento.

Opções

--max-results int

    Número máximo de permissões para devolução.

--page-token string

    Token de paginação opaco para avançar para a próxima página com base na consulta anterior.

Bandeiras globais

Examples

O exemplo a seguir obtém permissões para um compartilhamento chamado my-analytics-share:

databricks shares share-permissions my-analytics-share

O Databricks compartilha permissões de atualização

Atualize as permissões para um compartilhamento de dados no metastore. O chamador deve ser um administrador de metastore ou um proprietário do compartilhamento.

Para concessões de novos destinatários, o usuário também deve ser o proprietário do destinatário ou o administrador do metastore. Revogações de destinatários não requerem privilégios adicionais.

databricks shares update-permissions NAME [flags]

Arguments

NAME

    O nome do compartilhamento.

Opções

--json JSON

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

--omit-permissions-list

    Optional.

Bandeiras globais

Examples

O exemplo a seguir concede permissões a um destinatário:

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "add": ["SELECT"]
    }
  ]
}'

O exemplo a seguir revoga permissões de um destinatário:

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "remove": ["SELECT"]
    }
  ]
}'

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

  • Last updated on