ALTER TYPE

既存の:doc:`ユーザー定義型</sql-reference/data-types-user-defined>`のプロパティを変更します。

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

CREATE TYPE、 DESCRIBE TYPE、 SHOW TYPES、 DROP TYPE、 UNDROP TYPE

構文

ALTER TYPE [ IF EXISTS ] <name> SET
  COMMENT = '<string_literal>'

ALTER TYPE [ IF EXISTS ] <name> UNSET COMMENT

パラメーター

name

変更するユーザー定義型の識別子を指定します。

識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

詳細については、 識別子の要件 をご参照ください。

SET ...

ユーザー定義型に設定するプロパティを指定します。

COMMENT = 'string_literal'

ユーザー定義型のコメントを追加するか、既存のコメントを上書きします。

UNSET ...

ユーザー定義型の設定を解除するプロパティを指定し、それらをデフォルトにリセットします。

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

アクセス制御の要件

この操作の実行に使用される ロール には、少なくとも次の 権限 が必要です。

権限

オブジェクト

メモ

OWNERSHIP

ユーザー定義型

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

スキーマ内のオブジェクトを操作するには、親データベースの少なくとも1つの権限と、親スキーマの少なくとも1つの権限が必要です。

指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。

セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。

使用上の注意

  • メタデータについて:

    注意

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

例

``age``ユーザー定義型にコメントを追加します。

ALTER TYPE age SET COMMENT = 'User-defined type for storing age values';

``age``ユーザー定義型からコメントを削除します。

ALTER TYPE age UNSET COMMENT;