Registro de dados¶

Este tópico descreve como registrar dados para que eles possam ser vinculados a um Snowflake Data Clean Room.

Objetos com suporte¶

Os tipos de objetos que podem ser vinculados a uma sala limpa variam dependendo se ela foi criada no aplicativo da web ou usando APIs do desenvolvedor. Objetos específicos desses tipos devem ser registrados antes de poderem ser vinculados.

Aplicativo da Web:

O aplicativo da Web das Snowflake Data Clean Rooms é compatível com os seguintes objetos:

Tabelas
Tabelas externas
Tabelas Apache Iceberg™
Exibições
Exibições materializadas
Exibições seguras. O proprietário de uma exibição segura deve ser a função SAMOOHA_APP_ROLE.

API de desenvolvedor:

Como as Snowflake Data Clean Rooms depende do Snowflake Native App Framework, você pode vincular qualquer objeto compatível pelo Snowflake Native App Framework.

Nota

Tabelas externas e tabelas Iceberg devem ter permissão explícita para serem vinculadas em uma sala limpa. Para obter mais informações, consulte Snowflake Data Clean Rooms: tabelas externas e iceberg.

Registro de objetos de dados¶

Antes que os usuários possam vincular dados em um Snowflake Data Clean Room, os dados devem ser registrados no nível do banco de dados, esquema ou objeto. Se você registrar um banco de dados ou esquema, todos os objetos naquele banco de dados ou esquema serão registrados.

Você pode registrar bancos de dados, esquemas e objetos usando o Snowsight ou as APIs de desenvolvedor. Usar Snowsight é mais simples, mas requer que você tenha a função ACCOUNTADMIN. Com APIs do desenvolvedor, o proprietário de um objeto pode registrá-lo mesmo que não seja um administrador de conta.

Registrar um banco de dados, esquema ou objeto concede acesso à função SAMOOHA_APP_ROLE, que é a função que os desenvolvedores usam quando executam APIs do desenvolvedor.

Nota

O registro de um banco de dados ou esquema não registra automaticamente objetos que são adicionados após o registro. Você deve registrar o novo objeto individualmente ou usar a opção Snowflake Admin do aplicativo da web para retornar à seção Database Registration e, em seguida, selecionar Resync.

Registro de dados em Snowsight¶

Para registrar um banco de dados, esquema ou objeto em Snowsight, faça o seguinte:

Faça login no aplicativo da Web.
Selecione Admin » Snowflake Admin.
Selecione Login to Snowflake, e autentique como um usuário com a função ACCOUNTADMIN.
Na seção Database Registration, selecione Edit e, em seguida, selecione o banco de dados, esquema ou objeto.
Selecione Save.

Registro de dados usando APIs do desenvolvedor¶

As APIs do desenvolvedor permitem que administradores de conta registrem bancos de dados, esquemas e objetos programaticamente. O proprietário do banco de dados, esquema ou objeto pode registrá-lo.

Estão disponíveis as seguintes APIs:

Tarefa	API	Entrada
Registrar um banco de dados	`provider.register_db` (para provedores) `consumer.register_db` (para consumidores)	Nome do banco de dados (string)
Registrar um esquema	`library.register_schema`	Nomes de esquemas (matriz de cadeias de caracteres)
Registrar um esquema de acesso gerenciado	`library.register_managed_access_schema`	Nomes de esquema de acesso gerenciado (matriz de cadeias de caracteres)
Registrar qualquer tipo de objeto	`library.register_table_or_view`	Nomes de objetos (matriz de cadeias de caracteres) is_view (boolean) is_iceberg (boolean) is_external (boolean) is_under_managed_access_schema (boolean)
Registrar uma tabela	`library.register_table`	Nomes de tabelas (matriz de cadeias de caracteres)
Registrar uma exibição	`library.register_view`	Nomes de exibição (matriz de cadeias de caracteres)
Registrar uma tabela em um esquema de acesso gerenciado	`library.register_managed_access_table`	Nomes de tabelas (matriz de cadeias de caracteres)
Registrar uma exibição em um esquema de acesso gerenciado	`library.register_managed_access_view`	Nomes de exibição (matriz de cadeias de caracteres)

Por exemplo, o proprietário de um esquema MY_SCHEMA pode registrá-lo executando os seguintes comandos em uma planilha:

CALL samooha_by_snowflake_local_db.library.register_schema(['MY_DB.MY_SCHEMA']);

Copy

Cancelamento de registro de dados usando APIs do desenvolvedor¶

Você pode usar as seguintes APIs para reverter o registro de bancos de dados, esquemas e objetos:

Tarefa	API	Entrada
Cancelar registro de um banco de dados	`library.unregister_db`	Nome do banco de dados (string)
Cancelar registro de um esquema	`library.unregister_schema`	Nomes de esquemas (matriz de cadeias de caracteres)
Cancelar registro de um esquema de acesso gerenciado	`library.unregister_managed_access_schema`	Nomes de esquema de acesso gerenciado (matriz de cadeias de caracteres)
Cancelar registro de qualquer tipo de objeto	`library.unregister_table_or_view`	Nomes de objetos (matriz de cadeias de caracteres) is_view (boolean) is_iceberg (boolean) is_external (boolean) is_under_managed_access_schema (boolean)
Cancelar registro de uma tabela	`library.unregister_table`	Nomes de tabelas (matriz de cadeias de caracteres)
Cancelar registro de uma exibição	`library.unregister_view`	Nomes de exibição (matriz de cadeias de caracteres)
Cancelar registro de uma tabela em um esquema de acesso gerenciado	`library.unregister_managed_access_table`	Nomes de tabelas (matriz de cadeias de caracteres)
Cancelar registro de uma exibição em um esquema de acesso gerenciado	`library.unregister_managed_access_view`	Nomes de exibição (matriz de cadeias de caracteres)