- 一般的な参照情報
- SQL コマンドリファレンス
- コマンドの概要
- すべてのコマンド(アルファベット順)
- ALTER <オブジェクト>
- ALTER ACCOUNT
- ALTER API INTEGRATION
- ALTER DATABASE
- ALTER EXTERNAL FUNCTION
- ALTER EXTERNAL TABLE
- ALTER FILE FORMAT
- ALTER FUNCTION
- ALTER INTEGRATION
- ALTER MASKING POLICY
- ALTER MATERIALIZED VIEW
- ALTER NETWORK POLICY
- ALTER NOTIFICATION INTEGRATION
- ALTER PIPE
- ALTER PROCEDURE
- ALTER RESOURCE MONITOR
- ALTER ROLE
- ALTER SCHEMA
- ALTER SECURITY INTEGRATION
- ALTER SEQUENCE
- ALTER SESSION
- ALTER SHARE
- ALTER STAGE
- ALTER STORAGE INTEGRATION
- ALTER STREAM
- ALTER TABLE
- ALTER TABLE ... ALTER COLUMN
- ALTER TASK
- ALTER USER
- ALTER VIEW
- ALTER WAREHOUSE
- BEGIN
- CALL
- COMMENT
- COMMIT
- COPY INTO <場所>
- COPY INTO <テーブル>
- CREATE <オブジェクト>
- CREATE ACCOUNT
- CREATE API INTEGRATION
- CREATE <オブジェクト> ... CLONE
- CREATE DATABASE
- CREATE EXTERNAL FUNCTION
- CREATE EXTERNAL TABLE
- CREATE FILE FORMAT
- CREATE FUNCTION
- CREATE INTEGRATION
- CREATE MANAGED ACCOUNT
- CREATE MASKING POLICY
- CREATE MATERIALIZED VIEW
- CREATE NETWORK POLICY
- CREATE NOTIFICATION INTEGRATION
- CREATE PIPE
- CREATE PROCEDURE
- CREATE RESOURCE MONITOR
- CREATE ROLE
- CREATE SCHEMA
- CREATE SECURITY INTEGRATION
- CREATE SEQUENCE
- CREATE SHARE
- CREATE STAGE
- CREATE STORAGE INTEGRATION
- CREATE STREAM
- CREATE TABLE
- CREATE | ALTER TABLE ... CONSTRAINT
- CREATE TASK
- CREATE USER
- CREATE VIEW
- CREATE WAREHOUSE
- DELETE
- DESCRIBE <オブジェクト>
- DESCRIBE EXTERNAL TABLE
- DESCRIBE FILE FORMAT
- DESCRIBE FUNCTION
- DESCRIBE INTEGRATION
- DESCRIBE MASKING POLICY
- DESCRIBE MATERIALIZED VIEW
- DESCRIBE NETWORK POLICY
- DESCRIBE PIPE
- DESCRIBE PROCEDURE
- DESCRIBE RESULT
- DESCRIBE SEQUENCE
- DESCRIBE SHARE
- DESCRIBE STAGE
- DESCRIBE STREAM
- DESCRIBE TABLE
- DESCRIBE TASK
- DESCRIBE USER
- DESCRIBE VIEW
- DROP <オブジェクト>
- DROP DATABASE
- DROP EXTERNAL TABLE
- DROP FILE FORMAT
- DROP FUNCTION
- DROP INTEGRATION
- DROP MANAGED ACCOUNT
- DROP MASKING POLICY
- DROP MATERIALIZED VIEW
- DROP NETWORK POLICY
- DROP PIPE
- DROP PROCEDURE
- DROP RESOURCE MONITOR
- DROP ROLE
- DROP SCHEMA
- DROP SEQUENCE
- DROP SHARE
- DROP STAGE
- DROP STREAM
- DROP TABLE
- DROP TASK
- DROP USER
- DROP VIEW
- DROP WAREHOUSE
- EXPLAIN
- GET
- GRANT OWNERSHIP
- GRANT <権限> ... TO ROLE
- GRANT <privilege> ... TO SHARE
- GRANT ROLE
- INSERT
- INSERT (マルチテーブル)
- LIST
- MERGE
- PUT
- REMOVE
- REVOKE <権限> ... FROM ROLE
- REVOKE <privilege> ...FROM SHARE
- REVOKE ROLE
- ROLLBACK
- SELECT
- SET
- SHOW <オブジェクト>
- SHOW COLUMNS
- SHOW DATABASES
- SHOW DELEGATED AUTHORIZATIONS
- SHOW EXTERNAL FUNCTIONS
- SHOW EXTERNAL TABLES
- SHOW FILE FORMATS
- SHOW FUNCTIONS
- SHOW GLOBAL ACCOUNTS
- SHOW GRANTS
- SHOW INTEGRATIONS
- SHOW LOCKS
- SHOW MANAGED ACCOUNTS
- SHOW MASKING POLICIES
- SHOW MATERIALIZED VIEWS
- SHOW NETWORK POLICIES
- SHOW OBJECTS
- SHOW ORGANIZATION ACCOUNTS
- SHOW PARAMETERS
- SHOW PIPES
- SHOW PROCEDURES
- SHOW REGIONS
- SHOW REPLICATION ACCOUNTS
- SHOW REPLICATION DATABASES
- SHOW RESOURCE MONITORS
- SHOW ROLES
- SHOW SCHEMAS
- SHOW SEQUENCES
- SHOW SHARES
- SHOW STAGES
- SHOW STREAMS
- SHOW TABLES
- SHOW TASKS
- SHOW TRANSACTIONS
- SHOW USER FUNCTIONS
- SHOW USERS
- SHOW VARIABLES
- SHOW VIEWS
- SHOW WAREHOUSES
- TRUNCATE MATERIALIZED VIEW
- TRUNCATE TABLE
- UNDROP DATABASE
- UNDROP SCHEMA
- UNDROP TABLE
- UNSET
- UPDATE
- USE <object>
- USE DATABASE
- USE ROLE
- USE SCHEMA
- USE WAREHOUSE
- DDL コマンド
- DML コマンド
- クエリ構文
- クエリ演算子
- SQL 関数リファレンス
- 付録
- カテゴリ:
ALTER SHARE¶
プロバイダーの共有は、ほとんどのアカウントでデフォルトで有効になっていますが、すべてのアカウントで有効なわけではありません。
コンシューマーとデータを共有しようとしたときにエラーが発生した場合、アカウントでこの機能が有効になっていない可能性があります。有効化については、 Snowflakeサポート にお問い合わせください。
既存の 共有 のプロパティを変更します。
アカウントのリストに対してアカウントを追加または削除します。
共有に対応するデータベースが共有されるアカウントの新しいリストを設定します。
他のプロパティを変更します。パラメーターの詳細については、 パラメーター をご参照ください。
- こちらもご参照ください。
構文¶
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. | +----------------------------------+