ALTER ONLINE FEATURE TABLE¶
既存の オンライン機能テーブル のプロパティを変更します。
- こちらもご参照ください。
CREATE ONLINE FEATURE TABLE、 DESCRIBE ONLINE FEATURE TABLE、 DROP ONLINE FEATURE TABLE、 SHOW ONLINE FEATURE TABLES
構文¶
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> { SUSPEND | RESUME }
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> RENAME TO <new_name>
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> REFRESH
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> SET
[ TARGET_LAG = '<num> { seconds | minutes | hours | days }' ]
[ WAREHOUSE = <warehouse_name> ]
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> <tagAction>
パラメーター¶
name変更するオンライン機能テーブルの識別子を指定します。
識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。
詳細については、 識別子の要件 をご参照ください。
RENAME TO new_nameオンライン機能テーブルの名前を
new_nameに変更します。新しい識別子は、スキーマに対して一意にする必要があります。識別子の詳細については、 識別子の要件 をご参照ください。
オブジェクトの名前を変更すると、そのオブジェクトを参照する他のオブジェクトも新しい名前で更新する必要があります。
SUSPEND | RESUMEテーブル内にあるデータの定期的なバックグラウンド更新を一時停止するか再開するかを指定します。
SUSPENDオンライン機能テーブルの定期的なバックグラウンド更新を一時停止します。
RESUMEオンライン機能テーブルの定期的なバックグラウンド更新を再開します。
REFRESHオンライン機能テーブルを手動で更新する必要があることを指定します。
SET ...オンライン機能テーブルの1つ以上の指定されたプロパティまたはパラメーターを設定します。
TARGET_LAG = 'num { seconds | minutes | hours | days }'バックグラウンド更新のスケジュールを定義するために使用する、新しいターゲットラグを指定します。
値は10秒以上8日以下である必要があります。
WAREHOUSE = warehouse_nameオンライン機能テーブルを更新するためのコンピューティングリソースを提供する新しいウェアハウスの名前を指定します。
COMMENT = 'string_literal'オンライン機能テーブルのコメントを追加するか、既存のコメントを上書きします。
tagActionオンライン機能テーブルのタグを設定または設定解除します。
tagAction ::= { SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ] | UNSET TAG <tag_name> [ , <tag_name> ... ] }
SET TAGオンライン機能テーブルに指定されたタグとタグ値を設定します。
UNSET TAGオンライン機能テーブルで指定されたタグを設定解除します。
アクセス制御の要件¶
権限 |
オブジェクト |
メモ |
|---|---|---|
OWNERSHIP |
オンライン機能テーブル |
オンライン機能テーブルで OWNERSHIP 権限を持つロール。 |
USAGE |
ウェアハウス |
ウェアハウスを変更するときに必要 |
指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。
セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。
使用上の注意¶
メタデータについて:
注意
Snowflakeサービスを使用する場合、お客様は、個人データ(ユーザーオブジェクト向け以外)、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールド をご参照ください。
例¶
次の例では、 my_online_feature_table というオンライン機能テーブルの定期的なバックグラウンド更新を一時停止します。
ALTER ONLINE FEATURE TABLE my_online_feature_table SUSPEND;
次の例では、 my_online_feature_table というオンライン機能テーブルを手動で更新します。
ALTER ONLINE FEATURE TABLE my_online_feature_table REFRESH;
次の例では、 my_online_feature_table というオンライン機能テーブルのターゲットラグを変更します。
ALTER ONLINE FEATURE TABLE my_online_feature_table SET TARGET_LAG = '1 minute';
次の例では、オンライン機能テーブル my_online_feature_table の名前を my_new_online_feature_table に変更します。
ALTER ONLINE FEATURE TABLE my_online_feature_table RENAME TO my_new_online_feature_table;