Guia do desenvolvedor do Snowflake Data Clean Rooms¶

Ferramentas de desenvolvimento¶

Aqui estão as principais ferramentas de desenvolvimento para clean rooms:

• Ambiente de codificação: qualquer ambiente de codificação que possa executar procedimentos armazenados em sua conta Snowflake funcionará. A maioria dos desenvolvedores usa planilhas no Snowsight (a ferramenta baseada em navegador) ou no Snowflake CLI.

• As UI de clean rooms: use as UI de clean rooms para configurar, gerenciar ou criar clean rooms. A maioria dos analistas de clean rooms usa a UI em vez do código; portanto, pode ser útil ver e testar a experiência de suas clean rooms na UI. Além disso, há alguns recursos que estão disponíveis apenas nas UI de clean rooms.

• O Snowsight é útil para explorar bancos de dados e outros objetos e pesquisar objetos.

Configuração de codificação¶

-- Set up environment.
USE ROLE samooha_app_role;
USE WAREHOUSE app_wh;

-- Call your clean rooms API functions.
...

GRANT USAGE ON WAREHOUSE <your warehouse> TO SAMOOHA_APP_ROLE;`

Configuração de contas, usuários e funções¶

Tecnicamente, você não precisa usar a UI de clean rooms para desenvolver clean rooms: a maior parte da funcionalidade da clean room está disponível usando procedimentos armazenados. No entanto, alguns recursos estão disponíveis somente na UI, e alguns são mais rápidos de executar na UI. E como muitos usuários usam exclusivamente a UI, é importante ver como sua clean room se comporta na UI, especialmente se você criar um formulário Web de configuração do usuário para uma clean room que tenha criado. Portanto, você deve solicitar a um administrador de clean room que o adicione como gerente de clean room ou superior nas contas de clean room apropriadas.

Recomendamos, no mínimo, que você tenha contas Snowflake separadas de provedor e consumidor para testar os dois lados de uma clean room. Dependendo do seu caso de uso, você também pode querer configurar uma conta Snowflake adicional em diferentes regiões de hospedagem na Web para testar o comportamento entre nuvens.

Nomeie suas contas Snowflake de teste de forma significativa para indicar seu uso típico: por exemplo, “Conta de consumidor”, “Conta de provedor” e “Conta entre nuvens” Isso pode ajudar quando você tem várias contas de teste e precisa saber em qual delas deve fazer login.

Confirme se você está usando a mesma conta na UI de clean rooms e no código¶

Muitas vezes, você precisa abrir um ambiente de codificação e a UI de clean rooms para a mesma conta Snowflake, por exemplo, ao criar uma clean room no código e depois verificar sua aparência na UI de clean rooms. É importante confirmar que você está usando a mesma conta Snowflake em cada uma delas.

O Snowsight não tem um atalho para abrir a UI de clean rooms para a mesma conta, ou o contrário, portanto, você deve se certificar de que a UI de clean rooms e o Snowsight estejam abertos na mesma conta.

Nome de clean room vs. ID de clean room¶

Ao usar a API, para procedimentos que precisam de um argumento cleanroom_name, determine se você deve usar o nome de clean room ou o ID de clean room da seguinte forma:

• Se a clean room tiver sido criada usando a API, use o nome de clean room.

• Se a clean room tiver sido criada no aplicativo da Web, use o ID de clean room. Você pode ver o nome e o ID da clean room chamando provider.view_cleanrooms ou provider.describe_cleanroom.

Atualize sua clean room sempre que fizer alterações¶

Para alterar qualquer configuração de clean room, inclusive modelos, permissões ou políticas, chame provider.create_or_update_cleanroom_listing para ativar as alterações. Em alguns casos, as alterações podem ser visíveis antes de chamar esse procedimento, mas só serão aplicadas corretamente depois que você chamar provider.create_or_update_cleanroom_listing.

Interoperabilidade entre clean rooms criadas em código ou na UI¶

Quando você cria uma clean room na API, alguns recursos não podem ser modificados na UI de clean rooms. Por exemplo, você não pode adicionar modelos adicionais, nem mesmo modelos Snowflake de estoque, no código de uma clean room criada por UI. Você também não pode alterar as configurações de privacidade diferencial.

(Consumidor) Não é possível definir políticas de associação ou executar outras ações básicas em uma clean room associada¶

Confirme se você instalou sua clean room com a função adequada (SAMOOHA_APP_ROLE). Se você não tiver usado SAMOOHA_APP_ROLE ao instalar a clean room, encontrará muitos problemas, geralmente erros de permissão. Se esse for o caso, até mesmo consumer.uninstall_cleanroom falhará e você deverá tomar medidas adicionais para desinstalar e reinstalar a clean room com a função correta.

-- Who owns the clean room?
SHOW SHARES LIKE 'SAMOOHA_CLEANROOM_REQUESTS_<cleanroom_name>';

-- If the owner role is not SAMOOHA_APP_ROLE, you must drop the share, then
-- uninstall the clean room.
DROP SHARE SAMOOHA_CLEANROOM_REQUESTS_<cleanroom_name>;
CALL samooha_by_snowflake_local_db.consumer.uninstall_cleanroom($cleanroom_name);
USE ROLE samooha_app_role;
CALL samooha_by_snowflake_local_db.consumer.install_cleanroom($cleanroom_name, '<provider_locator>');

Resultados gerais inesperados¶

Certifique-se de chamar a versão de consumer ou provider adequada de seu procedimento. Muitos procedimentos têm versões para provedores e consumidores.

Não é possível encontrar uma clean room que você tenha criado¶

Se você criou uma clean room em uma conta, mas não consegue vê-la na conta de colaborador, aqui estão alguns motivos possíveis:

• A clean room foi criada em uma região de hospedagem em nuvem diferente e você não habilitou o preenchimento automático entre nuvens.

• Você não publicou sua clean room chamando provider.create_or_update_cleanroom_listing.

• Você está chamando consumer.view_cleanrooms() em vez de provider.view_cleanrooms() (ou o contrário).

• Você não compartilhou a clean room, compartilhou a clean room com a conta errada ou abriu a conta de colaborador errada no Snowsight ou na UI/CLI de Clean rooms. Confirme se a conta com a qual espera ver sua clean room é aquela com a qual compartilhou a clean room e se você está conectado a essa conta compartilhada.

• Há um pequeno atraso entre a publicação de uma clean room e o momento em que ela se torna visível ao colaborador.

Função desconhecida¶

Se você chamar um procedimento e receber um erro como este: … code-block:: sqlexample

Função desconhecida definida pelo usuário SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.CONSUMER. <nome do procedimento>

Você não tem SAMOOHA_APP_ROLE ou digitou incorretamente o nome da função.

Isso também pode significar que o usuário recebeu uma função de execução de acesso limitado e que a função que está chamando não é permitida pela sua função. Você pode testar isso tentando executar um dos procedimentos permitidos para consumer.grant_run_on_cleanrooms_to_role. Se o procedimento for bem-sucedido, você pode estar usando uma função limitada. Se falhar, é provável que você não tenha permissão para executar a API de clean rooms nessa conta.

Para verificar se você tem a função SAMOOHA_APP_ROLE, execute o seguinte comando:

SELECT IS_ROLE_IN_SESSION( 'SAMOOHA_APP_ROLE' );

Se você receber o seguinte erro:

Database <cleanroom name> does not exist or not authorized. in RUN_ANALYSIS_STRING

Você recebeu uma função de execução temporária que foi revogada. Solicite a um administrador de clean rooms uma nova função de execução ou acesso total à função SAMOOHA_APP_ROLE.

Verifique seu histórico de consultas¶

Você pode verificar seu histórico de consultas para consultas executadas na UI ou no código. Esses históricos são armazenados e verificados separadamente.