--- title: "メタデータインポート | COMETA Docs" slug: "metadata-import-v2" updated: 2025-12-08T06:02:40Z published: 2025-12-08T06:02:40Z canonical: "documents.trocco.io/metadata-import-v2" --- > ## Documentation Index > Fetch the complete documentation index at: https://documents.trocco.io/llms.txt > Use this file to discover all available pages before exploring further. # メタデータインポート ## 概要 CSVファイルを用いて、以下をインポートできます。 - [基本メタデータ](/cometa/docs/table-information-v2#1-%E5%9F%BA%E6%9C%AC%E3%83%A1%E3%82%BF%E3%83%87%E3%83%BC%E3%82%BF) - [ユーザー定義メタデータ](/cometa/docs/table-information-v2#4-%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E5%AE%9A%E7%BE%A9%E3%83%A1%E3%82%BF%E3%83%87%E3%83%BC%E3%82%BF) - [カラム参照](/cometa/docs/column-reference-v2) なお、インポートの結果は画面下部のインポート履歴より確認できます。 ![metadata-import-v2-2024-08-29-12-40-0](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/metadata-import-v2-2024-08-29-12-40-0.png) ## メタデータインポートの制約 必要な権限 メタデータインポートには、以下の権限が必要です。 - [メタデータアクセスコントロール](/cometa/docs/metadata-access-control-v2)による対象アセットへのアクセス許可 - [**メタデータ編集者**](/cometa/docs/cometa-roles-v2#%E3%83%A1%E3%82%BF%E3%83%87%E3%83%BC%E3%82%BF%E7%B7%A8%E9%9B%86%E8%80%85)ロール ### CSVファイルに関する制約 CSVファイルの文字コード **UTF-8**を推奨しています。 UTF-8以外の文字コードの場合、一部文字が読み取れないことがあります。 CSVファイルの各種上限値 - アップロードできるCSVファイルのファイルサイズは、最大**100MB**です。 - ユーザー定義メタデータ・カラム参照のインポートの場合、1ファイルで最大**1000行**まで入力できます。 ### インポートデータに関する制約 カラム参照のインポートに関する制約 - 異なるデータ型のカラム間にカラム参照は追加できません。 - 異なるBigQueryプロジェクトのカラム間にカラム参照は追加できません。 - 異なるデータストアのカラム間にカラム参照は追加できません。 ユーザー定義メタデータのインポートに関する制約 `Boolean`型のフィールドに入力できる値は以下のとおりです。 いずれも、ダブルクオーテーション("")で囲う必要はありません。 - `0`または`1` - `true`または`false` - `TRUE`または`FALSE` ### インポートに関する注意事項 すでにメタデータが入力されていた場合 インポート対象のアセットにメタデータの値がすでに入力されている場合、インポートされた値によって既存の値は上書きされます。 ## CSVファイルのフォーマット データストアを選択し、**CSVテンプレートをダウンロード**をクリックしてください。 ダウンロードされたCSVファイルを適宜編集し、アップロードおよびインポートを実行してください。 1行目にフィールド名が入力された状態のCSVがダウンロードされます。 2行目以降に適宜メタデータを入力してください。 ### 基本メタデータ・ユーザー定義メタデータのインポートフォーマット 以下では、データストアごとのCSVファイルの構成を説明しています。 オーナー・ステータス・カテゴリ値に関する制約 オーナー・ステータス・カテゴリ値はメタデータインポートでは入力できません。 画面上から個別に入力してください。 #### BigQueryのデータストアをお使いの場合 それぞれ、以下のフィールドは必須入力項目となります。 - データベース基本メタデータ・データベースユーザー定義メタデータの場合 - `project_id` - スキーマ基本メタデータ・スキーマユーザー定義メタデータの場合 - `project_id,dataset_id` - テーブル基本メタデータ・テーブルユーザー定義メタデータの場合 - `project_id,dataset_id,table_id` - カラム基本メタデータ・カラムユーザー定義メタデータの場合 - `project_id,dataset_id,table_id,column_id` 以下は、各フィールドの説明です。 | カラム名 | 必須 | 入力する情報 | | --- | --- | --- | | `project_id` | ✓ | プロジェクト名 本フィールドは常に入力必須となります。 | | `dataset_id` | ✓* | データセット名 以下のインポートの場合に入力必須となります。 - スキーマ基本メタデータ・スキーマユーザー定義メタデータ - テーブル基本メタデータ・テーブルユーザー定義メタデータ - カラム基本メタデータ・カラムユーザー定義メタデータ | | `table_id` | ✓* | テーブル名 以下のインポートの場合に入力必須となります。 - テーブル基本メタデータ・テーブルユーザー定義メタデータ - カラム基本メタデータ・カラムユーザー定義メタデータ | | `column_id` | ✓* | テーブルに紐づくカラム名 以下のインポートの場合に入力必須となります。 - カラム基本メタデータ・カラムユーザー定義メタデータ | | `logical_name` | - | 論理名フィールドに入力したい値 基本メタデータのインポートの場合に入力できます。 フィールドを指定して値を空欄にした場合、既存データは空で上書きされます。 フィールド自体を省略した場合、既存データが保持されます。 | | `description` | - | 説明フィールドに入力したい値 基本メタデータのインポートの場合に入力できます。 フィールドを指定して値を空欄にした場合、既存データは空で上書きされます。 フィールド自体を省略した場合、既存データが保持されます。 | | (ユーザー定義メタデータのフィールド) | - | [ユーザー定義メタデータ用テンプレート](/cometa/docs/user-defined-metadata-templates-v2)で定義されたフィールドに入力したい値 ユーザー定義メタデータの場合に入力できます。 | #### Snowflakeのデータストアをお使いの場合 それぞれ、以下のフィールドは必須入力項目となります。 - データベース基本メタデータ・データベースユーザー定義メタデータの場合 - `database_name` - スキーマ基本メタデータ・スキーマユーザー定義メタデータの場合 - `database_name,schema_name` - テーブル基本メタデータ・テーブルユーザー定義メタデータの場合 - `database_name,schema_name,table_name` - カラム基本メタデータ・カラムユーザー定義メタデータの場合 - `database_name,schema_name,table_name,column_name` 以下は、各フィールドの説明です。 | カラム名 | 必須 | 入力する情報 | | --- | --- | --- | | `database_name` | ✓ | データベース名 本フィールドは常に入力必須となります。 | | `schema_name` | ✓* | スキーマ名 以下のインポートの場合に入力必須となります。 - スキーマ基本メタデータ・スキーマユーザー定義メタデータ - テーブル基本メタデータ・テーブルユーザー定義メタデータ - カラム基本メタデータ・カラムユーザー定義メタデータ | | `table_name` | ✓* | テーブル名 以下のインポートの場合に入力必須となります。 - テーブル基本メタデータ・テーブルユーザー定義メタデータ - カラム基本メタデータ・カラムユーザー定義メタデータ | | `column_name` | ✓* | テーブルに紐づくカラム名 以下のインポートの場合に入力必須となります。 - カラム基本メタデータ・カラムユーザー定義メタデータ | | `logical_name` | - | 論理名フィールドに入力したい値 基本メタデータのインポートの場合に入力できます。 フィールドを指定して値を空欄にした場合、既存データは空で上書きされます。 フィールド自体を省略した場合、既存データが保持されます。 | | `description` | - | 説明フィールドに入力したい値 基本メタデータのインポートの場合に入力できます。 フィールドを指定して値を空欄にした場合、既存データは空で上書きされます。 フィールド自体を省略した場合、既存データが保持されます。 | | (ユーザー定義メタデータのフィールド) | - | [ユーザー定義メタデータ用テンプレート](/cometa/docs/user-defined-metadata-templates-v2)で定義されたフィールドに入力したい値 ユーザー定義メタデータの場合に入力できます。 | CSVファイルの入力例 以下は、BigQueryのデータストアのテーブル基本メタデータをインポートする場合に用いるCSVファイルの例です。 ![image](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/metadata-import-v2-2024-08-29-12-40-1.png) ### カラム参照のインポートフォーマット #### BigQueryのデータストアをお使いの場合 以下のフィールドに対して値を入力します。 `src_project_id,src_dataset_id,src_table_id,src_column_id,dst_project_id,dst_dataset_id,dst_table_id,dst_column_id` 以下は、各フィールドの説明です。 | カラム名 | 必須 | 入力する情報 | | --- | --- | --- | | `src_project_id` | ✓ | 参照元のプロジェクト名 | | `src_dataset_id` | ✓ | 参照元のデータセット名 | | `src_table_id` | ✓ | 参照元のテーブル名 | | `src_column_id` | ✓ | 参照元のカラム名 | | `dst_project_id` | ✓ | 参照先のプロジェクト名 | | `dst_dataset_id` | ✓ | 参照先のデータセット名 | | `dst_table_id` | ✓ | 参照元のテーブル名 | | `dst_column_id` | ✓ | 参照先のカラム名 | #### Snowflakeのデータストアをお使いの場合 以下のフィールドに対して値を入力します。 `src_database_name,src_schema_name,src_table_name,src_column_name,dst_database_name,dst_schema_name,dst_table_name,dst_column_name` 以下は、各フィールドの説明です。 | カラム名 | 必須 | 入力する情報 | | --- | --- | --- | | `src_database_name` | ✓ | 参照元のデータベース名 | | `src_schema_name` | ✓ | 参照元のスキーマ名 | | `src_table_name` | ✓ | 参照元のテーブル名 | | `src_column_name` | ✓ | 参照元のカラム名 | | `dst_database_name` | ✓ | 参照先のデータベース名 | | `dst_schema_name` | ✓ | 参照先のスキーマ名 | | `dst_table_name` | ✓ | 参照元のテーブル名 | | `dst_column_name` | ✓ | 参照先のカラム名 | ## インポートに失敗した場合 **インポート履歴**の**エラーログを表示**をクリックし、エラーの原因を確認してください。 ![metadata-import-v2-2024-08-29-12-40-2](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/metadata-import-v2-2024-08-29-12-40-2.png)