Verwalten Sie private Konnektivitäts-Endpunkte für Snowflake Open Catalog: AWS¶

Bevor Sie beginnen¶

Um eine Snowflake CLI-Verbindung für Open Catalog zu erstellen, benötigen Sie Ihren vollständigen Bezeichner für das Open Catalog-Konto. Der Bezeichner des Kontos enthält den Namen Ihrer Snowflake-Organisation und den Namen Ihres Open Catalog-Kontos, zum Beispiel <orgname>.<my-snowflake-open-catalog-account-name>.

• Um Ihren Snowflake-Organisationsnamen (<orgname>) zu finden, siehe Suchen von Organisations- und Kontonamen eines Kontos <https://docs.snowflake.com/en/user-guide/admin-account-identifier.html#label-account-name-find>_.

• Um Ihren Snowflake Open Catalog-Kontonamen zu finden (<my-snowflake-open-catalog-account-name>), siehe Den Kontonamen für ein Snowflake Open Catalog-Konto finden <https://other-docs.snowflake.com/en/opencatalog/find-account-name>_ in der Dokumentation.

Hinzufügen einer Snowflake CLI-Verbindung für Snowflake Open Catalog¶

Fügen Sie eine Verbindung für das Snowflake Open Catalog-Konto hinzu, für das Sie die private Konnektivität aktivieren möchten.

• Fügen Sie eine Verbindung <https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections#add-a-connection>_ mit den folgenden Werten hinzu. Für alle anderen Parameter drücken Sie die Eingabetaste, um die Angabe eines Wertes für den Parameter zu überspringen.

  Parameter für die Konfiguration der Verbindung	Wert
  Name für diese Verbindung	Geben Sie einen Namen für die Verbindung an, zum Beispiel myopencatalogconnection.
  Kontoname	Geben Sie den Namen Ihrer Snowflake-Organisation, gefolgt vom Namen Ihres Open Catalog-Kontos, in diesem Format an: ``-<. Zum Beispiel ABCDEFG-MYACCOUNT1. Um diese Namen zu finden, siehe Bevor Sie beginnen_.
  Benutzername	Geben Sie Ihren Benutzernamen für Open Catalog an, zum Beispiel jsmith.
  Kennwort [optional]	Dieser Parameter ist nicht optional, wenn Sie eine Verbindung für Open Catalog erstellen. Geben Sie Ihr Kennwort für Open Catalog ein, z. B. MyPassword123456789.
  Rolle für die Verbindung [optional]	Dieser Parameter ist nicht optional, wenn Sie eine Verbindung für Open Catalog erstellen. Sie müssen POLARIS_ACCOUNT_ADMIN eingeben

Testen Sie die Snowflake CLI-Verbindung¶

• Um Ihre CLI-Verbindung zu testen, folgen Sie diesem Beispiel, das die Verbindung für myopencatalogconnection testet:

  snow connection test -c myopencatalogconnection
  

  Copy

  Die Antwort sollte wie folgt aussehen:

  +------------------------------------------------------------------------------+
  | key              | value                                                     |
  |----------------------------+-------------------------------------------------|
  | Connection name  | myopencatalogconnection                                   |
  | Status           | OK                                                        |
  | Host             | ABCDEFG-MYACCOUNT1.snowflakecomputing.com                 |
  | Account          | ABCDEFG-MYACCOUNT1                                        |
  | User             | jsmith                                                    |
  | Role             | POLARIS_ACCOUNT_ADMIN                                     |
  | Database         | not set                                                   |
  | Warehouse        | not set                                                   |
  +------------------------------------------------------------------------------+
  

  Copy

Legen Sie Ihre Snowflake CLI-Verbindung für Snowflake Open Catalog als Standard fest¶

Um sicherzustellen, dass der von Ihnen verwendeten Verbindung immer die erforderliche Rolle POLARIS_ACCOUNT_ADMIN zugewiesen wird, können Sie die Snowflake CLI-Verbindung, die Sie für Open Catalog erstellt haben, als Standardverbindung festlegen. Weitere Informationen über die Standardverbindung finden Sie unter Legen Sie die Standardverbindung fest <https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections#set-the-default-connection>_.

1. Folgen Sie diesem Beispiel, in dem die Verbindung myopencatalogconnection als Standard eingestellt ist:

   snow connection set-default myopencatalogconnection
   

   Copy

2. Um sicherzustellen, dass Sie den richtigen Benutzer und die richtige Rolle verwenden, führen Sie Folgendes aus:

   snow sql -q "Select current_user(); select current_role();"
   

   Copy

   Die Antwort sollte Ihren Open Catalog-Benutzernamen zurückgeben und die CURRENT ROLE sollte POLARIS_ACCOUNT_ADMIN lauten.

   +----------------+
   | CURRENT_USER() |
   |----------------|
   | JSMITH        |
   +----------------+
   select current_role();
   +-----------------------+
   | CURRENT_ROLE()        |
   |-----------------------|
   | POLARIS_ACCOUNT_ADMIN |
   +-----------------------+
   

   Copy

Beispiel: Bereitstellung eines privaten Konnektivitätsendpunkts¶

Das folgende Beispiel erstellt einen PrivateLink mit externem Zugriff auf Amazon S3, um einen Endpunkt für die Region us-west-2 zu konfigurieren:

SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
  'com.amazonaws.us-west-2.s3',
  '*.s3.us-west-2.amazonaws.com'
);

Aktivieren Sie die private Konnektivität für einen neuen Katalog¶

Folgen Sie den Anweisungen unter Einen Katalog mit Amazon Simple Storage Service (Amazon S3) erstellen. Vergewissern Sie sich, dass für den Katalog die Schaltfläche Private Link auf Aktiviert steht.

Private Konnektivität für einen bestehenden Katalog aktivieren¶

1. Melden Sie sich an, um den Katalog zu öffnen.

2. Wählen Sie im Navigationsmenü Kataloge.

3. Wählen Sie in der Liste der Kataloge den Katalog aus, für den Sie die private Konnektivität aktivieren möchten.

4. Setzen Sie auf der Registerkarte Katalogdetails die Schaltfläche PrivateLink auf Aktiviert.