Umleiten von Clientverbindungen¶

Beispiel¶

Die folgenden SQL-Anweisungen durchlaufen den Clientumleitungs-Workflow. Jeder Schritt wird in den folgenden Abschnitten dieses Themas ausführlich erläutert.

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

Voraussetzung¶

Um das Feature „Clientumleitung“ für Ihre Konten zu aktivieren, muss ein Organisationsadministrator (ein Benutzer mit der Rolle ORGADMIN) die Replikation für zwei oder mehr Konten aktivieren. Eine ausführliche Anleitung zum Aktivieren der Replikation finden Sie unter Voraussetzung: Aktivieren Sie die Replikation für Konten der Organisation.

Primärverbindung erstellen¶

1. Erstellen Sie mit CREATE CONNECTION eine neue Primärverbindung. Der Name jeder Primärverbindung muss unter den Verbindungs- und Kontonamen der Organisation eindeutig sein.

   Der Verbindungsname ist Teil der Verbindungs-URL, die für die Verbindung mit Snowflake-Konten verwendet wird.

   Erstellen Sie zum Beispiel eine Verbindung mit dem Namen myconnection:

   CREATE CONNECTION myconnection;
   

2. Ändern Sie diese Primärverbindung mit einer ALTER CONNECTION … ENABLE FAILOVER TO ACCOUNTS-Anweisung. Geben Sie eine durch Kommas getrennte Liste von Konten Ihrer Organisation an, die eine Failover-Option für diese Verbindung (d. h. eine Sekundärverbindung) speichern können.

   Jedes Konto, das eine Sekundärverbindung speichert, muss in einer anderen Region gehostet werden als das Konto, das die Primärverbindung speichert. Die Clientumleitung funktioniert nur zwischen unterschiedlichen Regionen. Wenn Sie beispielsweise versuchen, Clientverbindungen von account1 nach account2 in derselben Region umzuleiten, funktioniert die Clientumleitung nicht.

   Um die vollständige Liste der Konten in Ihrer Organisation anzuzeigen, die für die Replikation aktiviert sind, führen Sie SHOW REPLICATION ACCOUNTS aus.

   Erlauben Sie zum Beispiel den Konten myaccount2 und myaccount3 der Organisation myorg, jeweils eine Sekundärverbindung für die Verbindung myconnection zu speichern:

   ALTER CONNECTION myconnection ENABLE FAILOVER TO ACCOUNTS myorg.myaccount2, myorg.myaccount3;
   

3. Führen Sie den Befehl SHOW CONNECTIONS aus, um die Details der Verbindung anzuzeigen.

   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 |
   +--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+
   

Sekundärverbindung erstellen¶

Erstellen Sie eine Sekundärverbindung in einem oder mehreren Konten, die mit einer Primärverbindung über CREATE CONNECTION … AS REPLICA OF. Beachten Sie, dass Sie eine Sekundärverbindung nur in einem Konto erstellen können, das in der Anweisung ALTER CONNECTION … ENABLE FAILOVER TO ACCOUNTS in Primärverbindung erstellen angegeben ist.

Führen Sie eine CREATE CONNECTION … AS REPLICA OF-Anweisung in jedem Zielkonto aus, um ein Replikat der angegebenen Primärverbindung zu erstellen.

Führen Sie die SQL-Anweisungen aus diesem Abschnitt in dem Ziel konto aus, für das Sie eine Sekundärverbindung erstellen möchten.

1. Führen Sie den Befehl SHOW CONNECTIONS aus, um alle Verbindungen anzuzeigen. Kopieren Sie den Wert der Spalte primary für die Primärverbindung. Dieser Wert wird im nächsten Schritt zum Erstellen der Sekundärverbindung benötigt.

   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 |
   +--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+
   

2. Führen Sie den Befehl CREATE CONNECTION … AS REPLICA OF aus, um eine Sekundärverbindung zu erstellen.

   Erstellen Sie zum Beispiel eine Sekundärverbindung mit dem Namen myconnection, die mit der Primärverbindung myorg.myaccount1.myconnection verknüpft ist. Fügen Sie nach AS REPLICA OF den vollqualifizierten Namen der Primärverbindung ein (den Namen, den Sie im vorherigen Schritt aus der Ausgabe von SHOW CONNECTIONS kopiert haben).

   CREATE CONNECTION myconnection
     AS REPLICA OF MYORG.MYACCOUNT1.MYCONNECTION;
   

3. Führen Sie den Befehl SHOW CONNECTIONS aus, um zu überprüfen, ob die Sekundärverbindung erstellt wurde.

   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 |
   +--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+
   

Unterstützte Snowflake-Clients¶

Die Clientumleitung wird von Snowsight: Die Snowflake-Weboberfläche und Klassische Snowflake-Weboberfläche unterstützt. Außerdem unterstützen die folgenden Snowflake-Clientversionen (und höher) die Clientumleitung:

Snowflake-Clients konfigurieren¶

Verwenden Sie den folgenden Hostnamen für die Verbindungs-URL, wenn Sie eine Verbindung zu Snowflake herstellen:

Hostname: organization_name-connection_name.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.

<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

Verbundauthentifizierung und SSO¶

Konfigurieren Sie die Verbundauthentifizierung separat in jedem Zielkonto. Geben Sie die Details des Identitätsanbieters (IdP) unter Verwendung der Einrichtungsoptionen in Konfigurieren von Snowflake für die Verwendung der Verbundauthentifizierung an:

OAuth¶

Konfigurieren Sie in jedem Zielkonto ein Sicherheitsintegrationsobjekt für OAuth. Das Sicherheitsintegrationsobjekt muss mit demselben Objekt im Quellkonto identisch sein. Eine Anleitung dazu finden Sie unter folgenden Themen:

• Snowflake OAuth

• External OAuth

Um Eigenschaften der Sicherheitsintegration abzurufen, fragen Sie den Befehl DESCRIBE INTEGRATION für jede Sicherheitsintegration im Quellkonto ab. Erstellen Sie dann jede Sicherheitsintegration in einem Zielkonto neu, indem Sie den Befehl CREATE INTEGRATION ausführen.

Heraufstufen einer Sekundärverbindung zur Verwendung als Primärverbindung¶

Die Umleitung wird eingeleitet, indem eine Sekundärverbindung in einer verfügbaren Region mit ALTER CONNECTION zur Primärverbindung heraufgestuft wird. Gleichzeitig wird die bisherige Primärverbindung zu einer Sekundärverbindung.

Führen Sie die SQL-Anweisungen in diesem Abschnitt in dem Zielkonto aus, das die aktuelle Sekundärverbindung enthält, die Sie heraufstufen möchten.

Beispiel:

-- 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 |
+--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+

Ändern des DNS-CNAME-Datensatzes für private Konnektivität zum Snowflake-Dienst¶

Um Clientverbindungen zu einem Sekundärkonto umzuleiten, muss Ihr Netzwerkadministrator den DNS-CNAME-Datensatz ändern, der in Konfigurieren des DNS-CNAME-Datensatzes für private Konnektivität zum Snowflake-Dienst erstellt wurde.

Ändern Sie mit einem von Ihrem DNS-Anbieter bereitgestellten Tool den CNAME-Datensatz für die Verbindungs-URL.

Legen Sie den Zielhostnamen als vollständige Snowflake-Konto-URL für das Konto fest, das Ihre neue Primärverbindung speichert, einschließlich der zusätzlichen Segmente, die die Region und die Cloudplattform identifizieren, auf der Ihr Konto gehostet wird, sowie die Unterstützung von AWS PrivateLink, Azure Private Link oder Google Cloud Private Service Connect. Dies ist der Kontoname, zu dem jetzt Clientverbindungen zur Verbindungs-URL umgeleitet werden.

Beispiel:

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

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

Überprüfen der Aktualisierung der Verbindungs-URL¶

Um zu überprüfen, ob die Verbindungs-URL aktualisiert wurde, können Sie die Region Ihrer aktuellen Verbindung bestätigen. Verwenden Sie die Verbindungs-URL, um eine Verbindung zu Snowflake herzustellen und die Funktion CURRENT_REGION auszuführen.

select current_region();