Começando a utilizar o Secure Data Sharing¶

Etapa 1: criar funções de banco de dados¶

Crie uma nova função de banco de dados ou substitua uma função de banco de dados existente usando CREATE DATABASE ROLE.

Por exemplo, crie funções de banco de dados d1.r1 e d1.r2 usando identificadores totalmente qualificados:

CREATE DATABASE ROLE d1.r1;

CREATE DATABASE ROLE d1.r2;

Como alternativa, defina o banco de dados desejado como o banco de dados atual na sessão, e então crie as funções do banco de dados:

USE DATABASE d1;

CREATE DATABASE ROLE r1;

CREATE DATABASE ROLE r2;

Etapa 2: conceder privilégios em objetos a funções de banco de dados¶

Conceda privilégios em um único banco de dados e subconjunto de objetos no banco de dados para cada função do banco de dados usando GRANT <privilégios>. Somente conceda privilégios em objetos aos quais a função de banco de dados deve permitir o acesso.

Especifique o nome totalmente qualificado de uma função de banco de dados ou defina o banco de dados como o banco de dados ativo em uma sessão e, em seguida, especifique o nome relativo.

Continuando o exemplo detalhado nestas instruções, os seguintes privilégios são concedidos às funções do banco de dados:

As seguintes instruções SQL concedem privilégios à função do banco de dados d1.r1:

GRANT USAGE ON SCHEMA d1.s1 TO DATABASE ROLE d1.r1;
GRANT SELECT ON VIEW d1.s1.v1 TO DATABASE ROLE d1.r1;

As seguintes instruções SQL concedem privilégios à função do banco de dados d1.r2:

GRANT USAGE ON SCHEMA d1.s1 TO DATABASE ROLE d1.r2;
GRANT SELECT ON VIEW d1.s1.v2 TO DATABASE ROLE d1.r2;

Note que não é necessário conceder o privilégio USAGE no banco de dados pai. Este privilégio é concedido implicitamente quando uma função de banco de dados é criada.

Para visualizar todos os privilégios concedidos a uma função de banco de dados, execute SHOW GRANTS TO DATABASE ROLE usando identificadores totalmente qualificados:

SHOW GRANTS TO DATABASE ROLE d1.r1;
SHOW GRANTS TO DATABASE ROLE d1.r2;

Como alternativa, defina o banco de dados desejado como o banco de dados atual na sessão e então execute o comando:

USE DATABASE d1;

SHOW GRANTS TO DATABASE ROLE r1;
SHOW GRANTS TO DATABASE ROLE r2;

Etapa 3: criar um compartilhamento¶

Criar um compartilhamento usando CREATE SHARE. O compartilhamento é um recipiente vazio neste estágio do processo.

Por exemplo, crie um novo compartilhamento chamado share1:

CREATE SHARE share1;

Etapa 4: adicionar o banco de dados concedendo o privilégio USAGE ao compartilhamento¶

Atualmente, é necessário conceder o privilégio USAGE em um banco de dados para incluí-lo em um compartilhamento.

Por exemplo, conceda o privilégio USAGE no banco de dados d1 para o compartilhamento share1:

GRANT USAGE ON DATABASE d1 TO SHARE share1;

Etapa 5: adicionar objetos ao conceder funções de banco de dados ao compartilhamento¶

Adicione bancos de dados e objetos de banco de dados a um compartilhamento, concedendo funções de banco de dados ao compartilhamento usando GRANT DATABASE ROLE … TO SHARE.

Por exemplo, conceda funções de banco de dados d1.r1 e d1.r2 para o compartilhamento share1:

GRANT DATABASE ROLE d1.r1 TO SHARE share1;
GRANT DATABASE ROLE d1.r2 TO SHARE share1;

Etapa 6: compartilhar os objetos de banco de dados com uma ou mais contas de consumidores de dados¶

Modifique o compartilhamento ALTER SHARE … ADD ACCOUNTS e adicione as contas de consumidor do banco de dados com as quais você deseja compartilhar os objetos de banco de dados.

O exemplo seguinte adiciona contas consumer1 e consumer2 na organização org1 para o compartilhamento share1:

ALTER SHARE share1 ADD ACCOUNTS = org1.consumer1,org1.consumer2;

Gerenciamento de funções de bancos de dados¶

Esta seção fornece instruções para gerenciar as funções de banco de dados que são concedidas aos compartilhamentos.

ALTER DATABASE ROLE d1.r1 RENAME TO d1.r3;

ALTER DATABASE ROLE d1.r1 RENAME TO d2.r1;

DROP DATABASE ROLE d1.r2;

Passo 1: criar um compartilhamento¶

Use CREATE SHARE para criar um compartilhamento. Neste passo, o compartilhamento é simplesmente um recipiente esperando que objetos e contas sejam adicionados.

Passo 2: adicionar objetos ao compartilhamento através da concessão privilégios¶

Utilize GRANT <privilégio> … TO SHARE para conceder os seguintes privilégios de objeto ao compartilhamento:

• Privilégio de USAGE sobre o banco de dados que você deseja compartilhar.

• Privilégio de USAGE em cada esquema de banco de dados contendo os objetos que você deseja compartilhar.

• Privilégio SELECT de compartilhar objetos específicos em cada esquema compartilhado:

  • Tabelas

  • Tabelas externas

  • Exibições seguras

  • Exibições materializadas seguras

  • UDFs seguros

Opcionalmente, utilize SHOW GRANTS para visualizar as concessões de objetos para o compartilhamento.

Passo 3: adicionar uma ou mais contas ao compartilhamento¶

Utilize ALTER SHARE para adicionar uma ou mais contas ao compartilhamento. Para examinar as contas adicionadas ao compartilhamento, você pode usar SHOW GRANTS.

Agora o compartilhamento está pronto para ser consumido pelas contas especificadas. Para obter instruções mais detalhadas para executar estas e outras tarefas do provedor de dados, consulte Como trabalhar com compartilhamentos.

Exemplo¶

O exemplo a seguir ilustra o processo de provedor em sua totalidade, conforme descrito acima.

Note que este exemplo considera que:

• existe um banco de dados chamado sales_db com um esquema chamado aggregates_eula e uma tabela chamada aggregate_1.

• o banco de dados, o esquema e a tabela serão compartilhados com duas contas denominadas xy12345 e yz23456.

USE ROLE accountadmin;

CREATE SHARE sales_s;

GRANT USAGE ON DATABASE sales_db TO SHARE sales_s;
GRANT USAGE ON SCHEMA sales_db.aggregates_eula TO SHARE sales_s;
GRANT SELECT ON TABLE sales_db.aggregates_eula.aggregate_1 TO SHARE sales_s;

SHOW GRANTS TO SHARE sales_s;

ALTER SHARE sales_s ADD ACCOUNTS=xy12345, yz23456;

SHOW GRANTS OF SHARE sales_s;

Copy