メインコンテンツまでスキップ
バージョン: 3.17
Features and pricing

データソースリファレンス

注記

このページは英語版のページが機械翻訳されたものです。英語版との間に矛盾または不一致がある場合は、英語版を正としてください。

このリファレンスガイドでは、ScalarDB Analytics のデータソース設定形式、プロバイダー固有の設定、およびデータ型マッピングに関する詳細情報を提供します。

警告

ScalarDB Analytics を使用するには、ライセンスキー (試用ライセンスまたは商用ライセンス) が必要です。ライセンスキーをお持ちでない場合は、お問い合わせください。

データソース登録ファイル形式​

データソースは、プロバイダー設定ファイルを使用して CLI でカタログに登録されます。これらのファイルは各データソースタイプの接続設定を定義します。CLI コマンドの詳細については、CLI コマンドリファレンスを参照してください。

プロバイダー設定ファイルは以下の構造を持ちます:

{
  "type": "<database-type>", // データベースタイプ: postgresql, mysql, scalardb, sqlserver, oracle, dynamodb, databricks, snowflake
  // タイプ固有の接続設定
  // 設定はデータベースタイプによって異なります
}

カタログ名とデータソース名はCLIオプションで指定されます。(--catalog および --data-source)

ファイル参照構文

外部ファイルから設定値を読み込むために ${file:path} 構文を使用できます。これは既存の設定ファイルを再利用したり、機密情報を分離したりするのに便利です。

サポートされているファイル形式:

  • .properties ファイル: 読み込まれて文字列値を持つ JSON オブジェクトに変換されます
  • .json ファイル: そのまま読み込まれます (有効な JSON 構造)

例:

{
  "type": "scalardb",
  "configs": "${file:/path/to/scalardb.properties}"
}

タイプ別のプロバイダー設定​

以下のセクションでは、サポートされている各データベースタイプのプロバイダー設定を示します:

設定

ScalarDBの設定は以下の通りです。

configs

  • フィールド: configs
  • 説明: ScalarDB 設定プロパティのマップ。これらは ScalarDB 設定ファイルで指定されるのと同じプロパティです。設定を JSON オブジェクトとしてインラインで指定するか、${file:path} 構文でファイル参照を使用できます。

例

インライン設定:

{
  "type": "scalardb",
  "configs": {
    "scalar.db.contact_points": "localhost",
    "scalar.db.username": "admin",
    "scalar.db.password": "admin",
    "scalar.db.storage": "jdbc"
  }
}

propertiesファイルでのファイル参照の使用:

{
  "type": "scalardb",
  "configs": "${file:/path/to/scalardb.properties}"
}

カタログ情報リファレンス​

このセクションでは、データソース別のカタログ構造マッピングとデータ型マッピングについて説明します。

データソース別のカタログ構造マッピング​

データソースを ScalarDB Analytics に登録する際、データソースのカタログ構造、すなわち名前空間、テーブル、列が解決され、ユニバーサルデータカタログに登録されます。データソースのカタログ構造を解決するために、データソース側の特定のオブジェクトがユニバーサルデータカタログオブジェクトにマッピングされます。

カタログレベルのマッピング​

カタログレベルのマッピングは、データソースからユニバーサルデータカタログへの名前空間名、テーブル名、列名のマッピングです。各データソースでのカタログレベルのマッピングを確認するには、データソースを選択してください。

ScalarDB のカタログ構造は ScalarDB Analytics によって自動的に解決されます。カタログレベルのオブジェクトは以下のようにマッピングされます:

  • ScalarDB 名前空間は名前空間にマッピングされます。したがって、ScalarDB データソースの名前空間は常に単一レベルで、名前空間名のみで構成されます。
  • ScalarDB テーブルはテーブルにマッピングされます。
  • ScalarDB 列は列にマッピングされます。

データ型マッピング​

以下のセクションでは、各データソースのネイティブ型が ScalarDB Analytics 型にどのようにマッピングされるかを示します:

警告

以下のマッピングテーブルに含まれていないデータ型の列は、データソース登録時に無視されます。これらの列は ScalarDB Analytics カタログに表示されず、クエリすることもできません。無視された列の情報は ScalarDB Analytics サーバーログに記録されます。

ScalarDB データ型ScalarDB Analytics データ型
BOOLEANBOOLEAN
INTINT
BIGINTBIGINT
FLOATFLOAT
DOUBLEDOUBLE
TEXTTEXT
BLOBBLOB
DATEDATE
TIMETIME
TIMESTAMPTIMESTAMP
TIMESTAMPTZTIMESTAMPTZ