カテゴリ:

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

ALTER SHARE

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

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

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

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

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

CREATE SHAREDESCRIBE SHARESHOW 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 のみ、これにより、共有のコメントがあれば削除されます。

使用上の注意

  • ACCOUNTADMIN ロールのみが共有を変更する権限を持っています。ACCOUNTADMIN 以外のロールでこのコマンドを実行すると、エラーが返されます。

  • キーワード ACCOUNTACCOUNTS はどちらもサポートされており、交換可能に使用できます。

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. |
+----------------------------------+