コピー履歴を使用してデータロードのアクティビティをモニターする

Snowsight または SQL を使用すると、アカウント内のすべてのテーブル、または特定のテーブルのデータロードアクティビティをモニターできます。

コピー履歴を使用してアカウントのデータロードをモニターする

Snowsight の Copy History ページまたは SNOWFLAKE データベースの ACCOUNT_USAGE スキーマの COPY_HISTORY ビュー を使用して、アカウント内のすべてのテーブルについて、過去365日間に発生したデータロードのアクティビティを確認します。

アカウントレベルでのデータロードのアクティビティには最大2時間の遅延時間があり、 COPY INTO ステートメントを使用した一括データロード、パイプを使用した継続的なデータロード、およびウェブインターフェイスを介したファイルロードが含まれます。

前提条件

  • SNOWFLAKE データベースへのアクセス権限を持つロールを使用する必要があります。 他のロールに対する SNOWFLAKE データベース使用の有効化 をご参照ください。

  • Snowsight で Copy History ページを表示したり、 SNOWFLAKE データベースをクエリするには、ウェアハウスが必要です。ユーザープロファイルにデフォルトのウェアハウスがある場合、 Snowsight はそのウェアハウスを使用します。ウェアハウスはいつでも切り替えることができます。

アカウントレベルのコピー履歴を確認する

注釈

SNOWFLAKE データベースへのアクセス権限を持つロールを使用する必要があります。 他のロールに対する SNOWFLAKE データベース使用の有効化 をご参照ください。

  1. Snowsight にサインインします。

  2. Monitoring » Copy History を選択します。

Copies Over Time グラフでは、特定の期間におけるデータロードの視覚化が提供されます。デフォルトでは、グラフは7日間の履歴を表示し、グラフ上の各バーは1日を示しています。

グラフのバーを選択し、その日付で Copies テーブルをフィルターします。

データロードのアクティビティの詳細については、 Copies テーブルをご参照ください。テーブルには、次の情報が含まれています。

  • File Name はロードされたファイル名を表示します。

  • Loaded はデータがロードされたときのタイムスタンプをローカルタイムゾーンで表示します。

  • Status はデータロードのステータスを表示します。ステータスが Failed のデータロードにカーソルを合わせると、エラーの詳細を確認できます。

  • Database はデータがロードされたデータベースを表示します。

  • Schema はデータがロードされたスキーマを表示します。

  • Table はデータがロードされたテーブルを表示します。

  • Pipe はデータロードに使用されたパイプを表示します(該当する場合)。

  • Size はロードされたデータのサイズを KB、 MB、 GB、 TB で小数点以下を四捨五入して表示します。例えば、45800バイトをロードした場合、サイズは45.8KB と表示されます。

  • Rows はロードされた行数を表示します。小数点以下は四捨五入され、千、百万といった単位で表示されます。例えば、2000行のデータをロードした場合、行は2Kとして表示されます。

  • Location はデータがロードされた場所へのリンクを表示します。例えば、外部ステージとして追加された AWS S3 バケット、または内部の名前付きステージへのリンクです。リンクにカーソルを合わせるとステージ名が表示され、リンクを選択するとステージへのパスがコピーされます。

特定のデータロードのアクティビティをより簡単に特定するために、コピー履歴ページを検索し、フィルターすることができます。

次を使用してフィルターできます。

  • 時間範囲、最大365日(1年)

  • All (デフォルト)、 In progressLoadedFailedPartially loadedSkipped など、データロードのアクティビティのステータス。

  • データの場所:

    • データベース

    • スキーマ

    • パイプ

また、 Copies テーブルの列値を検索して、特定のデータロードのアクティビティを検索することもできます。

ワークシートで基になる SQL クエリを開くOpen underlying SQL query in worksheet)を選択して、テーブルにデータを入力するために使用される SQL クエリを含むワークシートを開きます。SQL クエリは、選択したフィルターに基づいています。

Copies テーブルで特定のデータロードのアクティビティを選択すると、 Snowsight でテーブルレベルの Copy History が開きます。 コピー履歴を使用してテーブルのデータロードをモニターする をご参照ください。遅延時間が短縮されたため、テーブルにより新しい結果が表示されるかもしれせんが、確認できるのは14日間のアクティビティのみです。

コピー履歴を使用してテーブルのデータロードをモニターする

Snowsight のテーブルの Copy History 詳細、または COPY_HISTORY テーブル関数を使用して、データベースの特定のテーブルに対して過去14日間に発生したデータロードのアクティビティを確認します。

テーブルレベルのデータロードは非常に遅延時間が少なく、 COPY INTO ステートメントを使用した一括データロード、パイプを使用した継続的なデータロード、ウェブインターフェイスを使用したファイルロードが含まれます。

前提条件

次のいずれかを持つロールを使用する必要があります。

  • Snowflakeアカウントに対する MONITOR 権限。

  • テーブルを含むデータベースとスキーマに対する USAGE 権限、およびテーブルに対するあらゆる権限。

パイプに対する MONITOR 権限を持たないロールを使用した場合、パイプの詳細は NULL としてマスクされます。

Snowsight でデータベースの Copy History 詳細を表示したり、テーブル機能を実行するには、ウェアハウスが必要です。ユーザープロファイルにデフォルトのウェアハウスがある場合、 Snowsight はそのウェアハウスを使用します。ウェアハウスはいつでも切り替えることができます。

テーブルレベルのコピー履歴を確認する

テーブルのコピー履歴を確認するには、アクティビティを確認したいテーブルを探して開きます。

  1. Snowsight にサインインします。

  2. Data » Databases を選択します。

  3. アクティビティを確認したいテーブルのあるデータベースを探して選択します。

  4. アクティビティを確認したいテーブルのあるスキーマを選択します。

  5. Tables を選択し、テーブルを選択します。

  6. テーブルの詳細で、 Copy History タブを選択します。

Copies Over Time グラフでは、特定の期間におけるデータロードの視覚化が提供されます。デフォルトでは、グラフは7日間の履歴を表示し、グラフ上の各バーは1日を示しています。

グラフのバーを選択し、その日付で Copies テーブルをフィルターします。

次を使用してフィルターできます。

  • 期間、最大14日。

  • All (デフォルト)、 In progressLoadedFailedPartially loadedSkipped など、データロードのアクティビティのステータス。

  • データのロードに使用されるパイプ。

また、 Copies テーブルの列値を検索して、特定のデータロードのアクティビティを検索することもできます。

ワークシートで基になる SQL クエリを開くOpen underlying SQL query in worksheet)を選択して、テーブルにデータを入力するために使用される SQL クエリを含むワークシートを開きます。SQL クエリは、選択したフィルターに基づいています。