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

クライアントリダイレクトの紹介¶

クライアントリダイレクトは、Snowflake 接続 オブジェクトを介して実装されます。接続オブジェクトは、SnowflakeクライアントでSnowflakeに接続するために使用する安全な 接続 URL を保存します。

接続 URL のホスト名は、共通ドメイン名に加えて、組織名と接続オブジェクト名で構成されます。

organization_name-connection_name.snowflakecomputing.com

このホスト名は、接続先のアカウントを指定しないことに注意してください。アカウント管理者は、そのアカウントの接続を プライマリ接続 として機能するように指定することにより、使用するアカウントを決定します。接続 URL を使用してSnowflakeに接続すると、プライマリ接続を含むアカウントに接続するようになります。

リージョンまたはクラウドプラットフォームで停止が発生し、その停止がプライマリ接続のアカウントに影響を与える場合、管理者は、プライマリ接続として機能するように、別のリージョンまたはクラウドプラットフォームにある別のアカウントの接続を昇格できます。

この停止の間、同じ接続 URL を引き続き使用してSnowflakeに接続できます。Snowflakeは、新しく昇格された接続を持つアカウント（停止の影響を受けるリージョンまたはクラウドプラットフォーム外のアカウント）への接続 URL を解決します。

クライアントリダイレクトフロー¶

1. クライアントリダイレクトの構成 （このトピック内）にあるステップを実行して、クライアント接続用の接続 URL を作成します。これには、プライマリ接続とリンクされたセカンダリ接続の作成が含まれます。

2. 接続 URL を使用して接続するようにSnowflakeクライアントを更新します。 接続 URL の使用 （このトピック内）には、サポートされているクライアントと接続の詳細のリストが含まれています。

3. プライマリ接続が配置されているリージョンでサービスが停止した場合は、 クライアント接続のリダイレクト （このトピック内）のステップを実行して接続 URL を更新し、セカンダリ接続にリダイレクトします。

4. 停止が解決したら、 クライアント接続のリダイレクト のステップを実行して、クライアント接続を元のプライマリ接続にリダイレクトします。

次の図は、同じ組織内にあるが、同じまたは異なるクラウドプラットフォーム上の異なるリージョン（Region A と Region B）にある2つのアカウントのクライアントリダイレクトフローを示しています。

プライマリ接続は Region A の Account 1 にあります。接続 URL を使用するSnowflakeクライアントは Account 1 に接続します。

Region A でサービスが停止すると、クライアント接続に失敗します。

Region B の Account 2 にある接続は、プライマリ接続として機能するように昇格されます。接続 URL を使用するSnowflakeクライアントは 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;

クライアントリダイレクトの構成¶

このセクションでは、接続グループにプライマリ接続と1つ以上のセカンダリ接続を作成する方法について説明します。

Snowflakeサービスへのプライベート接続用 DNS 設定の構成¶

SnowflakeアカウントでSnowflakeサービスへのプライベート接続が有効になっている場合、ネットワーク管理者は接続 URL 用 DNS 記録を作成および管理する必要があります。ネットワーク管理者は、ネットワークアーキテクチャの構成に基づいて、 CNAME 記録、エイリアス記録、またはエイリアスを使用できます。

その他のアカウントすべてでは、Snowflakeが DNS 記録を作成および管理します。一貫性を保つため、以下の例では CNAME 記録を使用しています。

これらのステップでは、例として AWS PrivateLink を使用しますが、SnowflakeアカウントでAzure Private LinkまたはGoogle Cloud Private Service Connectを使用する場合も、ステップは同じです。

1. クライアントリダイレクトが有効になっているアカウントの1つで SHOW CONNECTIONS を実行します。たとえば、 myaccount1 と myaccount2 に対して AWS PrivateLink が有効になっているとします。

   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

   myaccount1 または myaccount2 で SYSTEM$GET_PRIVATELINK_CONFIG 関数を呼び出す場合、 CONNECTION_URL 列にあるこのコマンドの出力は privatelink-connection-urls リストと一致する必要があることに注意してください。このリストには、 privatelink セグメントでフォーマットされた接続 URL がすでに含まれています（次のステップで示すとおり）。オプションで、このステップでコマンドを実行するか、関数を呼び出すことができます。関数を呼び出す場合は、 URLs を変更せずにそのまま使用します。

2. CONNECTION_URL 列の値を記録し、2つの URLs を作成して、プライベート接続と OCSP をサポートします。

   1. snowflakecomputing.com の直前の URL に privatelink セグメントを追加します（この例では myorg-myconnection.privatelink.snowflakecomputing.com）。

   2. URL （この例では ocsp.myorg-myconnection.privatelink.snowflakecomputing.com）の先頭に ocsp セグメントを追加します。

3. DNS プロバイダーが提供するツールを使用して、接続 URL と OCSP URL の CNAME 記録を作成します。

   • 変更された CONNECTION_URL 列の値を使用して、ドメイン（またはエイリアス）を設定します。

   • 接続 URL がプライマリSnowflakeアカウント URL に解決されるように記録を構成します。選択した URL 形式に基づいて、クラウドリージョンと AWS PrivateLink の URL セグメントをすべて含めるようにしてください。これがプライマリアカウント URL であり、クライアント接続が接続 URL にリダイレクトされる場所です。

   • OCSP URL が、Azureのアカウントのプライベートエンドポイント IP アドレス、または AWS のアカウントのプライベートエンドポイント ID 値のいずれかに解決するように記録を構成します。

   • フェールオーバーの場合は、 Snowflakeサービスへのプライベート接続用 DNS 記録の変更 に示すように、 URL 接続がセカンダリアカウント URL をポイントするように、 DNS 設定を手動で更新する必要があります。同様に、 OCSP の設定を更新して、プライベートエンドポイント IP のアドレスまたはプライベートエンドポイント ID の値をポイントするようにする必要があります。

     例:

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

     Copy

     または、組織名とアカウント名 URL を使用します。

     例:

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

     Copy

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

ユーザーは、次の接続 URL 形式を使用してSnowflakeに接続します。

organization_name-connection_name.privatelink.snowflakecomputing.com

条件:

organization_name

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

connection_name

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

詳細については、次をご参照ください。

• 接続 URL の使用 （このトピック内）

• Snowflakeサービスへのプライベート接続用 DNS 記録の変更 （このトピック内）

接続 URL の使用¶

このセクションでは、さまざまなSnowflakeクライアントの構成で接続 URL を参照する手順について説明します。

<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

認証とクライアントリダイレクト¶

セキュリティ統合が 複製 されない場合、ユーザーは、ソースアカウントと各ターゲットアカウントでプロビジョニングする必要があります。

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

プライマリ接続が配置されているリージョンでサービスが停止した場合は、セカンダリ接続を保存しているアカウントにクライアント接続をリダイレクトします。

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

接続の変更¶

Snowsight または SQL を使用して接続を作成した後、接続のターゲットアカウントを編集できます。

接続の切断¶

Snowsight または SQL を使用して接続を切断できます。

クライアントリダイレクトのモニター¶

Snowsight または SQL を使用して、組織内のアカウントのクライアントリダイレクト接続と使用状況をモニターできます。

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;

クライアントリダイレクトの現在の制限¶

• そのアカウントに OAuth セキュリティ統合が複製されていない場合は、接続 URL と OAuth の統合を使用するクライアント接続では、接続 URL が更新されて別のアカウントをポイントすると、再認証が必要になります。詳細については、 OAuth リダイレクト動作 をご参照ください。

• ウェブブラウザーは、ブラウザーのキャッシュが原因で、リダイレクトに数分かかる場合があります。

  リダイレクトが機能することを確認する必要がある場合は、 別のクライアント でSnowflakeに接続できます。

  または、ブラウザーのキャッシュの問題を回避するために、新しいプライベートブラウザーウィンドウ（例: Google Chromeのシークレットモード）を開きます。一部のウェブブラウザーでは、プライベートモードまたはシークレットモードでも引き続きデータをキャッシュする可能性があることに注意してください。ブラウザーのキャッシュの使用を避けるには、新しいプライベートブラウザーウィンドウを開く前に、開いているプライベートブラウザーウィンドウとタブをすべて閉じます。

• Snowsight を使用して追加できるターゲットアカウントは1つのみです。許可されるフェイルオーバーアカウントのリストに複数のターゲットアカウントを追加するには、 ALTER CONNECTION ... ENABLE FAILOVER TO ACCOUNTS コマンドを使用します。