Problembehandlung für Collaboration Data Clean Rooms

Beachten Sie die folgenden Tipps zur Problembehandlung, wenn Sie bei der Arbeit mit Collaboration Data Clean Rooms auf Fehler stoßen.

Zusammenarbeit

Fehler:

Ausstehende Einladung zur Zusammenarbeit: <collaboration name> nicht gefunden, obwohl GET_STATUS für das Konto INVITED anzeigt.

Ursache:

Wenn ein erster Verknüpfungsversuch aus irgendeinem Grund fehlgeschlagen ist, werden spätere Verknüpfungsversuche wahrscheinlich auch aus diesem Grund fehlschlagen.

Lösung:

Löschen Sie die Zusammenarbeit, und erstellen Sie sie neu.


 

Fehler:

Eine von Ihnen erstellte Zusammenarbeit ist im Konto eines Teilnehmers nicht sichtbar.

Ursache:

Es gibt mehrere mögliche Gründe:

  • Die Zusammenarbeit wurde in einer anderen Cloudhosting-Region erstellt und Sie haben die :doc:` Cloud-übergreifende automatische Ausführung</user-guide/cleanrooms/laf>` nicht aktiviert.

  • Sie haben die Zusammenarbeit nicht freigegeben, Sie haben die Zusammenarbeit mit dem falschen Konto freigegeben oder Sie haben das falsche Teilnehmerkonto in Snowsight/SDCR UI/CLI geöffnet. Vergewissern Sie sich, dass das Konto, in dem Sie die Zusammenarbeit erwarten, das Konto ist, mit dem Sie die Zusammenarbeit freigegeben haben, und dass Sie bei diesem gemeinsamen Konto angemeldet sind.

  • Es gibt eine kleine Verzögerung zwischen der Veröffentlichung einer Zusammenarbeit und dem Zeitpunkt, ab dem sie für den Teilnehmer sichtbar wird.

Lösung:

Überprüfen Sie, ob das Konto des Teilnehmers mit dem in Ihrer Zusammenarbeitsspezifikation übereinstimmt und ob die Cloud-übergreifende automatische Ausführung aktiviert ist, falls erforderlich. Warten Sie einen Moment, bis sich die Zusammenarbeit eingestellt hat.


 

Fehler:

ReferenceUsageGrantMissingException: Reference usage grants are required for the following databases in your account ..., wenn ein Datenanbieter versucht, der Zusammenarbeit beizutreten. Datenanbieter sehen diese Meldung, wenn sie versuchen, einer Zusammenarbeit beizutreten und Daten freigegeben haben, für die sie nicht die REFERENCE_USAGE-Berechtigung haben. Dies ist ein erwartetes Verhalten.

Lösung:

Die Fehlermeldung enthält einen Datenbanknamen und einen Freigabenamen. Es muss entweder ein Benutzender mit der Rolle REFERENCE_USAGE für die Daten oder ein ACCOUNTADMIN den folgenden SQL-Befehl ausführen und dabei die in der Fehlermeldung genannten Namen für die Datenbank und Freigabe bereitstellen:

GRANT REFERENCE_USAGE ON DATABASE <database_name> TO SHARE <share_name>;

Nach der erfolgreichen Gewährung von REFERENCE_USAGE kann der Datenanbieter der Zusammenarbeit beitreten.

API und Berechtigungen

Fehler:

Unbekannte benutzerdefinierte Funktion <function name>

Ursache:

Wenn dies ein Verfahren ist, das für die DCR-Zusammenarbeits-API dokumentiert ist, liegt möglicherweise ein Rechtschreibfehler des Prozedurnamens vor.

Wenn Sie den Prozedurnamen nicht falsch geschrieben haben oder wenn die Prozedur eine Systemprozedur ist (d. h. sie hat $ im Namen), verwenden Sie möglicherweise eine ältere Version der API und müssen die API-Version Ihrer Clean Rooms aktualisieren.

Lösung:
  • Vergewissern Sie sich, dass Sie die Prozedur korrekt geschrieben haben, und falls dies nicht der Fall ist, versuchen Sie es erneut mit der korrekten Schreibweise.

  • Um die Installation zu aktualisieren, führen Sie den folgenden SQL-Code aus:

USE ROLE ACCOUNTADMIN;
CALL SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.PREPARE_MOUNT_SCRIPT();
EXECUTE IMMEDIATE FROM @SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.MOUNT_CODE_STAGE/dcr_loader.sql;

 

Fehler:

Listing 'listing name' is not fulfilled to your current region. Please request the listing, or if already requested, retry after some time

Ursache:

Sie verwenden eine ältere Version der Clean Rooms-API. Dieses Problem wurde in einer neueren Version behoben.

Lösung:

Aktualisieren Sie Ihre Clean Room-Installation.


 

Fehler:

SQL compilation error: Unknown user-defined function SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.RUN

Ursache:

Entweder haben Sie einen Teil des vollqualifizierten Prozedurnamens falsch geschrieben, oder Sie haben nicht die Berechtigung, diese Prozedur auszuführen.

Lösung:

Prüfen Sie, ob Sie den korrekten Namen der Prozedur verwendet haben. Wenn Sie SAMOOHA_APP_ROLE nicht verwenden, versuchen Sie, zu dieser Rolle zu wechseln, um zu sehen, ob derselbe Fehler auftritt. Wenn dies nicht der Fall ist, handelt es sich um einen Berechtigungsfehler.


 

Fehler:

Unbekannte benutzerdefinierte Funktion SAMOOHA_BY_SNOWFLAKE_LOCAL_DB<namespace><procedure name>

Ursache:

Eine der folgenden Berechtigungen:

  • Sie haben den falschen Namespace verwendet. Stellen Sie sicher, dass Sie die richtige COLLABORATION oder den richtigen REGISTRY-Namespace aufrufen.

  • Sie haben den Namen der Funktion falsch eingegeben. Suchen Sie im Referenzhandbuch nach der richtigen Benennung.

  • Sie verwenden eine RBAC-Rolle, die keine Berechtigung zum Aufrufen der Prozedur hat.

  • Sie haben die SAMOOHA_APP_ROLE nicht.

Lösung:
  • Vergewissern Sie sich, dass Sie die Prozedur korrekt geschrieben und den richtigen Namespace verwendet haben.

  • Versuchen Sie, zu SAMOOHA_APP_ROLE zu wechseln, um zu sehen, ob Sie die Prozedur ausführen können. Wenn Sie können, dann liegen Sie an den unzureichenden Berechtigungen für Ihre aktuelle Rolle. Bitten Sie jemanden mit SAMOOHA_APP_ROLE, Ihnen die richtigen Berechtigungen zu gewähren.

  • Führen Sie den folgenden Befehl aus, um zu überprüfen, ob Sie die SAMOOHA_APP_ROLE haben:

SELECT CURRENT_USER();
SHOW GRANTS TO USER <current_user_name> ->> SELECT * FROM $1 WHERE "role" = 'SAMOOHA_APP_ROLE';

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

Code-Bundle

Fehler:

CodeSpecAlreadyExistsException

Ursache:

Code-Bundle-Spezifikation mit demselben Namen und bereits registrierter Version.

Lösung:

Verwenden Sie eine andere Version oder aktualisieren Sie die bestehende Version.


 

Fehler:

SpecValidationError

Ursache:

YAML stimmt nicht mit dem Schema überein.

Lösung:

Überprüfen Sie die erforderlichen Felder und das Format.


 

Fehler:

CodeSpecStageNotAccessibleError

Ursache:

Der in Artefakt referenzierte Stagingbereich ist nicht zugänglich.

Lösung:

Gewähren Sie Zugriff auf den Stagingbereich oder überprüfen Sie, ob der Stagingbereich vorhanden ist.


 

Fehler:

CodeSpecArtifactNotFoundAtStageError

Ursache:

Datei nicht im angegebenen Stagingbereichspfad gefunden.

Lösung:

Laden Sie die Datei vor der Registrierung in den Stagingbereich hoch.


 

Fehler:

StageDirectoryNotEnabledError

Ursache:

DIRECTORY ist nicht für den Stagingbereich aktiviert.

Lösung:

Aktivieren Sie das Verzeichnis für den Stagingbereich: ALTER STAGE ... SET DIRECTORY = (ENABLE = TRUE)


 

Fehler:

CodeSpecNotFoundForOwnerException

Ursache:

Vorlage verweist auf nicht registrierte Code-Bundle-Spezifikation.

Lösung:

Registrieren Sie die Code-Bundle-Spezifikation, bevor Sie die Vorlage registrieren.