REFRESH (具体化されたビューとストリーミング テーブル)

適用対象: Databricks SQL

重要

この機能はパブリック プレビュー段階にあります。 アクセスにサインアップするには、このフォームに入力します。

ストリーミング テーブルまたは具体化されたビューのデータを更新します。 データは非同期で更新されます。 DESCRIBE EXTENDED を実行することで更新の状態を追跡できます。

構文

REFRESH { MATERIALIZED VIEW | [ STREAMING ] TABLE } table_name [ FULL ]

パラメーター

• table_name

  更新する具体化されたビューまたはストリーミング テーブルを識別します。 この名前には、テンポラル仕様を含めることはできません。 オブジェクトが見つからない場合、Azure Databricks で TABLE_OR_VIEW_NOT_FOUND エラーが発生します。

• FULL

  完全更新を実行するかどうか。完全更新の場合、ストリーミング テーブルの最新の定義によりテーブルが切り詰められ、ソースで利用できるすべてのデータが処理されます。 具体化されたビューでは、完全更新はサポートされていません。

  完全更新では既存のデータが切り詰められるため、データの履歴全体を保持しないソースや、Kafka など、保持期間が短いソースの場合、完全更新の呼び出しは推奨されません。 ソースでデータが使用できなくなった場合、古いデータを回復できないことがあります。

例

-- Refreshes the materialized view to reflect the latest available data
> REFRESH MATERIALIZED VIEW catalog.schema.view_name;

-- Refreshes the streaming table to process the latest available data
-- The current catalog and schema will be used to qualify the table
> REFRESH STREAMING TABLE st_name;

-- Truncates the table and processes all data from scratch for the streaming table
> REFRESH TABLE cat.db.st_name FULL;

関連するステートメント

• CREATE MATERIALIZED VIEW
• CREATE STREAMING TABLE