PostgreSQLコネクタリファレンス

備考

プレビュー

LakeFlow ConnectのPostgreSQLコネクタはパブリック プレビュー段階です。 パブリック プレビューに登録するには、Databricks アカウント チームにお問い合わせください。

このページには、 Databricks LakeFlow ConnectのPostgreSQLコネクタに関するリファレンス マテリアルが含まれています。

自動データ変換

Databricks は、次の PostgreSQL データ型を Delta 互換データ型に自動的に変換します。

PostgreSQL型	Delta型
BOOLEAN	BOOLEAN
SMALLINT	SMALLINT
INTEGER	INT
BIGINT	BIGINT
DECIMAL(p,s)	DECIMAL(p,s)
NUMERIC(p,s)	DECIMAL(p,s)
REAL	FLOAT
DOUBLE PRECISION	DOUBLE
SMALLSERIAL	SMALLINT
SERIAL	INT
BIGSERIAL	BIGINT
MONEY	STRING
CHAR(n)	STRING
VARCHAR(n)	STRING
TEXT	STRING
BYTEA	BINARY
DATE	DATE
TIME	STRING
TIME WITH TIME ZONE	STRING
TIMESTAMP	STRING
TIMESTAMP WITH TIME ZONE	TIMESTAMP
INTERVAL	STRING
UUID	BINARY
JSON	STRING
JSONB	STRING
XML	STRING
ARRAY	STRING
CIDR	STRING
INET	STRING
MACADDR	STRING
BIT(n)	BINARY
BIT VARYING(n)	BINARY

日付と時刻の種類に関する重要な注意事項

• DATE データ型はDelta DATE型として取り込まれます。PostgreSQLの日付範囲全体がサポートされています。Infと-Inf値はnullに変換されます。紀元前（BC）の日付は、天文学的な年号を用いて記録されます。例えば、紀元前1年は0年に相当し、紀元前2年は-1年に相当します。
• TIMESTAMP （タイムゾーンなしの）データ型は文字列として取り込まれます。Infと-Inf値は文字列として保持されます。
• TIMESTAMP WITH TIME ZONE データ型はDelta TIMESTAMP型として取り込まれます。PostgreSQLでサポートされている範囲は4713-01-01 00:00:00.000000 BCから294276-12-31 23:59:59.999999 ADですが、Databricksでサポートされている範囲は-290308-12-21 BCE 19:59:06 GMTから+294247-01-10 CE 04:00:54 GMTです。Databricksがサポートする最大タイムスタンプを超えるタイムスタンプはnullに変換されます。紀元前（BC）の日付は、天文学的な年号を用いて記録されます。例えば、紀元前1年は0年に、紀元前2年は-1年にマッピングされます。 Infと-Inf値はnullに変換されます。
• TIME``TIME WITH TIME ZONE 、 INTERVALデータ型は、元の形式の文字列として取り込まれます。必要に応じて、 Databricks SQL関数を使用してこれらの文字列を適切な時間表現に解析できます。 INTERVALデータ型の場合、無限大の値は0 years 0 mins 0 days 0 hours 0 mins 0.0 secsにマッピングされます。

ユーザー定義およびサードパーティのデータ型

ユーザー定義型とサードパーティの PostgreSQL 拡張機能のデータ型は、文字列として取り込まれます。これらの型を変換する必要がある場合は、Databricks SQL 関数を使用して、下流の処理で文字列表現を解析できます。

複合型

PostgreSQL 複合型 (行型とも呼ばれます) は文字列として取り込まれます。文字列表現は、PostgreSQL の複合型形式(value1,value2,value3)に従います。