ALTER ACCOUNT¶

構文¶

ALTER ACCOUNT の構文は、現在のアカウントを変更するか、別のアカウントを変更するかによって異なります。

ALTER ACCOUNT SET { [ accountParams ] [ objectParams ] [ sessionParams ] }

ALTER ACCOUNT UNSET <param_name> [ , ... ]

ALTER ACCOUNT SET RESOURCE_MONITOR = <monitor_name>

ALTER ACCOUNT SET { AUTHENTICATION | PASSWORD | SESSION } POLICY <policy_name>

ALTER ACCOUNT UNSET { AUTHENTICATION | PASSWORD | SESSION } POLICY

ALTER ACCOUNT SET PACKAGES POLICY <policy_name> [ FORCE ]

ALTER ACCOUNT UNSET { PACKAGES | PASSWORD | SESSION } POLICY

ALTER ACCOUNT SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER ACCOUNT UNSET TAG <tag_name> [ , <tag_name> ... ]

ALTER ACCOUNT <name> SET IS_ORG_ADMIN = { TRUE | FALSE }

ALTER ACCOUNT <name> RENAME TO <new_name> [ SAVE_OLD_URL = { TRUE | FALSE } ]

ALTER ACCOUNT <name> DROP OLD URL

ALTER ACCOUNT <name> DROP OLD ORGANIZATION URL

現在のアカウントを変更するためのパラメーター¶

現在のアカウントを変更する場合は、以下のパラメーターを使用します。

SET ...

アカウントに設定する1つ（または複数）のアカウント、セッション、およびオブジェクトパラメーターを指定します（空白、カンマ、または改行で区切られます）。

• アカウントパラメーターは、他のユーザーが変更することはできません。

• アカウントレベルで設定されたセッションおよびオブジェクトパラメーターはデフォルトとしてのみ機能し、他のユーザーが変更できます。

アカウントに設定できるパラメーターの説明については、 パラメーター をご参照ください。

UNSET ...

アカウントの設定を解除する1つ（または複数）のアカウント、セッション、およびオブジェクトのパラメーターを指定します。これにより、システムのデフォルトにリセットされます。

単一の ALTER ステートメントで複数のプロパティをリセットできます。ただし、各プロパティはカンマで区切る 必要があります。プロパティをリセットするときは、名前のみを指定します。プロパティの値を指定すると、エラーが返されます。

SET RESOURCE_MONITOR resource_monitor_name

アカウントで作成されたすべての仮想ウェアハウスを制御するために使用される、リソースモニターの名前を指定する特別なパラメーター。

重要

アカウントレベルでリソースモニターを設定しても、SnowflakeがSnowpipe、自動再クラスタリング、またはマテリアライズドビューに使用するSnowflake提供のウェアハウスには影響しません。これらのウェアハウスで消費されるクレジットは、アカウントレベルのリソースモニターのクレジットクォータにはカウントされません。

詳細については、 リソースモニターの操作 をご参照ください。

SET { AUTHENTICATION | PASSWORD | SESSION } POLICY policy_name

アカウントに対して以下のポリシーのいずれかを指定します。

• 認証ポリシー

• パスワードポリシー

• セッションポリシー

SET PACKAGES POLICY policy_name [ FORCE ]

アカウントに設定する パッケージポリシー を指定します。現在のアカウントにパッケージポリシーがすでに設定されている場合は、パッケージポリシーを最初に設定解除することなく、 FORCE を使用してパッケージポリシーを設定できます。

UNSET { PACKAGES | PASSWORD | SESSION } POLICY

アカウントのパッケージポリシー、パスワードポリシー、またはセッションポリシーを設定解除します。

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

タグ の名前とタグ文字列の値を指定します。

タグ値は常に文字列であり、タグ値の最大文字数は256です。

ステートメントでのタグの指定に関する情報については、 オブジェクトおよび列のタグクォータ をご参照ください。

別のアカウントを変更するためのパラメーター¶

現在のアカウントを使用して別のアカウントを変更する場合は、以下のパラメーターを使用します。これらの関数を使用できるのは、組織管理者（つまり、 ORGADMIN ロールを持つユーザー）のみです。

name

変更するアカウント名を指定します。

SET

アカウントに設定するアカウントプロパティを指定します。

IS_ORG_ADMIN = { TRUE | FALSE }

アカウントで ORGADMIN ロールが有効になっているかどうかを識別するアカウントプロパティを設定します。このプロパティを設定できるのは、組織管理者（つまり、 ORGADMIN ロールを持つユーザー）のみです。

アカウントの ORGADMIN ロールを有効にするには、 SET IS_ORG_ADMIN = TRUE を指定します。

現在のアカウントからプロパティを FALSE に設定することはできません。回避策として、別のアカウントでロールを有効にし、 ALTER ACCOUNT コマンドを実行する前にそのアカウントに切り替えます。

デフォルトでは、 ORGADMIN のロールは最大8つのアカウントで有効にすることができます。お客様の組織で ORGADMIN ロールを持つアカウントがさらに必要な場合は、 Snowflakeサポート にお問い合わせください。

RENAME TO new_name

アカウントの名前を指定された名前に変更します。

組織の管理者は、ログイン中にアカウントの名前を変更できないため、ALTER ACCOUNT コマンドを実行する前に別のアカウントにログインする必要があります。名前を変更する必要がある単一のアカウントで組織が構成されている場合は、 Snowflakeサポート にお問い合わせください。

SAVE_OLD_URL = { TRUE | FALSE }

名前を変更する前に、Snowflakeのアクセスに使用する アカウント URL を保持する RENAME TO と、組み合わせて使用されるオプションのパラメーター。デフォルトでは、Snowflakeは元の URL を保存します。つまり、古い URL または新しいアカウント名を含む URL のいずれかでアカウントにアクセスできます。 FALSE に設定した場合、アカウントにアクセスするには新しい URL を使用する必要があります。

デフォルト:

TRUE

DROP OLD URL

名前が変更されたアカウントの元の アカウント URL を削除します。古い URL がドロップされたら、新しいアカウント名を含む URL でアカウントにアクセスする必要があります。

古いアカウント URL がある場合は、アカウントが別の組織に移されたか、組織名が変更されたか、アカウントがマージされた組織の一部の場合です。代わりに、 ALTER ACCOUNT ... DROP OLD ORGANIZATION URL を使用します。

DROP OLD ORGANIZATION URL

以下のいずれかが起きた場合には、アカウントの元の アカウントURL を削除します。

• アカウントが別の組織に移された

• アカウントの組織名が変更された。

• アカウントは他の組織と合併した組織の一部だった。

組織ではなくアカウントの名前が変更されたためにアカウントに古いアカウント URL がある場合は、代わりに ALTER ACCOUNT ... DROP OLD URL コマンドを使用します。

使用上の注意¶

• アカウントパラメーターは、アカウントレベルでのみ設定できます。

• このコマンドを使用して設定されるセッションおよびオブジェクトパラメーターは、デフォルトとしてのみ機能します。

  • ユーザーパラメーターは、個別のユーザーレベルで上書きできます。

  • セッションパラメーターは、個々のユーザーおよびセッションレベルで上書きできます。

  • オブジェクトパラメータは、個々のオブジェクトレベルで上書きできます。

• アカウントレベルでリソースモニターを設定すると、アカウントで作成されたすべての仮想ウェアハウスのクレジット使用状況が制御されますが、Snowflakeが提供するウェアハウスのクレジット使用状況には影響しません。詳細については、 リソースモニターの操作 をご参照ください。

• メタデータについて。

  注意

  Snowflakeサービスを使用する場合、お客様は、個人データ（ユーザーオブジェクト向け以外）、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールド をご参照ください。

例¶

mypolicy という名前のネットワークポリシーをアカウントに関連付けます。

ALTER ACCOUNT SET NETWORK_POLICY = mypolicy;

Copy

アカウントからネットワークポリシーの関連付けを削除します。

ALTER ACCOUNT UNSET NETWORK_POLICY;

Copy

アカウントレベルでパッケージポリシーを設定します。

ALTER ACCOUNT SET PACKAGES POLICY packages_policy_prod_1 FORCE;

Copy

注釈

現在のアカウントにパッケージポリシーがすでに設定されている場合は、パッケージポリシーを最初に設定解除することなく、 FORCE を使用してパッケージポリシーを設定できます。

パッケージポリシーを設定解除します。

ALTER ACCOUNT UNSET PACKAGES POLICY;

Copy