カテゴリ：

データベース、スキーマ、共有 DDL

ALTER SHARE

Snowflake logo in black (no text) すべてのアカウントでプロバイダー共有が有効になっていません

プロバイダーの共有は、ほとんどのアカウントでデフォルトで有効になっていますが、すべてのアカウントで有効なわけではありません。

コンシューマーとデータを共有しようとしたときにエラーが発生した場合、アカウントでこの機能が有効になっていない可能性があります。有効化については、 Snowflakeサポート にお問い合わせください。

既存の 共有 のプロパティを変更します。

  • アカウントのリストに対してアカウントを追加または削除します。

  • 共有に対応するデータベースが共有されるアカウントの新しいリストを設定します。

  • 他のプロパティを変更します。パラメーターの詳細については、 パラメーター をご参照ください。

こちらもご参照ください。

CREATE SHARE 、 DESCRIBE SHARE 、 SHOW SHARES

構文

ALTER SHARE [ IF EXISTS ] <name> { ADD | REMOVE } ACCOUNTS = <consumer_account> [ , <consumer_account> , ... ]
                                        [ SHARE_RESTRICTIONS = { TRUE | FALSE } ]

ALTER SHARE [ IF EXISTS ] <name>  ADD ACCOUNTS = <consumer_account> [ , <consumer_account> , ... ]
                                        [ SHARE_RESTRICTIONS = { TRUE | FALSE } ]

ALTER SHARE [ IF EXISTS ] <name> SET { [ ACCOUNTS = <consumer_account> [ , <consumer_account> ... ] ]
                                       [ COMMENT = '<string_literal>' ] }

ALTER SHARE [ IF EXISTS ] <name> UNSET COMMENT

パラメーター

名前

変更する共有の識別子を指定します。識別子にスペースまたは特殊文字が含まれる場合、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

ADD | REMOVE ACCOUNTS = コンシューマーアカウント [ , コンシューマーアカウント , ... ]

共有のアカウントのリストに追加または削除するアカウントの名前を指定します。

  • 既にリストにあった共有にアカウントを追加しても効果はありません。

  • 既に共有データベースをインポートしているアカウントを削除すると、そのアカウントのデータベースへのアクセスがすぐに取り消されます。アカウントが後で共有に再度追加された場合、データベースを再作成してからアカウントを再使用する必要があります。

  • 共有アカウントのリストにまだない共有からアカウントを削除しても効果はありません。

このパラメーターは、共有のアカウントの既存のリストに対する追加（または削除）を行います。アカウントのリスト全体を置き換える場合は、代わりに SET を使用します。

SHARE_RESTRICTIONS = TRUE | FALSE

Business Criticalデータプロバイダーに属する共有へのStandardまたはEnterpriseコンシューマーアカウントの追加を有効または無効にします。

重要

Business Criticalプロバイダーに属する共有に、Business Critical以外の新しいコンシューマーアカウントを追加するたびに、このパラメーターを設定する必要があります。詳細については、 Business CriticalアカウントからBusiness Critical以外のアカウントへの共有を有効にする をご参照ください。

SET...

ACCOUNTS = コンシューマーアカウント [ , コンシューマーアカウント ... ]

共有が共有されていた以前のすべてのアカウントを 置換 するアカウントを指定します。リストに対して個々のアカウントを追加/削除するには、代わりに ADD | REMOVE を使用します。

COMMENT = '文字列'

共有のコメントを追加するか、既存のコメントを上書きします。

UNSET ...

共有の設定を解除するプロパティを指定します。これにより、デフォルトにリセットされます。

現在、設定を解除できるプロパティは COMMENT のみ、これにより、共有のコメントがあれば削除されます。

使用上の注意

  • 共有を変更するには、次のいずれかの権限が必要です。

    • 共有を作成するロールに付与される OWNERSHIP 権限。

    • CREATE SHARE 権限。デフォルトでは、 ACCOUNTADMIN のみが CREATE SHARE 権限を持っています。ACCOUNTADMIN は、他の任意のロールに権限を付与できます。共有の所有者はこの権限を付与できません。

  • キーワード ACCOUNT と ACCOUNTS はどちらもサポートされており、互換的に使用できます。

例

sales_s という名前の既存の共有に2つのアカウントを追加します。

ALTER SHARE sales_s ADD ACCOUNTS=<orgname.accountname1>,<orgname.accountname2>;

+----------------------------------+
| status                           |
|----------------------------------|
| Statement executed successfully. |
+----------------------------------+

アカウント <orgname.accountname>; を sales_s から削除します。

ALTER SHARE sales_s REMOVE ACCOUNT=<orgname.accountname>;

+----------------------------------+
| status                           |
|----------------------------------|
| Statement executed successfully. |
+----------------------------------+

sales_s に新しいコメントを設定します。

ALTER SHARE sales_s SET COMMENT='This share contains sales data for 2017';

+----------------------------------+
| status                           |
|----------------------------------|
| Statement executed successfully. |
+----------------------------------+