カテゴリ：: データベース、スキーマ、共有 DDL

ALTER SHARE¶

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

コンシューマーとデータを共有しようとしたときにエラーが発生した場合、アカウントでこの機能が有効になっていない可能性があります。有効化については、 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コンシューマーアカウントの追加を有効または無効にします。

重要

You must set this parameter each time you are adding a new non-Business Critical consumer account to the share belonging to a Business Critical provider. For more information see, Business CriticalアカウントからBusiness Critical以外のアカウントへの共有を有効にする.

SET...

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

COMMENT = '文字列'
共有のコメントを追加するか、既存のコメントを上書きします。

UNSET ...

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

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

使用上の注意¶

ACCOUNTADMIN ロールのみが共有を変更する権限を持っています。ACCOUNTADMIN 以外のロールでこのコマンドを実行すると、エラーが返されます。
キーワード ACCOUNT と ACCOUNTS はどちらもサポートされており、交換可能に使用できます。

例¶

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

ALTER SHARE sales_s ADD ACCOUNTS=xy12345,yz23456;

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

sales_s からアカウント yz23456 を削除します。

ALTER SHARE sales_s REMOVE ACCOUNT=yz23456;

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

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

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

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