ALTER ACCOUNT¶
アカウントを変更します。ALTER ACCOUNT コマンドには2つの目的があります。
アカウント管理者（つまり、 ACCOUNTADMIN ロールを持つユーザー）が、 パラメーター やその他の設定をアカウントレベルで変更できるようにします。たとえば、アカウント管理者はアカウントのリソースモニターを設定したり、セキュリティ機能を有効にしたりすることができます。これらのアクションでは、アカウント管理者は、変更されるアカウントから ALTER ACCOUNT を実行します。
組織管理者 がアカウントのコア特性を変更できるようにします。たとえば、組織管理者はアカウント名を変更することができます。これらのアクションでは、組織管理者は、変更されるアカウントとは別のアカウントから ALTER ACCOUNT を実行します。
注釈
ALTER ACCOUNT は主にアカウント管理者と組織管理者によって実行されますが、 SECURITYADMIN ロールを持つユーザーは、アカウントのネットワークポリシーを設定するために使用できます。
構文¶
ALTER ACCOUNT の構文は、 現在のアカウント を変更するか、 別のアカウント を変更するかによって異なります。
現在のアカウントの変更¶
条件：
注釈
読みやすくするために、アカウントに設定できるセッションパラメーターの完全なリストはここには含まれていません。すべてのセッションパラメーターの完全なリストとその説明、およびアカウントとオブジェクトのパラメーターついては、 パラメーター をご参照ください。
別のアカウントの変更¶
アカウントのプロパティ¶
現在のアカウントの次のプロパティを設定できます。
SET propertyアカウントに設定するプロパティを指定します。
LOGIN_IDP_REDIRECT = ( interface = security_integration [ , ... ] )Snowflakeインターフェースと SAML セキュリティ統合 間のマッピングを指定します。SAML セキュリティ統合は、シングルサインオン（SSO）認証を実装するために使用されます。インターフェースが SAML セキュリティ統合にマップされている場合、インターフェースにアクセスするユーザーは認証のためにサードパーティのIDプロバイダー（IdP）にリダイレクトされ、Snowflakeのログイン画面は表示されません。
インターフェースユーザーを自動的に IdP にリダイレクトしたくない場合、
interface = NULLを指定します。可能なインターフェースは次のとおりです。
DEFAULT = security_integrationデフォルトの セキュリティ統合を指定します。別のインターフェースから統合へのマッピングによってオーバーライドされない限り、ユーザーはSnowflakeインターフェースにアクセスするとき、自動的に統合の IdP に誘導されます。このマッピングを使用して、 Snowsight のセキュリティ統合を定義します。
SNOWFLAKE_INTELLIGENCE = security_integrationSnowflake Intelligence</user-guide/snowflake-cortex/snowflake-intelligence>`にアクセスしたときに、認証されていないユーザーをIdPにリダイレクトするために使用されるセキュリティ統合を指定します。これはSnowflake IntelligenceのDEFAULTマッピングを上書きします。詳細については、 :ref:`label-snowflake-intelligence-configure-redirect をご参照ください。
STREAMLIT = security_integration|sis|アプリビューアーURLsにアクセスしたときに、認証されていないユーザーをIdPにリダイレクトするために使用されるセキュリティ統合を指定します。これはStreamlitアプリビューアーURLsのDEFAULTマッピングを上書きします。詳細については、 アプリ閲覧者をIDプロバイダーにリダイレクトする をご参照ください。
デフォルト：空のリスト
( )OBJECT_VISIBILITY = {object_visibility_spec | PRIVILEGED }
プレビュー機能 --- オープン
すべてのアカウントで利用可能です。
アカウント内のオブジェクトの可視性を指定します。これにより、 :doc:` オブジェクトの検出可能性 </user-guide/ui-snowsight/object-visibility-universal-search>` が制御され、明示的なアクセス権限を持たないユーザーがオブジェクトを検索してアクセスをリクエストできるようになります。
次のいずれかの形式で可視性を記述する YAML 仕様：
Or
上記の構文では次のようになります。
all_accounts_including_external:組織内のすべてのアカウントのすべてのユーザーがオブジェクトを表示することができることを指定します。これには、組織内のすべてのアカウントが含まれます。これには、 :doc:` リーダーアカウント </user-guide/data-sharing-reader-create>` など、外部の関係者にアクセス権が付与されているアカウントも含まれます。
account: account_name:指定したアカウントのすべてのユーザーがオブジェクトを表示できるように指定します。アカウントは複数指定できます。accountはアカウントロケーターではなく、アカウント名であることに注意してください。組織名を除くアカウント名のみを指定する必要があります。09-22
organization_user_group: org_user_group:指定された 組織ユーザーグループ が、 組織ユーザーグループがインポートされた 組織内のすべてのアカウントのオブジェクトを表示できることを指定します。
PRIVILEGED:オブジェクトに対する明示的な権限が付与されている現在のアカウント内のロールのみがオブジェクトを表示できることを指定します。これはSnowflakeのデフォルトの動作です。例については、 ユニバーサル検索でデータベースオブジェクトを検出可能にする をご参照ください。
デフォルト:
'PRIVILEGED'
UNSET property指定されたアカウントプロパティをデフォルトに戻します。
現在のアカウントを変更するためのパラメーター¶
現在のアカウントを変更する場合は、以下のパラメーターを使用します。
アカウントレベルでのパラメーター設定の詳細については、 パラメーター管理 をご参照ください。特定のパラメーターの詳細については、 パラメーター をご参照ください。
SET ...アカウントに設定する1つ（または複数）のアカウント、セッション、オブジェクトパラメーター、オブジェクトプロパティを指定します（空白、カンマ、または改行で区切られます）。
アカウントパラメーターは、他のユーザーが変更することはできません。
アカウントレベルで設定されたセッションおよびオブジェクトパラメーターはデフォルトとしてのみ機能し、他のユーザーが変更できます。
アカウントに設定できるパラメーターの説明については、 パラメーター をご参照ください。
UNSET ...アカウントの設定を解除する1つ（または複数）のアカウント、セッション、およびオブジェクトのパラメーターを指定します。これにより、システムのデフォルトにリセットされます。
単一の ALTER ステートメントで複数のプロパティをリセットできます。ただし、各プロパティはカンマで区切る 必要があります。プロパティをリセットするときは、名前のみを指定します。プロパティの値を指定すると、エラーが返されます。
SET RESOURCE_MONITOR resource_monitor_nameアカウントで作成されたすべての仮想ウェアハウスを制御するために使用される、リソースモニターの名前を指定する特別なパラメーター。
重要
アカウントレベルでリソースモニターを設定しても、SnowflakeがSnowpipe、自動再クラスタリング、またはマテリアライズドビューに使用するSnowflake提供のウェアハウスには影響しません。これらのウェアハウスで消費されるクレジットは、アカウントレベルのリソースモニターのクレジットクォータにはカウントされません。
詳細については、 リソースモニターの操作 をご参照ください。
ADD ORGANIZATION USER GROUP group_name組織ユーザーグループ をアカウントにインポートします。グループ内の組織ユーザーは、ユーザーオブジェクトとしてアカウントに追加されます。
REMOVE ORGANIZATION USER GROUP group_name組織ユーザーグループ をアカウントから削除します。
SET { AUTHENTICATION | SESSION } POLICY policy_name [ { FOR ALL PERSON USERS | FOR ALL SERVICE USERS } ] [ FORCE ]アカウントの 認証ポリシー または セッションポリシー を指定します。
FOR ALL PERSON USERS句は、TYPE プロパティが NULL または PERSON に設定されているユーザーにポリシーを適用します。FOR ALL SERVICE USERS句は、TYPE プロパティが SERVICE または LEGACY_SERVICE に設定されているユーザーにポリシーを適用します。FOR ALL SERVICE USERSまたはFOR ALL PERSON USERSを指定しない場合、ポリシーはアカウント内のすべてのユーザーに適用されます。特定のユーザーまたは特定のユーザータイプにポリシーを明示的に設定した場合は、そのポリシーが
FOR ALL SERVICE USERSまたはFOR ALL PERSON USERSに適用されるポリシーよりも優先されます。FORCE を指定する場合、特定のユーザーまたは特定のユーザータイプに設定したポリシーはオーバーライドされます。これは、ポリシーの設定を解除したくない場合に利用できます。
現在のアカウントにポリシーがすでに設定されている場合は、既存のポリシーを先に設定解除することなく、FORCE を使用してポリシーを設定できます。
SET FEATURE POLICY policy_name FOR ALL APPLICATIONS [ FORCE ]アカウントに設定する機能ポリシーを指定します。現在のアカウントに既に機能ポリシーが設定されている場合、 FORCE を使用して、機能ポリシーを最初に設定解除することなく、機能ポリシーを設定することができます。
UNSET FEATURE POLICY FOR ALL APPLICATIONSアカウントの機能ポリシーの設定を解除します。
現在のアカウントにすでにポリシーを設定している場合は、既存のポリシーを先に設定解除する必要なく、FORCE を指定してポリシーを設定できます。
SET MAINTENANCE POLICY policy_name [ FORCE ] FOR ALL APPLICATIONSアカウント内のすべてのアプリケーションに適用する メンテナンスポリシー を指定します。アカウントにメンテナンスポリシーがすでに設定されている場合、最初にメンテナンスポリシーの設定を解除することなく、 FORCE を使用してメンテナンスポリシーを設定できます。
UNSET MAINTENANCE POLICY FOR ALL APPLICATIONSアカウント内のすべてのアプリケーションからメンテナンスポリシーを削除します。アカウント内のすべてのアプリケーションからメンテナンスポリシーが削除されると、アカウントレベルのメンテナンスポリシーが存在する場合はそのアカウントレベルのメンテナンスポリシーが適用されます。
UNSET { AUTHENTICATION | SESSION } POLICY [ FOR ALL PERSON USERS | FOR ALL SERVICE USERS ]アカウントの 認証ポリシー または セッションポリシー を設定解除します。
FOR ALL SERVICE USERSまたはFOR ALL PERSON USERSを指定すると、コマンドの範囲が絞り込まれます。アカウントのすべてのユーザーではなく、特定のユーザータイプからのみポリシーが設定解除されます。SET PACKAGES | PASSWORD POLICY policy_name [ FORCE ]アカウントの パッケージポリシー または パスワードポリシー を指定します。
現在のアカウントにすでにポリシーを設定している場合は、既存のポリシーを先に設定解除する必要なく、FORCE を指定してポリシーを設定できます。
UNSET { PACKAGES | PASSWORD } POLICY
別のアカウントを変更するためのパラメーター¶
現在のアカウントを使用して別のアカウントを変更する場合は、以下のパラメーターを使用します。組織管理者 のみが、これらのパラメーターを使用できます。
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アカウントの名前を指定された名前に変更します。
新しい名前は、すべての:ref:`アカウント識別子の要件<label-note-requirements-account-id>`に準拠する必要があります。
組織の管理者は、ログイン中にアカウントの名前を変更できないため、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 という名前のネットワークポリシーをアカウントに関連付けます。
ユーザー権限の付与を無効にします。
アカウントからネットワークポリシーの関連付けを削除します。
アカウントレベルでパッケージポリシーを設定します。
注釈
現在のアカウントにパッケージポリシーがすでに設定されている場合は、パッケージポリシーを最初に設定解除することなく、 FORCE を使用してパッケージポリシーを設定できます。
パッケージポリシーを設定解除します。