メインコンテンツまでスキップ
バージョン: 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 Cluster を経由せず、ScalarDB Core ライブラリを直接使用して ScalarDB からデータを読み取ります。そのため、ScalarDB Cluster でのみ利用可能な機能 (暗号化など) は ScalarDB データソースでは使用できません。

スキャン動作

ScalarDB データソースは、内部的に Scan オペレーションの all() を使用してデータを読み取ります。このオペレーションには クロスパーティションスキャン設定を有効にする必要があります。フィルタリングとオーダリングは ScalarDB レベルでは適用されません。関連する設定は以下のとおりです:

  • scalar.db.cross_partition_scan.enabled は true である必要があります (デフォルトは true)。
  • scalar.db.cross_partition_scan.filtering.enabled は効果がありません。
  • scalar.db.cross_partition_scan.ordering.enabled は効果がありません。
注記

フィルタープッシュダウンなどの最適化は、将来のリリースでサポートされる可能性があります。

ScalarDB Core 設定のオーバーライド

ScalarDB Core の設定プロパティは、ScalarDB データソースとして使用する場合にも基本的に反映されます。ただし、以下のプロパティは ScalarDB Analytics によってオーバーライドされます:

  • scalar.db.scan_fetch_size: ユーザーが明示的に設定していない場合、ScalarDB Core のデフォルト値 10 の代わりに 4096 が設定されます。
  • scalar.db.consensus_commit.isolation_level: ユーザーが指定した値にかかわらず、常に READ_COMMITTED でオーバーライドされます。

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

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

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

データソースを 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
テクニカルサポートに問い合わせ
商用ライセンスをご契約のお客様のみご利用いただけます。
ドキュメントの問題を報告
このページについて何かお気づきの点がありましたら、こちらから報告いただけます。