リージョン間およびクラウドプラットフォーム間での共有の複製¶

データベースの複製¶

この機能は、データベースの複製をサポートします。スナップショットには、オブジェクトとデータへの変更が含まれます。セカンダリデータベースを更新すると、データベースとデータベース内のオブジェクト（スキーマ、テーブル、ビューなど）に対する権限の付与が同期されます。これらのオブジェクトのロールに付与された権限は、ソースアカウントからターゲットアカウントに同期されます。データベース複製でサポートされているオブジェクトに対する権限付与のみが同期されることに注意してください。オブジェクトのリストについては、 複製されたデータベースオブジェクト をご参照ください。

サポートされているオブジェクト および サポートされていないデータベースオブジェクトの両方に対する将来の付与は、データベースレベルとスキーマレベルで同期されます。セカンダリデータベースがセット内のプライマリデータベースに昇格された後、指定された型のオブジェクトを作成すると、将来の付与での定義に従って権限がロールに自動で付与されます。将来の付与の詳細については、 将来の付与を使用した付与管理の簡素化 をご参照ください。

共有複製¶

この機能は、共有オブジェクトと、データベースオブジェクトの共有に付与されたアクセス権限の複製をサポートします。

ターゲットアカウントのオブジェクトを更新するユーザー¶

ALTER REPLICATION GROUP ... REFRESH コマンドを実行して、ソースアカウントからターゲットアカウントのオブジェクトを更新するユーザーは、複製グループに対して REPLICATE 権限を持つロールを使用する必要があります。Snowflakeは、次のシナリオで失敗することにより、ターゲットアカウントでこのユーザーを保護します。

• ユーザーがソースアカウントに存在しない場合は、更新操作に失敗します。

• ユーザーがソースアカウントに存在するが、REPLICATE 権限を持つロールがユーザーに付与されていない場合は、更新操作に失敗します。

ステップ1:複製が有効なデータベースの複製を無効にする¶

複製グループに追加する前に、 SYSTEM$DISABLE_DATABASE_REPLICATION 関数を使用して、プライマリデータベースとそれにリンクされているセカンダリデータベースのデータベース複製を無効にします。

プライマリデータベースのソースアカウントから次の SQL ステートメントを実行します。

SELECT SYSTEM$DISABLE_DATABASE_REPLICATION('mydb');

ステップ2:データベースと共有をプライマリ複製グループに追加し、セカンダリ複製グループを作成する¶

データベース複製を正常に無効にすると、プライマリデータベースとプライマリ共有をソースアカウントの複製グループに追加できるようになります。

次に、各ターゲットアカウントにセカンダリ複製グループを作成します。セカンダリ複製グループが各ターゲットアカウントで更新されると、以前のセカンダリデータベースがセカンダリ複製グループのメンバーとして自動的に追加され、プライマリオブジェクトからの変更で更新されます。

プライマリおよびセカンダリ複製グループを作成し、ターゲットアカウントのオブジェクトの自動更新をスケジュールするには、以下の ワークフロー をご参照ください。

例¶

希望するSnowflakeクライアントで次の SQL ステートメントを実行して、データベースと共有複製を有効にし、スケジュールに従ってオブジェクトを更新します。

複製グループの REPLICATE 権限をロールに付与する --- オプション¶

現在、 REPLICATE 権限は複製 されない ため、ソースアカウントとターゲットアカウントの両方の複製グループで付与する必要があります。

ソースアカウントから実行:

-- Execute the following SQL statements using a role with the OWNERSHIP privilege on the group:
GRANT REPLICATE ON REPLICATION GROUP myrg TO ROLE my_replication_role;

Copy

ターゲットアカウントから実行:

-- Execute the following SQL statements using a role with the OWNERSHIP privilege on the group:
GRANT REPLICATE ON REPLICATION GROUP myrg TO ROLE my_replication_role;

Copy

手動でセカンダリ複製グループを更新する¶

たとえば、複製グループ myrg 内のオブジェクトを更新するには、ターゲットアカウントから次のステートメントを実行します。

USE ROLE my_replication_role;

-- Execute the following SQL statements using a role with the REPLICATE privilege:
ALTER REPLICATION GROUP myrg REFRESH;

Copy

前提条件¶

ステップ1: ソースアカウントに CREATE REPLICATION GROUP 権限を持つロールを作成する --- オプション¶

ロールを作成し、それに CREATE REPLICATION GROUP 権限を付与します。このステップはオプションです。このロールをすでに作成している場合は、 ステップ2: ソースアカウントにプライマリ複製グループを作成する にスキップします。

-- Execute the following SQL statements using the ACCOUNTADMIN role:
USE ROLE ACCOUNTADMIN;

CREATE ROLE myrole;

GRANT CREATE REPLICATION GROUP ON ACCOUNT
    TO ROLE myrole;

ステップ2: ソースアカウントにプライマリ複製グループを作成する¶

プライマリ複製グループを作成し、現在の（ソース）アカウントから同じ組織内にある1つ以上のターゲットアカウントに、指定されたデータベースと共有を複製できるようにします。

SHOW REPLICATION ACCOUNTS;

+------------------------+-------------------------+--------------+-----------------+-----------------+-------------------+
| snowflake_region       | created_on              | account_name | account_locator |  comment        | organization_name |
+------------------------+-------------------------+--------------+-----------------+-----------------+-------------------+
| AWS_US_WEST_2          | 2020-07-15 21:59:25.455 | myaccount1   | myacctlocator1  |                 | myorg             |
+------------------------+-------------------------+--------------+-----------------+-----------------+-------------------+
| AWS_US_EAST_1          | 2020-07-23 14:12:23.573 | myaccount2   | myacctlocator2  |                 | myorg             |
+------------------------+-------------------------+--------------+-----------------+-----------------+-------------------+
| AWS_US_EAST_2          | 2020-07-25 19:25:04.412 | myaccount3   | myacctlocator3  |                 | myorg             |
+------------------------+-------------------------+--------------+-----------------+-----------------+-------------------+

USE ROLE myrole;

-- Execute the following SQL statement using a role with the CREATE REPLICATION GROUP privilege:
CREATE REPLICATION GROUP myrg
    OBJECT_TYPES = databases, shares
    ALLOWED_DATABASES = db1, db2
    ALLOWED_SHARES = s1
    ALLOWED_ACCOUNTS = myorg.myaccount2;

ステップ3: ターゲットアカウントに CREATE REPLICATION GROUP 権限を持つロールを作成する --- オプション¶

ターゲットアカウントにロールを作成し、それに CREATE REPLICATION GROUP 権限を付与します。このステップはオプションです。このロールをすでに作成している場合は、 ステップ4: ターゲットアカウントにセカンダリ複製グループを作成する にスキップします。

-- Execute the following SQL statements using the ACCOUNTADMIN role:
USE ROLE ACCOUNTADMIN;

CREATE ROLE myrole;

GRANT CREATE REPLICATION GROUP ON ACCOUNT
    TO ROLE myrole;

ステップ4: ターゲットアカウントにセカンダリ複製グループを作成する¶

ソースアカウントのプライマリ複製グループのレプリカとして、ターゲットアカウントにセカンダリ複製グループを作成します。

ステップ2: ソースアカウントにプライマリ複製グループを作成する （このトピック内）で複製を有効にした各ターゲットアカウントで、 CREATE REPLICATION GROUP...AS REPLICA OF ステートメントを実行します。

各ターゲットアカウントから実行:

USE ROLE myrole;

-- Execute the following SQL statement using a role with the CREATE REPLICATION GROUP privilege:
CREATE REPLICATION GROUP myrg
  AS REPLICA OF myorg.myaccount1.myrg;

セカンダリ複製グループを手動で更新する¶

ターゲットアカウントのセカンダリ複製グループを手動で更新します。これにより、複製グループ内のすべてのオブジェクトが更新されます。

セカンダリ複製グループを更新します。

たとえば、複製グループ myrg 内のオブジェクトを更新するには、ターゲットアカウントから次のステートメントを実行します。

-- Only a user with the ACCOUNTADMIN role can execute the following SQL statement:
ALTER REPLICATION GROUP myrg REFRESH;

Copy

複製グループを表示する¶

複製グループを表示するには、 SHOW REPLICATION GROUPS を使用します。

現在のアカウントに関連付けられているすべてのプライマリおよびセカンダリ複製グループを表示するには、次の SQL ステートメントを実行します。

SHOW REPLICATION GROUPS;

Copy

コマンド出力:

+------------------+-------------------------------+--------------+------+-------------+---------+------------+------------------+--------------------------------------+------------------------------------------+--------------------+-----------------+----------------------+-----------------+------------+
| snowflake_region | created_on                    | account_name | name | type        | comment | is_primary | primary          | object_types                         | allowed_accounts                         | organization_name  | account_locator | replication_schedule | secondary_state | owner      |
+------------------+-------------------------------+--------------+------+-------------+---------+------------+------------------+--------------------------------------+------------------------------------------+--------------------+-----------------+----------------------+-----------------+------------+
| AWS_US_EAST_1    | 2022-01-14 16:59:01.462 -0800 | MYACCOUNT2   | MYRG | REPLICATION | NULL    | false      | MYORG.MYACCOUNT1 |                                      |                                          | MYORG              | MYACCTLOCATOR2  | 15 MINUTE            | SUSPENDED       |  NULL      |
| AWS_US_WEST_2    | 2022-01-14 16:56:10.497 -0800 | MYACCOUNT1   | MYRG | REPLICATION | NULL    | true       | MYORG.MYACCOUNT1 | DATABASES, SHARES                    | MYORG.MYACCOUNT2                         | MYORG              | MYACCTLOCATOR1  | 15 MINUTE            | NULL            |  MYROLE    |
+------------------+-------------------------------+--------------+------+-------------+---------+------------+------------------+--------------------------------------+------------------------------------------+--------------------+-----------------+----------------------+-----------------+------------+