DOCUMENTATION
/
Erste Schritte
Benutzerhandbücher
Entwickler
Referenz
Releases
Tutorials
Snowflake Open Catalog
Status
  1. Erste Schritte
  2. Überblick
    • Zugriffssteuerung
      • Tutorial
        • Zugriff auf Snowflake Open Catalog
        • Testen Sie Snowflake Open Catalog kostenlos
          • Ein Snowflake Open Catalog-Konto erstellen
            • Anmelden
              • Snowflake Open Catalog absichern
              • Anmelden für MFA
                • Netzwerkrichtlinien verwenden, um den Zugriff auf Snowflake Open Catalog zu beschränken
                  • SSO
                  • Eingehende private Konnektivität
                      1. AWS PrivateLink und Snowflake Open Catalog
                        • Azure Private Link und Snowflake Open Catalog
                          • UI private Konnektivität konfigurieren
                        • Ausgehende private Konnektivität
                        • Konten
                        • Benutzer verwalten
                          • Kontonamen suchen
                            • Einrichten von Katalogen
                            • Externen Cloud-Speicher für einen Katalog erstellen
                              • Einen Katalog erstellen
                                • Automatische Erzeugung von Anmeldeinformationen für einen externen Katalog aktivieren
                                  • Eine Katalogrolle erstellen
                                    • Eine Prinzipalrolle erstellen
                                      • Eine Dienstverbindung konfigurieren und entfernen
                                        • Eine Dienstverbindung registrieren
                                          • Verwalten von Katalogen
                                          • Kataloginhalt organisieren
                                            • Sichere Kataloge
                                              • Ansicht des Schemas für eine Tabelle in Snowflake Open Catalog
                                                • Abfragen von Daten in Katalogen
                                                • Abfrage einer Tabelle in Snowflake Open Catalog mit Snowflake
                                                  • Eine von Snowflake verwaltete Tabelle mit Snowflake Open Catalog synchronisieren
                                                    • Abfrage einer Tabelle in Snowflake Open Catalog mit einer Engine eines Drittanbieters
                                                      • Code-Beispiele
                                                      • Apache Spark
                                                        • Releases
                                                        • Versionshinweise
                                                          Snowflake Open CatalogEingehende private KonnektivitätAzure Private Link und Snowflake Open Catalog

                                                          Azure Private Link und Snowflake Open Catalog¶

                                                          Business Critical-Feature <https://docs.snowflake.com/en/user-guide/intro-editions>_

                                                          Dieses Feature erfordert Business Critical (oder höher).

                                                          Wenn Sie sich über ein Upgrade informieren möchten, wenden Sie sich an den Snowflake Support <https://docs.snowflake.com/user-guide/contacting-support>_.

                                                          Feature – Allgemein verfügbar

                                                          In Regionen für Regierungsbehörden nicht verfügbar.

                                                          In diesem Thema wird beschrieben, wie Sie Azure Private Link konfigurieren, um Ihr Snowflake Open Catalog-Konto direkt mit Ihrer Abfrage-Engine zu verbinden, indem Sie eine eingehende private Konnektivität verwenden.

                                                          Voraussetzungen¶

                                                          • Ihr Snowflake Open Catalog-Konto wird auf Azure gehostet.

                                                          • Sie verfügen über die notwendigen Berechtigungen, um Ihren DNS-Dienst mit der privaten Konnektivitäts-URL für Ihr Open Catalog-Konto zu konfigurieren.

                                                          Schritt 1: Rufen Sie die Einstellungen Ihres Open Catalog-Kontos ab¶

                                                          Rufen Sie die folgenden Einstellungen für die Konfiguration des Zugriffs auf Open Catalog mit Azure Private Link ab.

                                                          1. Melden Sie sich bei Snowflake Open Catalog an.

                                                          2. Wählen Sie im Navigationsmenü Settings aus.

                                                          3. Kopieren Sie auf der Seite „Settings“ die Werte für die folgenden Einstellungen in einen Texteditor:

                                                            • PrivateLink-Konto-URL

                                                            • URL Für regionenloses PrivateLink-Konto

                                                            • PrivateLink-OCSP-URL

                                                            • Regionslose PrivateLink-OCSP-URL

                                                            • Private-Link-Dienst-ID

                                                          Sie fügen diese Werte ein, wenn Sie Zugriff auf Open Catalog mit Azure Private Link konfigurieren und eine Verbindung zu Open Catalog über Azure Private Link herstellen.

                                                          Eine Beschreibung der einzelnen Einstellungen finden Sie unter Rückgabewerte für die Systemfunktion SYSTEM $ GET_PRIVATELINK_CONFIG in der Snowflake-Dokumentation. In diesem Thema sind die Namen der Kontoeinstellungen im Format JSON angegeben.

                                                          Bemerkung

                                                          Denken Sie daran, dass sich die Beschreibung ggf. auf ein Snowflake-Konto bezieht, Ihr Wert aber tatsächlich für Ihr Snowflake Open Catalog-Konto gilt. Die privatelink-account-url ist zum Beispiel die URL für Ihr Snowflake Open Catalog-Konto.

                                                          • Optional: Um diese Werte im Format JSON abzurufen, erstellen Sie eine Snowflake CLI-Verbindung für Open Catalog und rufen Sie dann die Systemfunktion SYSTEM$GET_PRIVATELINK_CONFIG auf.

                                                          Schritt 2: Konfigurieren Sie den Zugriff auf Open Catalog mit Azure Private Link¶

                                                          Achtung

                                                          Dieser Abschnitt behandelt nur die Open Catalog-spezifischen Details zur Konfiguration Ihrer VNet-Umgebung. Beachten Sie außerdem, dass Snowflake nicht für die tatsächliche Konfiguration der notwendigen Firewall-Anpassungen und DNS-Einträge verantwortlich ist. Wenn Sie Probleme mit einer dieser Konfigurationsaufgaben haben, wenden Sie sich direkt an den Microsoft Support.

                                                          In diesem Abschnitt wird beschrieben, wie Sie Ihr VNet über Azure Private Link mit dem Open Catalog-VNet verbinden.

                                                          Um die Anweisungen auszuführen, müssen Sie Azure CLI oder Azure PowerShell verwenden. Hilfe zur Installation finden Sie in der Microsoft-Dokumentation für Azure CLI oder Azure PowerShell.

                                                          Nachdem Sie die Verbindung zu Snowflake Open Catalog über Azure Private Link initiiert haben, können Sie den Genehmigungsstatus der Verbindung im Azure-Portal ermitteln.

                                                          Erstellen Sie einen privaten Endpunkt.¶

                                                          Bemerkung

                                                          Wenn Sie bereits einen privaten Endpunkt für Ihr Snowflake-Konto erstellt haben und das Konto sich in der gleichen Bereitstellung wie Ihr Open Catalog-Konto befindet, ist die Erstellung eines neuen privaten Endpunkts für Ihr Open Catalog-Konto nicht erforderlich. Sie können diesen Schritt auch überspringen.

                                                          1. Rufen Sie die Details Ihres Azure-Kontos ab. Das folgende Beispiel verwendet den Befehl az account list der Azure CLI.

                                                            Name     CloudName   SubscriptionId                        State    IsDefault
                                                            -------  ----------  ------------------------------------  -------  ----------
                                                            MyCloud  AzureCloud  13c...                                Enabled  True
                                                            
                                                            Copy
                                                          2. Suchen Sie im Azure-Portal nach Private Link, und wählen Sie dann Private Link in den Ergebnissen.

                                                            Konzeptionsdiagramm von Open Catalog

                                                          3. Klicken Sie auf Private endpoints, und dann auf Add.

                                                            Konzeptionsdiagramm von Open Catalog.

                                                          4. Auf der Registerkarte Basics füllen Sie die Felder Subscription, Resource group, Name und Region für Ihre Umgebung aus und klicken dann auf Next: Resource.

                                                          5. Wählen Sie auf der Registerkarte Resource für Connection method Connect to an Azure resource by resource ID or alias.

                                                          6. Geben Sie für Resource ID or alias den Wert für Private Link Service ID ein, den Sie erhalten haben, als Sie Ihre Open Catalog-Kontoeinstellungen für private Konnektivität abgerufen haben.

                                                            Wenn Sie eine Fehlermeldung bezüglich des Alias-Wertes erhalten, wenden Sie sich an den Snowflake-Support, um den Wert der Ressourcen-ID zu erfahren, und wiederholen Sie diesen Schritt dann mit diesem Wert.

                                                          Wenn der private Endpunkt genehmigt ist, zeigt CONNECTION STATE im Abschnitt „Private endpoints“ auf der Seite „Private Link Center“ den Wert Pending an. Dieser Wert ändert sich in Approved, wenn Sie die Autorisierung im nächsten Verfahren abschließen.

                                                          Private Konnektivität für eingehende Verbindungen aktivieren¶

                                                          In diesem Verfahren aktivieren Sie Azure Private Link für Ihr Open Catalog-Konto. Diese Konfiguration ermöglicht es der Abfrage-Engine, sich über eine private Konnektivität mit Open Catalog zu verbinden. Sie benötigen Ihre Ressourcen-ID des privaten Endpunkts, eine Abonnement-ID und den Wert des Verbundtokens, der die Zugangsdaten für einen Benutzer im Verbund enthält.

                                                          1. Um diese Werte zu erhalten, führen Sie die folgenden Befehle in der Azure CLI aus:

                                                            1. Um Ihre Ressourcen-ID für den privaten Endpunkt zu erhalten, führen Sie den folgenden Befehl aus, und kopieren Sie den Wert in einen Texteditor:

                                                              az network private-endpoint show
                                                              
                                                              Copy
                                                            2. Um die Abonnement-ID zu erhalten, führen Sie den folgenden Befehl aus und notieren den Wert in der Spalte SubscriptionID in der Ausgabe:

                                                              az account list --output table
                                                              
                                                              Copy
                                                            3. Um den Wert des Verbundtokens zu erhalten, führen Sie den folgenden Befehl aus und kopieren den accessToken-Wert in einen Texteditor:

                                                              az account get-access-token --subscription <SubscriptionID>
                                                              
                                                              Copy
                                                              • Dabei ist SubscriptionID der eindeutige Bezeichner, den Sie im vorherigen Schritt erhalten haben.

                                                              Wichtig

                                                              Der Benutzer, der das Azure-Zugriffstoken generiert, muss über Leseberechtigungen das Abonnement verfügen. Die Berechtigung mit den geringsten Rechten ist Microsoft.Subscription/subscriptions/acceptOwnershipStatus/read. Alternativ dazu erteilt die Standardrolle Reader gröbere Berechtigungen.

                                                              Der accessToken-Wert ist eine vertrauliche Information und sollte wie ein Kennwort behandelt werden — geben Sie diesen Wert nicht weiter.

                                                              Wenn es erforderlich ist, den Snowflake-Support zu kontaktieren, löschen Sie erst das Zugriffstoken aus allen Befehlen und URLs, bevor Sie ein Support-Ticket erstellen.

                                                          2. Melden Sie sich bei Snowflake Open Catalog an.

                                                          3. Wählen Sie im Navigationsmenü Settings aus.

                                                          4. Wählen Sie Authorize aus.

                                                          5. Aktivieren Sie im Dialog „Authorize Private Link“ die private Konnektivität für Ihr Konto:

                                                            1. Geben Sie unter ID die Ressourcen-ID des privaten Endpunkts ein, die Sie in einen Texteditor kopiert haben.

                                                            2. Geben Sie unter Federated token den Wert des Verbundtokens ein, den Sie in einen Texteditor kopiert haben.

                                                            3. Wählen Sie Save aus.

                                                          Prüfen Sie, ob Ihr Konto autorisiert ist¶

                                                          Gehen Sie wie folgt vor, um zu überprüfen, ob Ihr Open Catalog-Konto für die private Konnektivität zum Snowflake Open Catalog-Dienst autorisiert ist.

                                                          1. Melden Sie sich bei Snowflake Open Catalog an.

                                                          2. Wählen Sie im Navigationsmenü Settings aus.

                                                          3. Wählen Sie Get aus.

                                                          4. Verifizieren Sie Ihr Konto im Dialogfenster für die Autorisierung von Private Links:

                                                            1. Geben Sie in das Feld ID Ihre Ressource-ID des privaten Endpunkts ein. Sie haben diesen Wert abgerufen, als Sie die eingehende private Konnektivität aktiviert haben.

                                                            2. Geben Sie in das Feld Federated token den Wert des Verbundtokens ein. Sie haben diesen Wert abgerufen, als Sie die eingehende private Konnektivität aktiviert haben.

                                                            3. Wählen Sie Save aus. Es erscheint eine Meldung, die angibt, ob Ihr Konto autorisiert ist.

                                                          DNS einrichten¶

                                                          Alle Anfragen an Open Catalog müssen über den privaten Endpunkt geroutet werden. Um das Open Catalog-Konto und OCSP-URLs auf die private IP-Adresse Ihres privaten Endpunktes aufzulösen, aktualisieren Sie Ihren DNS.

                                                          1. Um die Adresse der Endpunkt-IP zu erhalten, geben Sie in der Suchleiste des Azure-Portals den Namen des privaten Endpunkts ein, den Sie erstellt haben.

                                                          2. Wählen Sie das Ergebnis „Network Interface“.

                                                            Konzeptdiagramm von Open Catalog.

                                                          3. Kopieren Sie den Wert für die private IP-Adresse.

                                                            Konzeptionsdiagramm von Open Catalog

                                                          4. Konfigurieren Sie Ihren DNS so, dass die entsprechenden Endpunktwerte aus den Einstellungen Ihres Open Catalog Kontos für private Konnektivität auf die private IP-Adresse aufgelöst werden.

                                                          Schritt 3: Verbinden Sie sich mit Open Catalog über Azure Private Link¶

                                                          • Um eine Dienstverbindung zu registrieren und Ihre Abfrage-Engine über Azure Private Link mit Open Catalog zu verbinden, verwenden Sie den folgenden Code:

                                                            import pyspark
                                                            from pyspark.sql import SparkSession
                                                            
                                                            spark = SparkSession.builder.appName('iceberg_lab') \
                                                              .config('spark.jars.packages', 'org.apache.iceberg:iceberg-spark-runtime-3.5_2.12:1.4.1,<maven_coordinate>') \
                                                              .config('spark.sql.extensions', 'org.apache.iceberg.spark.extensions.IcebergSparkSessionExtensions') \
                                                              .config('spark.sql.defaultCatalog', 'opencatalog') \
                                                              .config('spark.sql.catalog.opencatalog', 'org.apache.iceberg.spark.SparkCatalog') \
                                                              .config('spark.sql.catalog.opencatalog.type', 'rest') \
                                                              .config('spark.sql.catalog.opencatalog.uri','https://<open_catalog_privatelink_account_url>/polaris/api/catalog') \
                                                              .config('spark.sql.catalog.opencatalog.header.X-Iceberg-Access-Delegation','vended-credentials') \
                                                              .config('spark.sql.catalog.opencatalog.credential','<client_id>:<client_secret>') \
                                                              .config('spark.sql.catalog.opencatalog.warehouse','<catalog_name>') \
                                                              .config('spark.sql.catalog.opencatalog.scope','PRINCIPAL_ROLE:<principal_role_name>') \
                                                              .getOrCreate()
                                                            
                                                            Copy

                                                          Parameter¶

                                                          Bemerkung

                                                          Stellen Sie sicher, dass Sie Ihren DNS-Dienst so einrichten, dass er dem Wert entspricht, den Sie für <open_catalog_account_identifier> angeben.

                                                          Parameter

                                                          Beschreibung

                                                          <catalog_name>

                                                          Gibt den Namen des Katalogs an, mit dem eine Verbindung hergestellt werden soll.

                                                          Wichtig:
                                                          <catalog_name> unterscheidet Groß- und Kleinschreibung.

                                                          <maven_coordinate>

                                                          Gibt die Maven-Koordinate für Ihren externen Anbieter von Cloud Storage an:

                                                          • S3: software.amazon.awssdk:bundle:2.20.160
                                                          • Cloud Storage (von Google): org.apache.iceberg:iceberg-gcp-bundle:1.5.2
                                                          • Azure: org.apache.iceberg:iceberg-azure-bundle:1.5.2
                                                          Wenn Sie diesen Parameter nicht sehen, ist der richtige Wert bereits im Codebeispiel angegeben.

                                                          <client_id>

                                                          Gibt die Client-ID an, die der Dienstprinzipal verwenden soll.

                                                          Geben Sie die Client-ID ein, die Sie bei der Konfiguration einer neuen Dienstverbindung kopiert haben.

                                                          <client_secret>

                                                          Legt das Client-Geheimnis fest, das der Dienstprinzipal verwenden soll.

                                                          Geben Sie das Secret ein, das Sie bei der Konfiguration einer neuen Dienstverbindung kopiert haben.

                                                          <open_catalog_privatelink_account_url>

                                                          Gibt die URL für die Verbindung zu Ihrem Snowflake Konto über den AWS-PrivateLink oder Azure Private Link an.

                                                          Geben Sie einen der folgenden Werte ein, die Sie beim Abrufen Ihrer Open Catalog-Kontoeinstellungen kopiert haben:

                                                          • PrivateLink Account URL
                                                          • Regionless PrivateLink Account URL
                                                          For details on retrieving your Open Catalog account settings, see the instructions for the cloud platform where your Open Catalog account is hosted:

                                                          • AWS
                                                          • Azure

                                                          <principal_role_name>

                                                          Gibt die Prinzipalrolle an, die dem Dienstprinzipal gewährt wird.

                                                          Um diese Prinzipalrolle zu sehen, wählen Sie in Open Catalog die Seite Connections, wählen Ihre Service-Verbindung aus und gehen im Dialog Principal Details zu Principal Roles.

                                                          Schritt 4 (Optional): Erstellen Sie eine Katalogintegration für Snowflake¶

                                                          Wenn Sie Snowflake zur Abfrage von mit Open Catalog verwalteten Tabellen verwenden, erstellen Sie einen Katalog für Snowflake, der eine private IP-Adresse verwendet. Um diese Katalogintegration zu erstellen, muss sich Ihr Snowflake-Konto in der gleichen Bereitstellung befinden wie Ihr Open Catalog-Konto.

                                                          Ein Beispiel finden Sie unter Beispiel: Katalogintegration, die eine private IP-Adresse verwendet <https://docs.snowflake.com/en/user-guide/tables-iceberg-open-catalog-query#example-catalog-integration-that-uses-a-private-ip-address>_ in der Snowflake Dokumentation.

                                                          Bemerkung

                                                          Sie können auch private Konnektivität für die Snowflake Open Catalog UI konfigurieren. Diese Konfiguration in Verbindung mit der Konfiguration der privaten Konnektivität für Ihr Open Catalog-Konto ermöglicht Ihnen den Zugriff auf die Open Catalog UI über private Konnektivität statt über das öffentliche Internet.

                                                          Um diesen Zugang zu konfigurieren, siehe Private Konnektivität für Snowflake Open Catalog konfigurieren UI.

                                                          War diese Seite hilfreich?

                                                          Besuchen Sie Snowflake
                                                          An Diskussion beteiligen
                                                          Mit Snowflake entwickeln
                                                          Teilen Sie Ihr Feedback mit
                                                          Lesen Sie Neuigkeiten in unserem Blog
                                                          Eigene Zertifizierung erhalten
                                                          DatenschutzNutzungsbedingungen© 2025 Snowflake, Inc. Alle Rechte vorbehalten.

                                                          Ergänzende Dokumentation

                                                          Für die auf dieser Seite aufgeführten Features können zusätzliche Nutzungsbedingungen gelten.

                                                          1. Voraussetzungen
                                                          2. Schritt 1: Rufen Sie die Einstellungen Ihres Open Catalog-Kontos ab
                                                          3. Schritt 2: Konfigurieren Sie den Zugriff auf Open Catalog mit Azure Private Link
                                                          4. Schritt 3: Verbinden Sie sich mit Open Catalog über Azure Private Link
                                                          5. Schritt 4 (Optional): Erstellen Sie eine Katalogintegration für Snowflake
                                                          Sprache: Deutsch
                                                          • English
                                                          • Français
                                                          • Deutsch
                                                          • 日本語
                                                          • 한국어
                                                          • Português