Tutorial: Criar sua primeira tabela e conceder privilégios

Este artigo fornece um rápido passo a passo sobre a criação de uma tabela e a concessão de privilégios em Databricks usando o modelo de governança de dados Unity Catalog. A partir de 8 de novembro de 2023, o espaço de trabalho em uma nova conta será automaticamente habilitado para Unity Catalog e incluirá as permissões necessárias para que todos os usuários concluam este tutorial.

Se o senhor não tiver certeza se o site workspace está habilitado para Unity Catalog, consulte Configurar e gerenciar Unity Catalog. Se o senhor quiser se familiarizar com os objetos de dados do Unity Catalog, consulte What is Unity Catalog?

Este artigo é destinado aos usuários, mas também pode ser de interesse dos administradores que são responsáveis pelo gerenciamento do workspace.

Antes de começar

Para realizar a tarefa descrita neste artigo, o senhor deve ter:

  • Um Databricks workspace que foi ativado automaticamente para Unity Catalog.

  • Permissões para anexar a um recurso compute. Consulte Usar computação.

Crie sua primeira tabela

O Unity Catalog inclui um namespace de três níveis para objetos de dados: catalog.schema.table. Neste exemplo, o senhor executará um Notebook que cria uma tabela chamada department no catálogo workspace e um esquema default (banco de dados).

Observação

O catálogo workspace é o catálogo default criado com o seu workspace ao qual todos os usuários têm acesso. Ele compartilha um nome com o seu workspace.

O senhor pode definir o acesso às tabelas de forma declarativa usando SQL ou a UI do Databricks Explorer:

  1. Na barra lateral, clique em +New > Notebook.

  2. Selecione SQL como o idioma Notebook.

  3. Clique em Connect (Conectar ) e anexe o Notebook a um recurso compute.

  4. Adicione os seguintes comandos ao Notebook e execute-os (substitua <workspace-catalog> pelo nome do seu catálogo workspace ):

    USE CATALOG <workspace-catalog>

    CREATE TABLE IF NOT EXISTS default.department
(
   deptcode   INT,
   deptname  STRING,
   location  STRING
);

    INSERT INTO default.department VALUES
   (10, 'FINANCE', 'EDINBURGH'),
   (20, 'SOFTWARE', 'PADDINGTON');

  5. Na barra lateral, clique em Ícone do catálogo Catalog e, em seguida, pesquise o catálogo workspace (<workspace-name>) e o esquema default, onde o senhor encontrará a nova tabela department.

Use o Catalog Explorer para localizar uma tabela no catálogo workspace

gerenciar permissões em sua mesa

Como criador original da tabela, o senhor é o proprietário da tabela e pode conceder a outros usuários permissão para ler ou gravar na tabela. O senhor pode até mesmo transferir a propriedade, mas não faremos isso aqui. Para obter mais informações sobre o modelo de privilégios e permissões do site Unity Catalog, consulte gerenciar privilégios em Unity Catalog.

Conceder permissões usando a interface do usuário

Para conceder permissões aos usuários em sua tabela usando a interface do usuário:

  1. Clique no nome da tabela no Catalog Explorer para abrir a página de detalhes da tabela e vá para Permissions (Permissões ) tab.

  2. Clique em Conceder.

  3. Na caixa de diálogo Grant on:

    1. Selecione os usuários e grupos aos quais deseja dar permissão.

    2. Selecione os privilégios que deseja conceder. Para este exemplo, atribua o privilégio SELECT (leitura) e clique em Grant (Conceder).

Conceder permissões usando instruções SQL

O senhor também pode conceder essas permissões usando a seguinte instrução SQL em um Databricks Notebook ou no editor de consultas SQL. Neste exemplo, o senhor concede a um grupo chamado data-consumers permissões na sua tabela:

GRANT SELECT ON default.department TO `data-consumers`;