클라이언트 연결 리디렉션하기¶

클라이언트 리디렉션 소개¶

클라이언트 리디렉션은 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)에 있는 두 계정에 대한 클라이언트 리디렉션 흐름을 나타낸 것입니다.

기본 연결은 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;

클라이언트 리디렉션 구성하기¶

이 섹션에서는 연결 그룹에서 기본 연결과 하나 이상의 보조 연결을 만드는 방법을 설명합니다.

Snowflake 서비스에 대한 비공개 연결을 위한 DNS 설정 구성하기¶

Snowflake 계정에 대해 Snowflake 서비스에 비공개 연결이 활성화된 경우에는 네트워크 관리자가 연결 URL에 대한 DNS 레코드를 만들고 관리해야 합니다. 네트워크 관리자는 CNAME 레코드, 별칭 레코드 또는 네트워크 아키텍처 구성을 기반으로 한 별칭을 사용할 수 있습니다.

다른 모든 계정의 경우, Snowflake는 DNS 레코드를 만들고 관리합니다. 일관성을 위해, 다음 예에서는 CNAME 레코드를 사용합니다.

이러한 단계에서는 AWS PrivateLink를 예로 사용하며, Snowflake 계정이 Azure Private Link 또는 Google Cloud Private Service Connect를 사용하는 경우 그 단계는 동일합니다.

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

   CONNECTION_URL 열에서 이 명령의 출력은 myaccount1 또는 myaccount2 에서 SYSTEM$GET_PRIVATELINK_CONFIG 함수를 호출할 때 privatelink-connection-urls 목록과 일치해야 합니다. (다음 단계에 표시된 것처럼) 이 목록에는 privatelink 세그먼트로 형식이 지정된 연결 URL이 이미 있습니다. 선택적으로 이 단계에서 명령을 실행하거나 함수를 호출할 수 있습니다. 함수를 호출하는 경우 추가로 수정하지 않고 URL을 그대로 사용합니다.

2. CONNECTION_URL 열 값을 기록하고 비공개 연결을 지원하는 두 개의 URL과 OCSP 를 만듭니다.

   1. snowflakecomputing.com (이 예에서는 myorg-myconnection.privatelink.snowflakecomputing.com) 바로 앞에 있는 URL에 privatelink 세그먼트를 추가합니다.

   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 설정을 수동으로 업데이트해야 합니다. 마찬가지로, 비공개 엔드포인트 IP 주소 또는 비공개 엔드포인트 ID 값을 가리키도록 OCSP 설정을 업데이트해야 합니다.

     예:

     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;

클라이언트 리디렉션의 현재 제한 사항¶

• 연결 URL과 OAuth 통합을 사용하는 클라이언트 연결은 OAuth 보안 통합이 해당 계정에 복제되지 않을 경우 연결 URL이 다른 계정을 가리키도록 업데이트될 때 재인증이 필요합니다. 자세한 내용은 OAuth 리디렉션 동작 섹션을 참조하십시오.

• 웹 브라우저는 브라우저 캐시로 인해 리디렉션하는 데 몇 분 정도 걸릴 수 있습니다.

  리디렉션이 작동하는지 확인해야 하는 경우 다른 클라이언트 로 Snowflake에 연결할 수 있습니다.

  또는 브라우저 캐싱 문제를 방지하기 위해 새 비공개 브라우저 윈도우(예: Google Chrome의 시크릿 모드)를 엽니다. 비공개 또는 시크릿 모드에서 일부 웹 브라우저는 여전히 데이터를 캐시할 수 있습니다. 브라우저 캐시 사용을 방지하려면 열려 있는 모든 개인 브라우저 윈도우와 탭을 닫은 후에 새 개인 브라우저 윈도우를 여십시오.

• Snowsight 를 사용하여 대상 계정을 하나만 추가할 수 있습니다. 허용된 장애 조치 계정 목록에 대상 계정을 2개 이상 추가하려면 ALTER CONNECTION … ENABLE FAILOVER TO ACCOUNTS 명령을 사용하십시오.