コピー履歴を使用してデータロードのアクティビティをモニターする¶
Snowsight または SQL を使用すると、アカウント内のすべてのテーブル、または特定のテーブルのデータロードアクティビティをモニターできます。
コピー履歴を使用してアカウントのデータロードをモニターする¶
Snowsight の Copy History ページまたは SNOWFLAKE データベースの ACCOUNT_USAGE スキーマの COPY_HISTORY ビュー を使用して、アカウント内のすべてのテーブルについて、過去365日間に発生したデータロードのアクティビティを確認します。
アカウントレベルでのデータロードのアクティビティには最大2時間の遅延時間があり、 COPY INTO ステートメントを使用した一括データロード、パイプを使用した継続的なデータロード、およびウェブインターフェイスを介したファイルロードが含まれます。
前提条件¶
SNOWFLAKE データベースへのアクセス権限を持つロールを使用する必要があります。他のロールが SNOWFLAKE データベースのスキーマを使用できるようにする をご参照ください。
Snowsight で Copy History ページを表示したり、 SNOWFLAKE データベースをクエリするには、ウェアハウスが必要です。ユーザープロファイルにデフォルトのウェアハウスがある場合、 Snowsight はそのウェアハウスを使用します。ウェアハウスはいつでも切り替えることができます。
アカウントレベルのコピー履歴を確認する¶
注釈
SNOWFLAKE データベースへのアクセス権限を持つロールを使用する必要があります。他のロールが SNOWFLAKE データベースのスキーマを使用できるようにする をご参照ください。
Snowsight にサインインします。
ナビゲーションメニューで Ingestion » 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 progress、 Loaded、 Failed、 Partially loaded、 Skipped など、データロードのアクティビティのステータス。
データの場所:
データベース
スキーマ
パイプ
また、 Copies テーブルの列値を検索して、特定のデータロードのアクティビティを検索することもできます。
（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 はそのウェアハウスを使用します。ウェアハウスはいつでも切り替えることができます。
テーブルレベルのコピー履歴を確認する¶
テーブルのコピー履歴を確認するには、アクティビティを確認したいテーブルを探して開きます。
Snowsight にサインインします。
ナビゲーションメニューで Catalog » Database Explorer を選択します。
アクティビティを確認したいテーブルのあるデータベースを探して選択します。
アクティビティを確認したいテーブルのあるスキーマを選択します。
Tables を選択し、テーブルを選択します。
テーブルの詳細で、 Copy History タブを選択します。
Copies Over Time グラフでは、特定の期間におけるデータロードの視覚化が提供されます。デフォルトでは、グラフは7日間の履歴を表示し、グラフ上の各バーは1日を示しています。
グラフのバーを選択し、その日付で Copies テーブルをフィルターします。
次を使用してフィルターできます。
期間、最大14日。
All （デフォルト）、 In progress、 Loaded、 Failed、 Partially loaded、 Skipped など、データロードのアクティビティのステータス。
データのロードに使用されるパイプ。
また、 Copies テーブルの列値を検索して、特定のデータロードのアクティビティを検索することもできます。
（Open underlying SQL query in worksheet）を選択して、テーブルにデータを入力するために使用される SQL クエリを含むワークシートを開きます。SQL クエリは、選択したフィルターに基づいています。