shares grupo de comando

nota

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 shares dentro do Databricks CLI permite gerenciar compartilhamentos no Unity Catalog.

Um compartilhamento é um contêiner instanciado com shares create. Após a criação, é possível registrar iterativamente uma coleção de dados existentes ativos definidos no metastore utilizando shares update. É possível registrar dados ativos com seus nomes originais, qualificados por seu esquema original, ou fornecer nomes alternativos expostos.

criação de compartilhamentos de databricks

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

databricks shares create NAME [flags]

Argumentos

NAME

Nome da ação.

Opções

--comment string

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

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

--storage-root string

URL raiz de armazenamento para arquivos do Notebook no compartilhamento.

Bandeiras globais

Exemplos

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

Bash

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:

Bash

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

exclusões de compartilhamentos do databricks

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

databricks shares delete NAME [flags]

Argumentos

NAME

O nome da ação.

Opções

Bandeiras globais

Exemplos

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

Bash

databricks shares delete my-analytics-share

os compartilhamentos do databricks obtêm

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

databricks shares get NAME [flags]

Argumentos

NAME

O nome da ação.

Opções

--include-shared-data

Consulte os dados a serem incluídos no compartilhamento.

Bandeiras globais

Exemplos

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

Bash

databricks shares get my-analytics-share

O exemplo a seguir recebe um compartilhamento com detalhes sobre os dados compartilhados:

Bash

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

(Obsoleto) Lista de compartilhamentos do Databricks

atenção

Este comando está obsoleto.

Liste as ações do metastore. O chamador deve ser um administrador do metastore ou o proprietário do compartilhamento. A ordem dos elementos na matriz não é garantida.

databricks shares list [flags]

Argumentos

Nenhuma

Opções

--max-results int

Número máximo de ações a serem devolvidas.

--page-token string

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

Bandeiras globais

lista de compartilhamentos do Databricks

Liste as ações do metastore. O chamador deve ser um administrador do metastore ou o proprietário do compartilhamento. A ordem dos elementos na matriz não é garantida.

databricks shares list-shares [flags]

Argumentos

Nenhuma

Opções

--max-results int

Número máximo de ações a serem devolvidas.

--page-token string

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

Bandeiras globais

Exemplos

O exemplo a seguir lista todos os compartilhamentos:

Bash

databricks shares list-shares

atualização de compartilhamentos do databricks

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

Quando o chamador é administrador da metastore, somente o campo owner pode ser atualizado.

Caso o nome do compartilhamento seja alterado, updateShare exige que o chamador seja o proprietário do compartilhamento e tenha o privilégio CREATE_SHARE.

Se houver arquivos do Notebook no compartilhamento, o campo “ storage_root ” não poderá ser atualizado.

Para cada tabela adicionada por meio desse método, o proprietário do compartilhamento também deve ter o privilégio SELECT 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 por meio de update não exigem privilégios adicionais.

databricks shares update NAME [flags]

Argumentos

NAME

O nome da ação.

Opções

--comment string

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

--json JSON

As cadeias de caracteres JSON ou o caminho @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 atual proprietário do compartilhamento.

--storage-root string

URL raiz de armazenamento para arquivos do Notebook no compartilhamento.

Bandeiras globais

Exemplos

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

Bash

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

O exemplo a seguir altera o nome de um compartilhamento:

Bash

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

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

Bash

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

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

Bash

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

databricks compartilha permissões de compartilhamento

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

databricks shares share-permissions NAME [flags]

Argumentos

NAME

O nome da ação.

Opções

--max-results int

Número máximo de permissões para retornar.

--page-token string

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

Bandeiras globais

Exemplos

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

Bash

databricks shares share-permissions my-analytics-share

databricks compartilha permissões de atualização

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

Para subsídios para novos beneficiários, o usuário também deve ser o proprietário do destinatário ou administrador da metastore. as revogações de destinatários não exigem privilégios adicionais.

databricks shares update-permissions NAME [flags]

Argumentos

NAME

O nome da ação.

Opções

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

--omit-permissions-list

Opcional.

Bandeiras globais

Exemplos

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

Bash

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

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

Bash

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

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