Umleiten von Clientverbindungen¶

Einführung in die Clientumleitung¶

Die Clientumleitung wird durch ein Snowflake-Verbindungsobjekt implementiert. Das Verbindungsobjekt speichert eine sichere Verbindungs-URL, die Sie für die Verbindung eines Snowflake-Clients mit Snowflake verwenden können.

Der Hostname in der Verbindungs-URL setzt sich aus dem Namen Ihrer Organisation und dem Namen des Verbindungsobjekts sowie einem gemeinsamen Domänennamen zusammen:

organization_name-connection_name.snowflakecomputing.com

Beachten Sie, dass dieser Hostname nicht das Konto angibt, mit dem Sie sich verbinden. Ein Kontoadministrator legt das zu verwendende Konto fest, indem er die Verbindung in diesem Kontos als Primärverbindung definiert. Wenn Sie die Verbindungs-URL verwenden, um eine Verbindung zu Snowflake herzustellen, stellen Sie eine Verbindung zu dem Konto her, das die Primärverbindung enthält.

Wenn ein Ausfall in einer Region oder bei einer Cloudplattform auftritt und der Ausfall das Konto mit der Primärverbindung betrifft, kann der Administrator eine Verbindung in einem anderen Konto in einer anderen Region oder auf einer anderen Cloudplattform zur Primärverbindung heraufstufen.

Während dieses Ausfalls können Sie weiterhin dieselbe Verbindungs-URL für die Verbindung zu Snowflake verwenden. Snowflake löst die Verbindungs-URL zu dem Konto mit der neu heraufgestuften Verbindung auf (das Konto außerhalb der vom Ausfall betroffenen Region oder Cloudplattform).

Ablauf der Clientumleitung¶

1. Führen Sie die unter Clientumleitung konfigurieren (unter diesem Thema) beschriebenen Schritte aus, um eine Verbindungs-URL für Clientverbindungen zu erstellen. Dazu gehört das Erstellen einer Primärverbindung und einer oder mehrerer verknüpfter Sekundärverbindungen.

2. Aktualisieren Sie Snowflake-Clients, um eine Verbindung über die Verbindungs-URL herzustellen. Unter Verwenden einer Verbindungs-URL (unter diesem Thema) finden Sie eine Liste der unterstützten Clients und Verbindungsdetails.

3. Falls der Dienst in der Region ausfällt, in der sich die Primärverbindung befindet, führen Sie die Schritte unter Umleiten von Clientverbindungen (unter diesem Thema) aus, um die Verbindungs-URL zu aktualisieren und auf eine Sekundärverbindung umzuleiten.

4. Wenn der Ausfall behoben ist, führen Sie die Schritte unter Umleiten von Clientverbindungen aus, um die Clientverbindungen wieder auf die ursprüngliche Primärverbindung umzuleiten.

Die folgenden Diagramme veranschaulichen den Ablauf der Clientumleitung für zwei Konten derselben Organisation, aber in unterschiedlichen Regionen (Region A und Region B) auf derselben oder auf unterschiedlichen Cloudplattformen.

Die Primärverbindung befindet sich in Account 1 in Region A. Snowflake-Clients, die die Verbindungs-URL verwenden, verbinden sich mit Account 1.

Ein Dienstausfall in Region A führt zu fehlgeschlagenen Clientverbindungen:

Die Verbindung in Account 2 in Region B wird zur Primärverbindung hochgestuft. Snowflake-Clients, die die Verbindungs-URL verwenden, verbinden sich nun mit Account 2.

-- Create a new primary connection
CREATE CONNECTION myconnection;

-- View accounts in your organization that are enabled for replication
SHOW REPLICATION ACCOUNTS;

-- Configure failover accounts for the primary connection
ALTER CONNECTION myconnection
  ENABLE FAILOVER TO ACCOUNTS myorg.myaccount2, myorg.myaccount3;

-- View the details for the connection
SHOW CONNECTIONS;

CREATE CONNECTION myconnection
  AS REPLICA OF myorg.myaccount1.myconnection;

ALTER CONNECTION myconnection PRIMARY;

ALTER CONNECTION myconnection PRIMARY;

Clientumleitung konfigurieren¶

In diesem Abschnitt wird beschrieben, wie Sie eine Primärverbindung und eine oder mehrere Sekundärverbindungen in einer Verbindungsgruppe erstellen.

Konfigurieren der DNS-Einstellungen für private Konnektivität zum Snowflake-Dienst¶

Wenn private Konnektivität zum Snowflake-Dienst für Ihr Snowflake-Konto aktiviert ist, muss Ihr Netzwerkadministrator einen DNS-Datensatz für Ihre Verbindungs-URL erstellen und verwalten. Ihr Netzwerkadministrator kann einen CNAME-Datensatz, einen Alias-Datensatz oder einen Alias auf Basis der Konfiguration der Netzwerkarchitektur verwenden.

Für alle anderen Konten erstellt und verwaltet Snowflake den DNS-Datensatz. Aus Gründen der Konsistenz wird im folgenden Beispiel ein CNAME-Datensatz verwendet.

Diese Schritte verwenden AWS PrivateLink als Beispiel. Die Schritte sind die gleichen, wenn Ihr Snowflake-Konto Azure Private Link oder Google Cloud Private Service Connect verwendet:

1. Führen Sie SHOW CONNECTIONS in einem Ihrer Konten aus, in dem die Clientumleitung aktiviert ist. Angenommen, dass AWS PrivateLink für myaccount1 und myaccount2 aktiviert ist.

   SHOW CONNECTIONS;
   
   +--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+
   | snowflake_region   | created_on                    | account_name        | name              | comment         | is_primary    | primary                       | failover_allowed_to_accounts        | connection_url                            | organization_name | account_locator   |
   |--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------|
   | AWS_US_WEST_2      | 2020-07-19 14:49:11.183 -0700 | MYORG.MYACCOUNT1    | MYCONNECTION      | NULL            | true          | MYORG.MYACCOUNT1.MYCONNECTION | MYORG.MYACCOUNT2, MYORG.MYACCOUNT3  | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR1 |
   |--------------------|-------------------------------|---------------------|-------------------|-----------------|---------------|-------------------------------|-------------------------------------|-------------------------------------------|-------------------|-------------------|
   | AWS_US_WEST_2      | 2020-07-19 14:49:11.183 -0700 | MYORG.MYACCOUNT1    | MYCONNECTION      | NULL            | true          | MYORG.MYACCOUNT1.MYCONNECTION | MYORG.MYACCOUNT2, MYORG.MYACCOUNT3  | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR1 |
   | AWS_US_EAST_1      | 2020-07-22 13:52:04.925 -0700 | MYORG.MYACCOUNT2    | MYCONNECTION      | NULL            | false         | MYORG.MYACCOUNT1.MYCONNECTION |                                     | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR2 |
   +--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+
   

   Copy

   Beachten Sie, dass die Ausgabe dieses Befehls in der Spalte CONNECTION_URL mit der Liste privatelink-connection-urls übereinstimmen muss, wenn Sie die Funktion SYSTEM$GET_PRIVATELINK_CONFIG entweder in myaccount1 oder myaccount2 aufrufen. Diese Liste enthält bereits die Verbindungs-URL, die mit dem Segment privatelink formatiert ist (wie im nächsten Schritt gezeigt). Sie können in diesem Schritt optional den Befehl ausführen oder die Funktion aufrufen. Wenn Sie die Funktion aufrufen, verwenden Sie die URLs so, wie sie sind, ohne weitere Änderungen.

2. Notieren Sie sich den Wert der Spalte CONNECTION_URL, und erstellen Sie zwei URLs, um private Konnektivität und OCSP zu unterstützen.

   1. Fügen Sie ein privatelink-Segment an die URL kurz vor snowflakecomputing.com (myorg-myconnection.privatelink.snowflakecomputing.com, in diesem Beispiel).

   2. Fügen Sie am Anfang der URL ein Segment ocsp hinzu (in diesem Beispiel ocsp.myorg-myconnection.privatelink.snowflakecomputing.com).

3. Erstellen Sie mit einem von Ihrem DNS-Anbieter bereitgestellten Tool einen CNAME-Datensatz für die Verbindungs-URL und die OCSP-URL:

   • Legen Sie die Domäne (oder den Alias) unter Verwendung des geänderten CONNECTION_URL-Spaltenwerts fest.

   • Konfigurieren Sie den Datensatz so, dass die Verbindungs-URL auf die primäre URL des Snowflake-Kontos aufgelöst wird. Stellen Sie sicher, dass alle URL-Segmente für die Cloudregion und für AWS PrivateLink basierend auf dem von Ihnen gewählten URL-Format enthalten sind. Dies ist die Primärkonto-URL, an die Clientverbindungen zur Verbindungs-URL umgeleitet werden.

   • Konfigurieren Sie den Datensatz so, dass die OCSP-URL entweder auf die IP-Adresse des privaten Endpunkts für ein Konto auf Azure oder auf den ID-Wert der privaten Endpunkts für ein Konto auf AWS aufgelöst wird.

   • Im Falle eines Failover müssen Sie die DNS-Einstellung manuell aktualisieren, damit die Verbindungs-URL auf die Sekundärkonto-URL zeigt, wie unter Ändern des DNS-Einstellungen für private Konnektivität zum Snowflake-Dienst gezeigt. Ebenso müssen Sie Ihre OCSP-Einstellungen aktualisieren, um auf die IP-Adresse des privaten Endpunkts oder auf den ID-Wert des privaten Endpunkts zu verweisen.

     Beispiel:

     myaccount1.us-west-2.privatelink.snowflakecomputing.com.
     ocsp.myaccount1.us-west-2.privatelink.snowflakecomputing.com.
     

     Copy

     Alternativ können Sie auch die Organisations- und Kontonamen-URL verwenden.

     Beispiel:

     myorg-myaccount1.privatelink.snowflakecomputing.com.
     ocsp.myorg-myaccount1.privatelink.snowflakecomputing.com.
     

     Copy

     Beachten Sie den nachstehenden Punkt, der unbedingt enthalten sein muss.

Benutzer stellen die Verbindung zu Snowflake über das folgende Verbindungs-URL-Format her:

organization_name-connection_name.privatelink.snowflakecomputing.com

Wobei:

organization_name

Name Ihrer Snowflake-Organisation. Die Snowflake-Konten, mit denen sich Ihre Benutzer verbinden, sind in dieser Organisation enthalten.

connection_name

Name des Verbindungsobjekts.

Weitere Informationen dazu finden Sie unter:

• Verwenden einer Verbindungs-URL (unter diesem Thema).

• Ändern des DNS-Einstellungen für private Konnektivität zum Snowflake-Dienst (unter diesem Thema).

Verwenden einer Verbindungs-URL¶

In diesem Abschnitt finden Sie eine Anleitung für das Verweisen auf eine Verbindungs-URL in der Konfiguration der verschiedenen Snowflake-Clients.

<organization-name>-<connection-name>

myorg-myconnection

https://<organization_name>-<connection_name>.snowflakecomputing.com/

https://myorg-myconnection.snowflakecomputing.com/

accountname = <organization_name>-<connection_name>
username = <username>
password = <password>

accountname = myorg-myconnection
username = jsmith
password = mySecurePassword

con = snowflake.connector.connect (
      account = <organization_name>-<connection_name>
      user = <username>
      password = <password>
)

con = snowflake.connector.connect (
      account = myorg-myconnection
      user = jsmith
      password = mySecurePassword
)

jdbc:snowflake://<organization_name>-<connection_name>.snowflakecomputing.com/?user=<username>&password=<password>

jdbc:snowflake://myorg-myconnection.snowflakecomputing.com/?user=jsmith&password=mySecurePassword

[ODBC Data Sources]
<account_name> = SnowflakeDSIIDriver

[<dsn_name>]
Description     = SnowflakeDB
Driver          = SnowflakeDSIIDriver
Locale          = en-US
SERVER          = <organization_name>-<connection_name>.snowflakecomputing.com

[ODBC Data Sources]
myaccount = SnowflakeDSIIDriver

[client_redirect]
Description     = SnowflakeDB
Driver          = SnowflakeDSIIDriver
Locale          = en-US
SERVER          = myorg-myconnection.snowflakecomputing.com

var configuration = {
  username: '<username>',
  password: '<password>',
  account: <organization_name>-<connection_name>.
}

var connection = snowflake.createConnection(configuration)

var configuration = {
  username: 'jsmith',
  password: 'mySecurePassword',
  account: myorg-myconnection.
}

var connection = snowflake.createConnection(configuration)

cfg := &Config{
  Account: "<organization_name>-<connection_name>",
  User: "<username>",
  Password: "<password>"
}

dsn, err := DSN(cfg)

cfg := &Config{
  Account: "myorg-myconnection",
  User: "jsmith",
  Password: "mySecurePassword"
}

dsn, err := DSN(cfg)

connection_parameters = {
  "account": "<organization_name>-<connection_name>",
  "user": "<snowflake_user>",
  "password": "<snowflake_password>"
}

connection_parameters = {
  "account": "myorg-myconnection",
  "user": "jsmith",
  "password": "mySecurePassword"
}

# Properties file (a text file) for establishing a Snowpark session
URL = https://<organization_name>-<connection_name>.snowflakecomputing.com

# Properties file (a text file) for establishing a Snowpark session
URL = https://myorg-myconnection.snowflakecomputing.com

# Properties file (a text file) for establishing a Snowpark session
URL = https://<organization_name>-<connection_name>.snowflakecomputing.com

# Properties file (a text file) for establishing a Snowpark session
URL = https://myorg-myconnection.snowflakecomputing.com

Authentifizierung und Clientumleitung¶

Benutzer müssen im Quellkonto und in jedem Zielkonto bereitgestellt werden, wenn Sicherheitsintegrationen nicht repliziert werden.

Umleiten von Clientverbindungen¶

Falls der Dienst in der Region ausfällt, in der sich die Primärverbindung befindet, leiten Sie die Clientverbindung zu einem Konto um, das eine Sekundärverbindung speichert.

-- view all connections
SHOW CONNECTIONS;

+--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+
| snowflake_region   | created_on                    | account_name        | name              | comment         | is_primary    | primary                       | failover_allowed_to_accounts        | connection_url                            | organization_name | account_locator   |
|--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------|
| AWS_US_WEST_2      | 2020-07-19 14:49:11.183 -0700 | MYORG.MYACCOUNT1    | MYCONNECTION      | NULL            | true          | MYORG.MYACCOUNT1.MYCONNECTION | MYORG.MYACCOUNT2, MYORG.MYACCOUNT3  | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR1 |
| AWS_US_EAST_1      | 2020-07-22 13:52:04.925 -0700 | MYORG.MYACCOUNT2    | MYCONNECTION      | NULL            | false         | MYORG.MYACCOUNT1.MYCONNECTION |                                     | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR2 |
+--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+

-- promote the secondary connection to serve as the primary connection
ALTER CONNECTION myconnection PRIMARY;

-- verify that the former secondary connection was promoted successfully
SHOW CONNECTIONS;

+--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+
| snowflake_region   | created_on                    | account_name        | name              | comment         | is_primary    | primary                       | failover_allowed_to_accounts        | connection_url                            | organization_name | account_locator   |
|--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------|
| AWS_US_WEST_2      | 2020-07-19 14:49:11.183 -0700 | MYORG.MYACCOUNT1    | MYCONNECTION      | NULL            | false         | MYORG.MYACCOUNT1.MYCONNECTION | MYORG.MYACCOUNT2, MYORG.MYACCOUNT3  | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR1 |
| AWS_US_EAST_1      | 2020-07-22 13:52:04.925 -0700 | MYORG.MYACCOUNT2    | MYCONNECTION      | NULL            | true          | MYORG.MYACCOUNT1.MYCONNECTION |                                     | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR2 |
+--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+

myaccount1.us-east-1.privatelink.snowflakecomputing.com.
ocsp.myaccount1.us-east-1.privatelink.snowflakecomputing.com.

SELECT CURRENT_REGION();

Modifizieren einer Verbindung¶

Sie können die Zielkonten einer Verbindung bearbeiten, nachdem Sie sie mit Snowsight oder SQL erstellt haben.

Löschen einer Verbindung¶

Sie können eine Verbindung über Snowsight oder SQL löschen.

Überwachen der Clientumleitung¶

Sie können die Verbindungen und die Nutzung der Clientumleitung für Konten einer Organisation mit Snowsight oder SQLüberwachen.

SHOW CONNECTIONS;

+--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+
| snowflake_region   | created_on                    | account_name        | name              | comment         | is_primary    | primary                       | failover_allowed_to_accounts        | connection_url                            | organization_name | account_locator   |
|--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------|
| AWS_US_WEST_2      | 2023-07-05 08:57:11.143 -0700 | MYORG.MYACCOUNT1    | MYCONNECTION      | NULL            | true          | MYORG.MYACCOUNT1.MYCONNECTION | MYORG.MYACCOUNT2, MYORG.MYACCOUNT3  | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR1 |
| AWS_US_EAST_1      | 2023-07-08 09:15:11.143 -0700 | MYORG.MYACCOUNT2    | MYCONNECTION      | NULL            | false         | MYORG.MYACCOUNT1.MYCONNECTION | MYORG.MYACCOUNT2, MYORG.MYACCOUNT3  | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR1 |
|--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------|

SELECT event_timestamp, user_name, client_ip, reported_client_type, is_success, connection
  FROM TABLE(INFORMATION_SCHEMA.LOGIN_HISTORY(
    DATEADD('HOURS',-72,CURRENT_TIMESTAMP()),
    CURRENT_TIMESTAMP()))
  ORDER BY EVENT_TIMESTAMP;

Aktuelle Einschränkungen bei Clientumleitungen¶

• Bei Clientverbindungen, die eine Verbindungs-URL und eine OAuth-Integration verwenden, ist eine erneute Authentifizierung erforderlich, wenn die Verbindungs-URL aktualisiert wird, um auf ein anderes Konto zu verweisen, und die OAuth-Sicherheitsintegration nicht in dieses Konto repliziert wird. Weitere Informationen dazu finden Sie unter OAuth-Umleitungsverhalten.

• Webbrowser können aufgrund des Browser-Caches mehrere Minuten für die Umleitung benötigen.

  Wenn Sie überprüfen möchten, ob die Umleitung funktioniert, können Sie eine Verbindung zu Snowflake mit einem anderen Client herstellen.

  Alternativ können Sie auch ein neues privates Browserfenster öffnen (z. B. den Inkognito-Modus in Google Chrome), um Probleme mit dem Browser-Caching zu vermeiden. Beachten Sie, dass einige Webbrowser im privaten oder Inkognito-Modus möglicherweise immer noch Daten zwischenspeichern. Um die Verwendung des Browser-Caches zu vermeiden, schließen Sie erst alle geöffneten privaten Browserfenster und Registerkarten, bevor Sie ein neues privates Browserfenster öffnen.

• Sie können mit Snowsight nur ein einziges Zielkonto hinzufügen. Um mehr als ein Zielkonto zur Liste der zulässigen Failover-Konten hinzuzufügen, verwenden Sie den Befehl ALTER CONNECTION … ENABLE FAILOVER TO ACCOUNTS.