Snowflake Data Clean Rooms-Entwicklerhandbuch¶

Entwicklungs-Tools¶

Hier sind die wichtigsten Entwickler-Tools für Clean Rooms:

• Codierungsumgebung: Jede Codierungsumgebung, die gespeicherte Prozeduren in Ihrem Snowflake-Konto ausführen kann, funktioniert. Die meisten Entwickler verwenden Arbeitsblätter in Snowsight (dem browserbasierten Tool) oder das Snowflake CLI.

• Die Clean Room UI: Verwenden Sie die Clean Room UI, um Clean Rooms zu konfigurieren, zu verwalten oder zu erstellen. Die meisten Clean Room-Analysten verwenden eher die UI als einen Code, sodass es nützlich sein kann, die Nutzerfreundlichkeit Ihrer Clean Rooms in der UI zu sehen und zu testen. Außerdem gibt es eine Handvoll Features, die nur in der Clean Room UI verfügbar sind.

• Snowsight ist nützlich, um Datenbanken und andere Objekte zu erkunden und nach Objekten zu suchen.

Codierung einrichten¶

-- 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;`

Konten, Benutzer und Rollen einrichten¶

Sie müssen nicht die Clean Rooms-UI zum Entwickeln von Clean Rooms verwenden: Die meisten Clean Room-Funktionen sind über gespeicherte Prozeduren verfügbar. Einige Funktionen sind jedoch nur in der UI verfügbar und einige werden in der UI schneller ausgeführt. Und weil viele Benutzer ausschließlich die UI verwenden, ist es wichtig zu sehen, wie sich Ihr Clean Room in der UI verhält, insbesondere wenn Sie ein Webformular zur Benutzerkonfiguration für einen von Ihnen erstellten Clean Room erstellen. Daher sollten Sie einen Clean Room-Administrator bitten, Sie in den entsprechenden Clean Room-Konten als Clean Room-Manager oder höher hinzuzufügen.

Abhängig von Ihrem Anwendungsfall sollten Sie möglicherweise in verschiedenen Webhosting-Regionen ein zusätzliches Snowflake-Konto einrichten, um Cloud-übergreifendes Verhalten zu testen.

Geben Sie Ihren Test-Snowflake-Konten aussagekräftige Namen, um ihre typische Verwendung zu kennzeichnen: zum Beispiel „Verbraucherkonto“, „Anbieterkonto“ und „Cloud-übergreifendes Konto“. Dies kann hilfreich sein, wenn Sie mehrere Konten haben und wissen müssen, bei welchem Sie sich anmelden müssen.

Sicherstellen, dass Sie das gleiche Konto in der Clean Room UI und im Code verwenden¶

Häufig müssen Sie eine Codingumgebung und die Clean Room UI für dasselbe Snowflake-Konto öffnen, z. B. wenn Sie einen Clean Room im Code erstellen und dann sein Aussehen in der Clean Room UI überprüfen. Es ist wichtig, dass Sie sich vergewissern, dass Sie in beiden Konten das gleiche Snowflake-Konto verwenden.

Snowsight verfügt nicht über eine Verknüpfung, um die Clean Room UI für dasselbe Konto zu öffnen, oder umgekehrt. Sie müssen also sicherstellen, dass sowohl die Clean Room UI als auch Snowsight im selben Konto geöffnet sind.

Clean Room-Namen vs. Clean Room-ID¶

Wenn Sie die API verwenden, legen Sie bei Prozeduren, die ein cleanroom_name-Argument benötigen, wie folgt fest, ob Sie den Clean Room-Namen oder die Clean Room-ID verwenden:

• Wenn der Clean Room mit der API erstellt wurde, verwenden Sie den Namen des Clean Room.

• Wenn der Clean Room in der Clean Room-ID erstellt wurde, verwenden Sie die Clean Room-ID. Sie können sowohl den Namen des Clean Rooms als auch die ID sehen, indem Sie provider.describe_cleanroom oder provider.describe_cleanroom aufrufen.

Clean Room aktualisieren, wenn Sie Änderungen vornehmen¶

Um die Einstellungen für den Clean Room zu ändern, einschließlich Vorlagen, Berechtigungen oder Richtlinien, rufen Sie provider.create_or_update_cleanroom_listing auf, um die Änderungen zu aktivieren. In einigen Fällen können Änderungen bereits vor dem Aufruf dieser Prozedur sichtbar sein, aber die Änderungen werden erst nach dem Aufruf von provider.create_or_update_cleanroom_listing korrekt übernommen.

Interoperabilität zwischen Clean Rooms, die mit Code oder der UI erstellt wurden¶

Wenn Sie einen Clean Room in der API erstellen, sind einige Features in der Clean Room UI nicht änderbar. Sie können zum Beispiel keine zusätzlichen Vorlagen, auch keine Standard-Snowflake-Vorlagen, in den Code für einen per UI erstellten Clean Room einfügen. Sie können auch die Einstellungen für differentielle Privatsphäre nicht ändern.

Der Verbraucher kann keine Verknüpfungsrichtlinien festlegen oder andere grundlegende Aktionen für einen verknüpften Clean Room durchführen¶

Stellen Sie sicher, dass Sie Ihren Clean Room mit der richtigen Rolle installiert haben (SAMOOHA_APP_ROLE). Wenn Sie bei der Installation des Clean Room SAMOOHA_APP_ROLE nicht verwendet haben, werden Sie auf viele Probleme stoßen, typischerweise Berechtigungsfehler. Wenn dies der Fall ist, schlägt auch consumer.uninstall_cleanroom fehl und Sie müssen zusätzliche Schritte unternehmen, um den Clean Room zu deinstallieren und dann mit der richtigen Rolle neu zu installieren.

-- 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>');

Sie können keinen Clean Room finden, den Sie erstellt haben¶

Wenn Sie einen Clean Room in einem Konto erstellt haben, ihn aber im Konto des Teilnehmers nicht sehen können, kommen diese Gründe infrage:

• Der Clean Room wurde in einer anderen Cloud-Hosting-Region erstellt, und Sie haben die Cloud-übergreifende automatische Ausführung nicht aktiviert.

• Sie haben Ihren Clean Room nicht veröffentlicht, indem Sie provider.create_or_update_cleanroom_listing aufgerufen haben.

• Sie rufen consumer.view_cleanrooms() anstelle von provider.view_cleanrooms() auf (oder umgekehrt).

• Sie haben den Clean Room nicht freigegeben, Sie haben den Clean Room mit dem falschen Konto freigegeben oder Sie haben in der Snowsight/Clean Room UI/CLI das falsche Teilnehmerkonto geöffnet. Vergewissern Sie sich, dass das Konto, in dem Sie Ihren Clean Room sehen möchten, das Konto ist, mit dem Sie den Clean Room geteilt haben, und dass Sie in diesem gemeinsamen Konto angemeldet sind.

• Es gibt eine kleine Verzögerung zwischen der Veröffentlichung eines Clean Room und dem Zeitpunkt, an dem er für den Teilnehmer sichtbar wird.

Unbekannte Funktion¶

Wenn Sie eine Prozedur aufrufen und einen Fehler wie den folgenden Ausschnitt erhalten:

Unknown user-defined function SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.CONSUMER.<procedure name>

Hier sind einige mögliche Ursachen:

Sie haben den falschen Namespace eingegeben.

Stellen Sie sicher, dass Sie die richtige consumer- oder provider-Version Ihrer Prozedur aufrufen. Für viele Prozeduren gibt es sowohl Anbieter- als auch Verbraucherversionen.

Sie haben den Namen der Funktion falsch eingegeben.

Suchen Sie im Referenzhandbuch nach der richtigen Benennung.

Ihnen wurde eine eingeschränkte Ausführungsrolle zugewiesen und die Funktion, die Sie aufgerufen haben, wird von Ihrer Rolle nicht zugelassen.

Testen Sie dies, indem Sie den folgenden SQL-Code ausführen:

USE DATABASE samooha_by_snowflake_local_db;
CALL IS_DATABASE_ROLE_IN_SESSION('samooha_run_role');

Copy

Wenn der Codeausschnitt TRUE zurückgibt, haben Sie nur begrenzten Zugriff run-role-Berechtigungen für die Clean Room-API. Wenn Sie umfangreicheren Zugriff benötigen, bitten Sie einen Clean Room-Administrator um vollen Zugriff. Die Liste der zulässigen Ausführungsrollenprozeduren finden Sie in der consumer.grant_run_on_cleanrooms_to_role-Dokumentation.

Sie haben SAMOOHA_APP_ROLE nicht

Um zu sehen, ob Sie die SAMOOHA_APP_ROLE verwenden können, führen Sie den folgenden Befehl aus:

-- Get current user name.
SELECT current_user();

-- Add current user name in place as indicated.
SHOW GRANTS TO USER <current_user_name> ->> select * from $1 where "role" = 'SAMOOHA_APP_ROLE';

Copy

Wenn Sie keine Ergebnisse erhalten, bitten Sie einen Administrator, Ihnen API-Zugriff auf den Clean Room zur Verfügung zu stellen.

Sehen Sie, ob ein Benutzer einen Clean Room installiert hat¶

Sie können überprüfen, ob ein bestimmter Benutzer einen bestimmten Clean Room installiert hat, indem Sie den folgenden SQL-Code ausführen. Ersetzen Sie $consumer_locator und $cleanroom_name mit dem Verbraucher-Locator und dem Namen des Clean Rooms.

SELECT * FROM snowflake.data_sharing_usage.application_state
  WHERE consumer_account_locator = $consumer_locator
    AND CONTAINS(package_name, UPPER(REPLACE($cleanroom_name, ' ', '_')));

Den Verlauf Ihrer Abfrage oder Analyse prüfen¶

Sie können Ihren Abfrageverlauf für Analysen einsehen, die in der UI oder im Code durchgeführt wurden. Diese Verläufe werden separat gespeichert und geprüft.