メタデータインポート
  • 13 May 2024
  • PDF

メタデータインポート

  • PDF

記事の要約

概要

CSVファイルを用いて、以下をインポートできます。

なお、インポートの結果は画面下部のインポート履歴より確認できます。

metadata-import-v2_001.png

メタデータインポートの制約

必要なロール

メタデータインポートには、メタデータ編集者ロールが必要です。

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-説明フィールドに入力したい値
    基本メタデータのインポートの場合に入力できます。
    (ユーザー定義メタデータのフィールド)-ユーザー定義メタデータ用テンプレートで定義されたフィールドに入力したい値
    ユーザー定義メタデータの場合に入力できます。

    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-説明フィールドに入力したい値
    基本メタデータのインポートの場合に入力できます。
    (ユーザー定義メタデータのフィールド)-ユーザー定義メタデータ用テンプレートで定義されたフィールドに入力したい値
    ユーザー定義メタデータの場合に入力できます。
    CSVファイルの入力例

    以下は、BigQueryのデータストアのテーブル基本メタデータをインポートする場合に用いるCSVファイルの例です。

    image

    カラム参照のインポートフォーマット

    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_002.png


    この記事は役に立ちましたか?