ALTER ONLINE FEATURE TABLE

既存の オンライン機能テーブル のプロパティを変更します。

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

CREATE ONLINE FEATURE TABLEDESCRIBE ONLINE FEATURE TABLEDROP ONLINE FEATURE TABLESHOW 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>
Copy

パラメーター

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> ... ]
  }
Copy
SET TAG

オンライン機能テーブルに指定されたタグとタグ値を設定します。

UNSET TAG

オンライン機能テーブルで指定されたタグを設定解除します。

アクセス制御の要件

権限

オブジェクト

メモ

OWNERSHIP

オンライン機能テーブル

オンライン機能テーブルで OWNERSHIP 権限を持つロール。

USAGE

ウェアハウス

ウェアハウスを変更するときに必要

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

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

使用上の注意

  • メタデータについて:

    注意

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

次の例では、 my_online_feature_table というオンライン機能テーブルの定期的なバックグラウンド更新を一時停止します。

ALTER ONLINE FEATURE TABLE my_online_feature_table SUSPEND;
Copy

次の例では、 my_online_feature_table というオンライン機能テーブルを手動で更新します。

ALTER ONLINE FEATURE TABLE my_online_feature_table REFRESH;
Copy

次の例では、 my_online_feature_table というオンライン機能テーブルのターゲットラグを変更します。

ALTER ONLINE FEATURE TABLE my_online_feature_table SET TARGET_LAG = '1 minute';
Copy

次の例では、オンライン機能テーブル my_online_feature_table の名前を my_new_online_feature_table に変更します。

ALTER ONLINE FEATURE TABLE my_online_feature_table RENAME TO my_new_online_feature_table;
Copy