クライアント接続のリダイレクト¶

例¶

次の SQL ステートメントは、クライアントリダイレクトワークフローを通過します。各ステップについては、このトピックの次のセクションで詳しく説明します。

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

前提条件¶

アカウントのクライアントリダイレクト機能を有効にするには、組織の管理者（ORGADMIN ロールを持つユーザー）が、2つ以上のアカウントの複製を有効にする必要があります。複製を有効にするための詳細な手順については、 前提条件: 組織内のアカウントの複製を有効にする をご参照ください。

プライマリ接続の作成¶

Snowsight または SQL を使用して、ソースアカウントにプライマリ接続を作成できます。

各ターゲットアカウントにセカンダリ接続を作成¶

CREATE CONNECTION ... AS REPLICA OF を使用してプライマリ接続にリンクされた、1つ以上のアカウントでセカンダリ接続を作成します。セカンダリ接続を作成できるのは、 プライマリ接続の作成 の ALTER CONNECTION ... ENABLE FAILOVER TO ACCOUNTS ステートメントで指定したアカウントのみであることに注意してください。

各ターゲットアカウントで CREATE CONNECTION ... AS REPLICA OF ステートメントを実行して、指定したプライマリ接続のレプリカを作成します。

セカンダリ接続を作成する ターゲット アカウントで、このセクションの SQL ステートメントを実行します。

1. SHOW CONNECTIONS コマンドを実行して、すべての接続を表示します。プライマリ接続の primary 列の値をコピーします。次のステップでセカンダリ接続を作成するときに、この値を使用します。

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

   Copy

2. CREATE CONNECTION ... AS REPLICA OF コマンドを実行して、セカンダリ接続を作成します。

   たとえば、 myorg.myaccount1.myconnection プライマリ接続にリンクされている myconnection という名前のセカンダリ接続を作成します。 AS REPLICA OF の後に、プライマリ接続の完全修飾名（前のステップで出力された SHOW CONNECTIONS からコピーした名前）を貼り付けます。

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

   Copy

3. SHOW 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 |
   +--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+
   

   Copy

ロールに FAILOVER 権限を付与する --- オプション¶

アカウント管理者は、接続オブジェクトの FAILOVER 権限をアカウントロールに付与できます。これにより、アカウント管理者以外のユーザーは、セカンダリ接続をプライマリ接続として昇格させることができます。

たとえば、ロール my_failover_role に接続 myconnection をフェールオーバーする機能を付与するには ターゲット アカウントで次のステートメントを実行します。

GRANT FAILOVER ON CONNECTION myconnection TO ROLE my_failover_role;

ロール my_failover_role を持つユーザーは、フェールオーバー時にセカンダリ接続 myconnection をプライマリ接続として機能するように昇格させることができるようになりました。

USE ROLE my_failover_role;

ALTER CONNECTION myconnection PRIMARY;

クライアント接続のリダイレクトの詳細については、 クライアント接続のリダイレクト をご参照ください。

サポートされているSnowflakeクライアント¶

クライアントリダイレクトは Snowsight と Snowflakeの従来のコンソール でサポートされています。加えて、次のSnowflakeクライアントバージョン（およびそれ以上）は、クライアントリダイレクトをサポートしています。

Snowflakeクライアントの構成¶

Snowflakeに接続するときは、接続 URL に次のホスト名を使用します。

ホスト名: organization_name-connection_name.snowflakecomputing.com

条件:

organization_name

Snowflake組織の名前。ユーザーが接続するSnowflakeアカウントは、この組織に含まれています。

connection_name

接続オブジェクトの名前。

<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

フェデレーション認証と SSO¶

各ターゲットアカウントで個別にフェデレーション認証を構成します。 フェデレーション認証を使用するためのSnowflakeの構成 の設定オプションを使用して、IDプロバイダー（IdP）の詳細を提供します。

OAuth¶

各ターゲットアカウントで OAuth のセキュリティ統合オブジェクトを構成します。セキュリティ統合オブジェクトは、ソースアカウントにある同じオブジェクトと同一である必要があります。手順については、適切なトピックをご参照ください。

• Snowflake OAuth

• 外部 OAuth

セキュリティ統合プロパティを取得するには、ソースアカウントのセキュリティ統合ごとに DESCRIBE INTEGRATION コマンドをクエリします。次に、 CREATE INTEGRATION コマンドを実行して、ターゲットアカウントに各セキュリティ統合を再作成します。

プライマリ接続として機能するセカンダリ接続の昇格¶

リダイレクトを開始するには、 ALTER CONNECTION を使用してプライマリ接続として機能するように、使用可能なリージョンでセカンダリ接続を昇格する必要があります。同時に、以前のプライマリ接続がセカンダリ接続になります。

1. プライマリ接続として昇格させるセカンダリ接続を含む利用可能なリージョンで、ターゲットアカウントにサインインします。

2. このセクションの SQL ステートメントを実行します。

   • アカウント内のすべての接続を表示します。

     SHOW CONNECTIONS;
     

     Copy

     ステートメントは、次の出力を返します。

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

   • プライマリ接続として機能するセカンダリ接続を昇格させます。

     ALTER CONNECTION myconnection PRIMARY;
     

     Copy

   • 以前のセカンダリ接続が正常に昇格したことを確認します。

     SHOW CONNECTIONS;
     

     Copy

     ステートメントは、次の出力を返します。

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

Snowflakeサービスへのプライベート接続用DNS記録の変更¶

クライアント接続をセカンダリアカウントにリダイレクトするには、ネットワーク管理者は Snowflakeサービスへのプライベート接続用のDNS設定の構成 で作成した DNS 設定を変更する必要があります。

DNS プロバイダーが提供するツールを使用して、接続 URL の DNS 設定を変更します。

宛先のホスト名を、新しいプライマリ接続を保存するアカウントの完全なSnowflakeアカウント URL として設定します。これには、アカウントがホストされているリージョンとクラウドプラットフォームを識別する追加のセグメント、および AWS PrivateLink、Azure Private Link、またはGoogle Cloud Private Service Connectのサポートが含まれます。これは、接続 URL へのクライアント接続がリダイレクトされるようになるアカウント名です。DNS 設定を更新する際には、必ずプライベート接続 OCSP URL を含めてください。

例:

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

（末尾のピリオドに注意してください。これを含める必要があります。）

接続URLの更新の確認¶

接続 URL が更新されたことを確認するには、現在の接続リージョンを確認します。接続 URL を使用してSnowflakeに接続し、 CURRENT_REGION 関数を実行します。

SELECT CURRENT_REGION();

Snowsightを使用した接続のターゲットアカウントを変更する¶

接続を作成した後で、接続のターゲットアカウントを変更することはできますが、接続名を変更することはできません。

1. Snowsight にサインインし、 Admin » Accounts に移動します。

2. Client Redirect を選択します。

3. 編集したい接続を探します。行の最後の列で More メニュー (...) を選択します。

SQLを使用して接続のターゲットアカウントを変更する¶

ALTER CONNECTION コマンドを使用して、プライマリ接続に複数のターゲットアカウントを追加できます。例については、 例 をご参照ください。

Snowsightを使用した接続をドロップする¶

接続を削除するには、プライマリ接続を持つ ソース アカウントに ACCOUNTADMIN ロールを持つユーザーとしてサインインする必要があります。

1. Snowsight にサインインし、 Admin » Accounts に移動します。

2. Client Redirect を選択します。

3. 削除したい接続を探します。行の最後の列で More メニュー (...) を選択します。

4. Drop を選択してから、 Drop Connection を選択します。

SQL を使用した接続をドロップする¶

接続を削除するには、 DROP CONNECTION コマンドを使用します。

1. ターゲットアカウントのすべてのセカンダリ接続を削除します。

2. ソースアカウントのプライマリ接続を削除します。

例については、 例 をご参照ください。

Snowsight を使用したクライアントリダイレクトをモニターする¶

クライアントリダイレクト接続の詳細を表示するには、次の手順を完了します。

1. Snowsight にサインインし、 Admin » Accounts に移動します。

2. Replication 、 Client Redirect の順に選択します。

3. そのセッションでアクティブなウェアハウスがない場合は、ウェアハウスを選択するプロンプトが表示されます。

検索とフィルタを使用して特定の接続をモニターします。

• 接続名で検索できます。 (検索) ボックスに、接続名を入力して結果をフィルタリングします。

• プライマリ接続 (To) またはセカンダリ接続 (From) で結果をフィルタリングするには、 Redirecting を選択します。

• (アカウント) メニューを選択し、アカウント名で結果をフィルタリングします。

各接続について以下の情報を確認できます。

SQL を使用したクライアントリダイレクトをモニターする¶

SHOW CONNECTIONS コマンドと LOGIN_HISTORY 機能を使用して、接続の詳細を表示し、使用状況をモニターできます。

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;