diff --git a/i18n/versioned_docs/ja-jp/docusaurus-plugin-content-docs/current/scalardb-analytics/reference-data-source.mdx b/i18n/versioned_docs/ja-jp/docusaurus-plugin-content-docs/current/scalardb-analytics/reference-data-source.mdx index 5c53306eb..15ef95fb0 100644 --- a/i18n/versioned_docs/ja-jp/docusaurus-plugin-content-docs/current/scalardb-analytics/reference-data-source.mdx +++ b/i18n/versioned_docs/ja-jp/docusaurus-plugin-content-docs/current/scalardb-analytics/reference-data-source.mdx @@ -4,8 +4,8 @@ tags: displayed_sidebar: docsJapanese --- -import Tabs from '@theme/Tabs'; -import TabItem from '@theme/TabItem'; +import Tabs from "@theme/Tabs"; +import TabItem from "@theme/TabItem"; # ScalarDB Analytics データソースリファレンス @@ -26,7 +26,7 @@ import TranslationBanner from "/src/components/_translation-ja-jp.mdx"; { "catalog": "", // データソースを登録するカタログ "name": "", // このデータソースの一意の名前 - "type": "", // データベースタイプ: postgres, mysql, scalardb, sqlserver, oracle, dynamodb + "type": "", // データベースタイプ: postgres, mysql, scalardb, sqlserver, oracle, dynamodb, databricks, snowflake "provider": { // タイプ固有の接続設定 // 設定はデータベースタイプによって異なります @@ -271,6 +271,106 @@ SQL Server の設定は以下の通りです。 ``` + + +

設定

+ +Databricks (Databricks SQL/JDBC) の設定は以下の通りです。 + +

`host`

+ +- **フィールド:** `host` +- **説明:** Databricks ワークスペースのホスト名(例: `adb-1234567890123.4.azuredatabricks.net`)。 + +

`port`

+ +- **フィールド:** `port` +- **説明:** ポート番号。 +- **デフォルト値:** ドライバーのデフォルト。(任意) + +

`httpPath`

+ +- **フィールド:** `httpPath` +- **説明:** SQL ウェアハウスまたはクラスターの HTTP パス (例: `/sql/1.0/warehouses/xxxxxxxxxxxxxx`)。 + +

`oAuthClientId`

+ +- **フィールド:** `oAuthClientId` +- **説明:** Databricks SQL/JDBC 認証の OAuth クライアントID。 + +

`oAuthSecret`

+ +- **フィールド:** `oAuthSecret` +- **説明:** Databricks SQL/JDBC 認証の OAuth クライアントシークレット。 + +

`catalog`

+ +- **フィールド:** `catalog` +- **説明:** 既定で使用するカタログ。(任意) + +

+ +```json +{ + "catalog": "production", + "name": "databricks_analytics", + "type": "databricks", + "provider": { + "host": "adb-1234567890123.4.azuredatabricks.net", + "port": 443, + "httpPath": "/sql/1.0/warehouses/xxxxxxxxxxxxxx", + "oAuthClientId": "YOUR_CLIENT_ID", + "oAuthSecret": "YOUR_CLIENT_SECRET", + "catalog": "main" + } +} +``` + +
+ + +

設定

+ +Snowflake の設定は以下の通りです。 + +

`account`

+ +- **フィールド:** `account` +- **説明:** Snowflake アカウント識別子 (例: `xy12345.ap-northeast-1`)。 + +

`username`

+ +- **フィールド:** `username` +- **説明:** データベースユーザー。 + +

`password`

+ +- **フィールド:** `password` +- **説明:** データベースパスワード。 + +

`database`

+ +- **フィールド:** `database` +- **説明:** 解決/インポート対象とする既定のデータベース。(任意) + +

+ +```json +{ + "catalog": "production", + "name": "snowflake_dwh", + "type": "snowflake", + "provider": { + "account": "YOUR-ACCOUNT", + "username": "analytics_user", + "password": "secure_password", + "database": "ANALYTICS" + } +} +``` + +
+

設定

@@ -400,7 +500,7 @@ schema フィールドには以下の構造が必要です: カタログレベルのマッピングは、データソースから名前空間名、テーブル名、および列名をユニバーサルデータカタログへのマッピングです。各データソースでのカタログレベルのマッピングを確認するには、データソースを選択してください。 - + ScalarDB のカタログ構造は ScalarDB Analytics によって自動的に解決されます。カタログレベルのオブジェクトは以下のようにマッピングされます: @@ -410,7 +510,7 @@ schema フィールドには以下の構造が必要です: - + PostgreSQL のカタログ構造は ScalarDB Analytics によって自動的に解決されます。カタログレベルのオブジェクトは以下のようにマッピングされます: - PostgreSQL スキーマは名前空間にマッピングされます。したがって、PostgreSQL データソースの名前空間は常に単一レベルで、スキーマ名のみで構成されます。 @@ -480,7 +580,7 @@ schema フィールドには以下の構造が必要です: SQL Server のカタログ構造は ScalarDB Analytics によって自動的に解決されます。カタログレベルのオブジェクトは以下のようにマッピングされます: - - SQL Server データベースとスキーマは共に名前空間にマッピングされます。したがって、SQL Server データソースの名前空間は常に2レベルで、データベース名とスキーマ名で構成されます。 + - SQL Server の各データベース・スキーマペアは ScalarDB Analytics の名前空間にマッピングされます。したがって、SQL Server データソースの名前空間は常に2レベルで、データベース名とスキーマ名で構成されます。 - ユーザー定義データベースのみが名前空間にマッピングされます。以下のシステムデータベースは無視されます: - `sys` - `guest` @@ -502,6 +602,29 @@ schema フィールドには以下の構造が必要です: - SQL Server テーブルはテーブルにマッピングされます。 - SQL Server 列は列にマッピングされます。 + + + + Databricks のカタログ構造は ScalarDB Analytics によって自動的に解決されます。カタログレベルのオブジェクトは以下のようにマッピングされます: + + - Databricks の各カタログ・スキーマペアは ScalarDB Analytics の名前空間にマッピングされます。したがって、Databricks データソースの名前空間は常に2レベルで、カタログ名とスキーマ名で構成されます。 + - 以下のシステム カタログ/スキーマは無視されます: + - **カタログ:** `system` + - **スキーマ:** `information_schema`, `global_temp`, `sys`, `routines` + - Databricks のテーブルはテーブルにマッピングされます。 + - Databricks の列は列にマッピングされます。 + + + + Snowflake のカタログ構造は ScalarDB Analytics によって自動的に解決されます。カタログレベルのオブジェクトは以下のようにマッピングされます: + + - Snowflake の各データベース・スキーマペアは ScalarDB Analytics の名前空間にマッピングされます。したがって、Snowflake データソースの名前空間は常に2レベルで、データベース名とスキーマ名で構成されます。 + - 以下のシステム データベース/スキーマは無視されます: + - **データベース:** `SNOWFLAKE` + - **スキーマ:** `INFORMATION_SCHEMA` + - Snowflake のテーブルはテーブルにマッピングされます。 + - Snowflake の列は列にマッピングされます。 + DynamoDB はスキーマレスであるため、DynamoDB データソースを登録する際に以下のような形式の JSON を使用してカタログ構造を明示的に指定する必要があります: @@ -549,145 +672,182 @@ schema フィールドには以下の構造が必要です: | **ScalarDB データ型** | **ScalarDB Analytics データ型** | -| :--------------------- | :------------------------------- | -| `BOOLEAN` | `BOOLEAN` | -| `INT` | `INT` | -| `BIGINT` | `BIGINT` | -| `FLOAT` | `FLOAT` | -| `DOUBLE` | `DOUBLE` | -| `TEXT` | `TEXT` | -| `BLOB` | `BLOB` | -| `DATE` | `DATE` | -| `TIME` | `TIME` | -| `TIMESTAMP` | `TIMESTAMP` | -| `TIMESTAMPTZ` | `TIMESTAMPTZ` | +| :-------------------- | :------------------------------ | +| `BOOLEAN` | `BOOLEAN` | +| `INT` | `INT` | +| `BIGINT` | `BIGINT` | +| `FLOAT` | `FLOAT` | +| `DOUBLE` | `DOUBLE` | +| `TEXT` | `TEXT` | +| `BLOB` | `BLOB` | +| `DATE` | `DATE` | +| `TIME` | `TIME` | +| `TIMESTAMP` | `TIMESTAMP` | +| `TIMESTAMPTZ` | `TIMESTAMPTZ` | -| **PostgreSQL データ型** | **ScalarDB Analytics データ型** | -| :---------------------------- | :------------------------------- | -| `integer` | `INT` | -| `bigint` | `BIGINT` | -| `real` | `FLOAT` | -| `double precision` | `DOUBLE` | -| `smallserial` | `SMALLINT` | -| `serial` | `INT` | -| `bigserial` | `BIGINT` | -| `char` | `TEXT` | -| `varchar` | `TEXT` | -| `text` | `TEXT` | -| `bpchar` | `TEXT` | -| `boolean` | `BOOLEAN` | -| `bytea` | `BLOB` | -| `date` | `DATE` | -| `time` | `TIME` | -| `time with time zone` | `TIME` | -| `time without time zone` | `TIME` | -| `timestamp` | `TIMESTAMP` | -| `timestamp with time zone` | `TIMESTAMPTZ` | -| `timestamp without time zone` | `TIMESTAMP` | +| **PostgreSQL データ型** | **ScalarDB Analytics データ型** | +| :---------------------------- | :------------------------------ | +| `integer` | `INT` | +| `bigint` | `BIGINT` | +| `real` | `FLOAT` | +| `double precision` | `DOUBLE` | +| `smallserial` | `SMALLINT` | +| `serial` | `INT` | +| `bigserial` | `BIGINT` | +| `char` | `TEXT` | +| `varchar` | `TEXT` | +| `text` | `TEXT` | +| `bpchar` | `TEXT` | +| `boolean` | `BOOLEAN` | +| `bytea` | `BLOB` | +| `date` | `DATE` | +| `time` | `TIME` | +| `time with time zone` | `TIME` | +| `time without time zone` | `TIME` | +| `timestamp` | `TIMESTAMP` | +| `timestamp with time zone` | `TIMESTAMPTZ` | +| `timestamp without time zone` | `TIMESTAMP` | -| **MySQL データ型** | **ScalarDB Analytics データ型** | -| :------------------- | :------------------------------- | -| `bit` | `BOOLEAN` | -| `bit(1)` | `BOOLEAN` | -| `bit(x)` if _x >= 2_ | `BLOB` | -| `tinyint` | `SMALLINT` | -| `tinyint(1)` | `BOOLEAN` | -| `boolean` | `BOOLEAN` | -| `smallint` | `SMALLINT` | -| `smallint unsigned` | `INT` | -| `mediumint` | `INT` | -| `mediumint unsigned` | `INT` | -| `int` | `INT` | -| `int unsigned` | `BIGINT` | -| `bigint` | `BIGINT` | -| `float` | `FLOAT` | -| `double` | `DOUBLE` | -| `real` | `DOUBLE` | -| `char` | `TEXT` | -| `varchar` | `TEXT` | -| `text` | `TEXT` | -| `binary` | `BLOB` | -| `varbinary` | `BLOB` | -| `blob` | `BLOB` | -| `date` | `DATE` | -| `time` | `TIME` | -| `datetime` | `TIMESTAMP` | -| `timestamp` | `TIMESTAMPTZ` | +| **MySQL データ型** | **ScalarDB Analytics データ型** | +| :------------------- | :------------------------------ | +| `bit` | `BOOLEAN` | +| `bit(1)` | `BOOLEAN` | +| `bit(x)` if _x >= 2_ | `BLOB` | +| `tinyint` | `SMALLINT` | +| `tinyint(1)` | `BOOLEAN` | +| `boolean` | `BOOLEAN` | +| `smallint` | `SMALLINT` | +| `smallint unsigned` | `INT` | +| `mediumint` | `INT` | +| `mediumint unsigned` | `INT` | +| `int` | `INT` | +| `int unsigned` | `BIGINT` | +| `bigint` | `BIGINT` | +| `float` | `FLOAT` | +| `double` | `DOUBLE` | +| `real` | `DOUBLE` | +| `char` | `TEXT` | +| `varchar` | `TEXT` | +| `text` | `TEXT` | +| `binary` | `BLOB` | +| `varbinary` | `BLOB` | +| `blob` | `BLOB` | +| `date` | `DATE` | +| `time` | `TIME` | +| `datetime` | `TIMESTAMP` | +| `timestamp` | `TIMESTAMPTZ` | -| **Oracle データ型** | **ScalarDB Analytics データ型** | -| :------------------------------- | :------------------------------- | -| `NUMBER` if _scale = 0_ | `BIGINT` | -| `NUMBER` if _scale > 0_ | `DOUBLE` | -| `FLOAT` if _precision ≤ 53_ | `DOUBLE` | -| `BINARY_FLOAT` | `FLOAT` | -| `BINARY_DOUBLE` | `DOUBLE` | -| `CHAR` | `TEXT` | -| `NCHAR` | `TEXT` | -| `VARCHAR2` | `TEXT` | -| `NVARCHAR2` | `TEXT` | -| `CLOB` | `TEXT` | -| `NCLOB` | `TEXT` | -| `BLOB` | `BLOB` | -| `BOOLEAN` | `BOOLEAN` | -| `DATE` | `DATE` | -| `TIMESTAMP` | `TIMESTAMPTZ` | -| `TIMESTAMP WITH TIME ZONE` | `TIMESTAMPTZ` | -| `TIMESTAMP WITH LOCAL TIME ZONE` | `TIMESTAMP` | -| `RAW` | `BLOB` | +| **Oracle データ型** | **ScalarDB Analytics データ型** | +| :------------------------------- | :------------------------------ | +| `NUMBER` if _scale = 0_ | `BIGINT` | +| `NUMBER` if _scale > 0_ | `DOUBLE` | +| `FLOAT` if _precision ≤ 53_ | `DOUBLE` | +| `BINARY_FLOAT` | `FLOAT` | +| `BINARY_DOUBLE` | `DOUBLE` | +| `CHAR` | `TEXT` | +| `NCHAR` | `TEXT` | +| `VARCHAR2` | `TEXT` | +| `NVARCHAR2` | `TEXT` | +| `CLOB` | `TEXT` | +| `NCLOB` | `TEXT` | +| `BLOB` | `BLOB` | +| `BOOLEAN` | `BOOLEAN` | +| `DATE` | `DATE` | +| `TIMESTAMP` | `TIMESTAMPTZ` | +| `TIMESTAMP WITH TIME ZONE` | `TIMESTAMPTZ` | +| `TIMESTAMP WITH LOCAL TIME ZONE` | `TIMESTAMP` | +| `RAW` | `BLOB` | | **SQL Server データ型** | **ScalarDB Analytics データ型** | -| :----------------------- | :------------------------------- | -| `bit` | `BOOLEAN` | -| `tinyint` | `SMALLINT` | -| `smallint` | `SMALLINT` | -| `int` | `INT` | -| `bigint` | `BIGINT` | -| `real` | `FLOAT` | -| `float` | `DOUBLE` | -| `float(n)` if _n ≤ 24_ | `FLOAT` | -| `float(n)` if _n ≥ 25_ | `DOUBLE` | -| `binary` | `BLOB` | -| `varbinary` | `BLOB` | -| `char` | `TEXT` | -| `varchar` | `TEXT` | -| `nchar` | `TEXT` | -| `nvarchar` | `TEXT` | -| `ntext` | `TEXT` | -| `text` | `TEXT` | -| `date` | `DATE` | -| `time` | `TIME` | -| `datetime` | `TIMESTAMP` | -| `datetime2` | `TIMESTAMP` | -| `smalldatetime` | `TIMESTAMP` | -| `datetimeoffset` | `TIMESTAMPTZ` | +| :---------------------- | :------------------------------ | +| `bit` | `BOOLEAN` | +| `tinyint` | `SMALLINT` | +| `smallint` | `SMALLINT` | +| `int` | `INT` | +| `bigint` | `BIGINT` | +| `real` | `FLOAT` | +| `float` | `DOUBLE` | +| `float(n)` if _n ≤ 24_ | `FLOAT` | +| `float(n)` if _n ≥ 25_ | `DOUBLE` | +| `binary` | `BLOB` | +| `varbinary` | `BLOB` | +| `char` | `TEXT` | +| `varchar` | `TEXT` | +| `nchar` | `TEXT` | +| `nvarchar` | `TEXT` | +| `ntext` | `TEXT` | +| `text` | `TEXT` | +| `date` | `DATE` | +| `time` | `TIME` | +| `datetime` | `TIMESTAMP` | +| `datetime2` | `TIMESTAMP` | +| `smalldatetime` | `TIMESTAMP` | +| `datetimeoffset` | `TIMESTAMPTZ` | + + + + +| **Databricks SQL データ型** | **ScalarDB Analytics データ型** | +| :-------------------------- | :---------------------------------------------------------------------------------- | +| `TINYINT` | `SMALLINT` | +| `SMALLINT` | `SMALLINT` | +| `INT` / `INTEGER` | `INT` | +| `BIGINT` | `BIGINT` | +| `FLOAT` | `FLOAT` | +| `DOUBLE` | `DOUBLE` | +| `DECIMAL(p,0)` | `BYTE` (p ≤ 2), `SMALLINT` (3–4), `INT` (5–9), `BIGINT` (10–18), `DECIMAL` (p > 18) | +| `STRING` / `VARCHAR` | `TEXT` | +| `BINARY` | `BLOB` | +| `BOOLEAN` | `BOOLEAN` | +| `DATE` | `DATE` | +| `TIMESTAMP` | `TIMESTAMPTZ` | +| `TIMESTAMP_NTZ` | `TIMESTAMP` | + + + + +| **Snowflake データ型** | **ScalarDB Analytics データ型** | +| :--------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------- | +| `NUMBER(p,0)` | `BYTE` (p ≤ 2), `SMALLINT` (3–4), `INT` (5–9), `BIGINT` (10–18), `DECIMAL` (p > 18) | +| `NUMBER` / `NUMERIC` | `DECIMAL` | +| `INT` / `INTEGER` / `BIGINT` / `SMALLINT` / `TINYINT` / `BYTEINT` | `DECIMAL` | +| `FLOAT` / `FLOAT4` / `FLOAT8` / `DOUBLE` / `DOUBLE PRECISION` / `REAL` | `DOUBLE` | +| `VARCHAR` / `STRING` / `TEXT` / `NVARCHAR` / `NVARCHAR2` / `CHAR VARYING` / `NCHAR VARYING` / `CHAR` / `CHARACTER` / `NCHAR` | `TEXT` | +| `BINARY` / `VARBINARY` | `BLOB` | +| `BOOLEAN` | `BOOLEAN` | +| `DATE` | `DATE` | +| `TIME` | `TIME` | +| `TIMESTAMP_NTZ` / `DATETIME` | `TIMESTAMP` | +| `TIMESTAMP_LTZ` | `TIMESTAMPTZ` | +| `TIMESTAMP_TZ` | `TIMESTAMPTZ` | | **DynamoDB データ型** | **ScalarDB Analytics データ型** | -| :--------------------- | :------------------------------- | -| `String` | `TEXT` | -| `Number` | `DOUBLE` | -| `Binary` | `BLOB` | -| `Boolean` | `BOOLEAN` | -| `Null` | `NULL` | -| `String Set` | `TEXT` | -| `Number Set` | `TEXT` | -| `Binary Set` | `TEXT` | -| `List` | `TEXT` | -| `Map` | `TEXT` | +| :-------------------- | :------------------------------ | +| `String` | `TEXT` | +| `Number` | `DOUBLE` | +| `Binary` | `BLOB` | +| `Boolean` | `BOOLEAN` | +| `Null` | `NULL` | +| `String Set` | `TEXT` | +| `Number Set` | `TEXT` | +| `Binary Set` | `TEXT` | +| `List` | `TEXT` | +| `Map` | `TEXT` | :::note @@ -696,4 +856,4 @@ DynamoDB の複合データ型(String Set、Number Set、Binary Set、List、M ::: - \ No newline at end of file +