統合型の転送元と転送先のデータ型へのマッピング

統合型とは、Avro イベントまたは JSON イベントに表示されるデータ型です。これらは、Datastream がサポートする複数のデータソースと宛先でデータ型を統合的に表現したもので、Datastream 固有のものです。

統合型は、サポートされているすべてのソースタイプのすべての型表現のスーパーセットであり、元のソースタイプを汎用的、可逆的に表します。

次の表に、以下の内容を示します。

  • Datastream に関連付けられた統合型
  • Oracle、MySQL、SQL Server、PostgreSQL、Salesforce、Spanner、ServiceNow、MongoDB のデータ型と Datastream の統合型とのマッピング

さまざまなソースと BigQuery のデータ型間のマッピングについては、BigQuery の宛先に関するドキュメントをご覧ください。

Datastream の統合型

型名 情報 Avro の定義 JSON の定義
BOOLEAN ブール値 ブール値 ブール値
BYTES 未署名バイトのシーケンス バイト 文字列
DATE エポックからの日数 日付論理型 文字列 [ISO-8601]
DATETIME 日付（エポックからの日数）と時刻（午前 0 時からのマイクロ秒数）

カスタムタイプ

{
  "type": "record",
  "name": "datetime",
  "fields": [
    {"name": "date",
     "type": "int",
     "logicalType": "date"},
    {"name": "time",
     "type": "long",
     "logicalType": "time-micros"}
  ]
}
文字列 [ISO-8601]
DECIMAL (p,s) 任意の精度の符号付き 10 進数 decimal 論理型 数値
DOUBLE 64 ビット浮動小数点数 double 数値
FLOAT 32 ビット浮動小数点数 float 数値
INTEGER 32 ビット整数。 int 数値
INTERVAL 2 つのイベント間の期間（月、時間、マイクロ秒単位）

カスタムタイプ

{
  "type": "record",
  "name": "interval",
  "fields": [
    {"name": "months",
     "type": "int"}
    {"name": "hours",
     "type": "int"},
    {"name": "micros",
     "type": "long"}
  ]
}
文字列 [ISO-8601]
JSON JSON オブジェクト

カスタム論理型

{
  "type": "string",
  "logicalType": "json"
}
ネストされた JSON
LONG 64 ビット整数。 long 数値
NUMBER 数値データ型

カスタム論理型

{
  "type": "string",
  "logicalType": "number"
}
文字列
STRING 文字列の長さが無制限 文字列 文字列
TIME タイムゾーンに関係なく、午前 0 時からの経過時間（マイクロ秒単位）。 time-micros 論理型 文字列 [ISO-8601]
TIME INTERVAL 2 つのイベント間の経過時間（マイクロ秒単位）

カスタム論理型

{
  "type": "long",
  "logicalType": "time-interval-micros"
}
long
TIMESTAMP タイムゾーンに関係なく、エポックからの経過時間（マイクロ秒単位） タイムスタンプ論理型 文字列 [ISO-8601]
TIMESTAMP WITH TIME ZONE エポックからの経過時間（マイクロ秒単位、特定のタイムゾーン オフセットはミリ秒単位）

カスタムタイプ

{
  "type": "record",
  "name": "timestampTz",
  "fields": [
    {"name": "timestamp",
     "type": "long"
     "logicalType": "timestamp-micros"},
    {"name": "offset",
     "type": "int"
     "logicalType": "time-millis"}
  ]
}
文字列 [ISO-8601]
TIME WITH TIME ZONE 特定のタイムゾーン オフセットで午前 0 時から経過したマイクロ秒数

カスタムタイプ

{
  "type": "record",
  "name": "timeTz",
  "fields": [
    {"name": "time",
     "type": "long"
     "logicalType": "time-micros"},
    {"name": "offset",
     "type": "int",
     "logicalType": "time-millis"}
  ]
}
文字列 [ISO-8601]
UNSUPPORTED サポートされていないデータ型

カスタム論理型

{
  "type": "null",
  "logicalType": "unsupported"
}
null
VARCHAR 最大 n 文字の文字列

カスタム論理型

{
  "type": "string",
  "logicalType": "varchar"
  "length": N
}
文字列

Oracle のデータ型を Datastream の統合型にマッピングする

Oracle のデータ型 Datastream の統合タイプ
ANYDATA UNSUPPORTED
BFILE STRING
BINARY DOUBLE DOUBLE
BINARY FLOAT FLOAT
BLOB BYTES
CHAR VARCHAR
CLOB STRING
DATE DATETIME
DOUBLE PRECISION DOUBLE
FLOAT(p) DOUBLE
INTERVAL DAY TO SECOND UNSUPPORTED
INTERVAL YEAR TO MONTH UNSUPPORTED
LONG/LONG RAW UNSUPPORTED
NCHAR STRING
NCLOB STRING
NUMBER NUMBER
NUMBER(p,s<=0)

p<=18 の場合は LONG。p>18 または p=* の場合、NUMBER。

NUMBER(p,s>0)

p=* の場合、DECIMAL(38,s)。それ以外の場合、DECIMAL(p,s)。
NVARCHAR2 STRING
RAW STRING
ROWID STRING
SDO_GEOMETRY UNSUPPORTED
SMALLINT INTEGER
TIMESTAMP TIMESTAMP
TIMESTAMP WITH TIME ZONE TIMESTAMP WITH TIME ZONE
UDT（ユーザー定義型） UNSUPPORTED
UROWID UNSUPPORTED
VARCHAR VARCHAR
VARCHAR2 VARCHAR
XMLTYPE UNSUPPORTED

MySQL のデータ型を Datastream の統合型にマッピングする

MySQL のデータ型 Datastream の統合タイプ
BIGINT(size) SIGNED LONG
BIGINT(size) UNSIGNED 宛先が BigQuery の場合は DECIMAL、Cloud Storage の場合は NUMBER
BINARY(size) STRING (hex encoded)
BIT(size) LONG
BLOB(size) STRING (hex encoded)
BOOL INTEGER
CHAR(size) STRING
DATE 宛先が BigQuery の場合は DATE、Cloud Storage の場合は TIMESTAMP
DATETIME(fsp) 宛先が BigQuery の場合は DATETIME、Cloud Storage の場合は TIMESTAMP
DECIMAL(size, d) DECIMAL(size, d)
DOUBLE(size, d) DOUBLE
ENUM(val1, val2, val3, ...) STRING
FLOAT(p) FLOAT
FLOAT(size, d) FLOAT
GEOMETRY UNSUPPORTED
INTEGER(size) SIGNED INTEGER
INTEGER(size) UNSIGNED LONG
JSON 宛先が BigQuery の場合は JSON、Cloud Storage の場合は STRING
LONGBLOB STRING (hex encoded)
LONGTEXT STRING
MEDIUMBLOB STRING (hex encoded)
MEDIUMINT(size) INTEGER
MEDIUMTEXT STRING
SET(val1, val2, val3, ...) STRING
SMALLINT(size) INTEGER
TEXT(size) STRING
TIME(fsp) 宛先が BigQuery の場合は INTERVAL、Cloud Storage の場合は TIME_INTERVAL
TIMESTAMP(fsp) TIMESTAMP
TINYBLOB STRING (hex encoded)
TINYINT(size) INTEGER
TINYTEXT STRING
VARBINARY(size) STRING (hex encoded)
VARCHAR STRING
YEAR INTEGER

PostgreSQL のデータ型を Datastream の統合型にマッピングする

PostgreSQL のデータ型 Datastream の統合タイプ
ARRAY JSON
BIGINT LONG
BIT BYTES
BIT VARYING BYTES
BOOLEAN BOOLEAN
BOX UNSUPPORTED
BYTEA BYTES
CHARACTER
  • 長さの制限がある場合は、VARCHAR にマッピングします。
  • それ以外の場合は STRING にマッピングします。
CHARACTER VARYING
  • 長さの制限がある場合は、VARCHAR にマッピングします。
  • それ以外の場合は STRING にマッピングします。
CIDR STRING
CIRCLE UNSUPPORTED
CITEXT STRING
COMPOSITE UNSUPPORTED
DATE DATE
DOUBLE PRECISION DOUBLE
ENUM STRING
INET STRING
INTEGER INTEGER
INTERVAL INTERVAL
JSON JSON
JSONB JSON
LINE UNSUPPORTED
LSEG UNSUPPORTED
MACADDR STRING
MONEY DOUBLE
NUMERIC
  • 精度 = -1、スケール = -1 の場合、NUMBER にマッピング
  • それ以外の場合は DECIMAL にマッピングします。
OID LONG
PATH UNSUPPORTED
POINT UNSUPPORTED
POLYGON UNSUPPORTED
REAL FLOAT
SMALLINT INTEGER
SMALLSERIAL INTEGER
SERIAL INTEGER
TEXT STRING
TIME TIME
TIMESTAMP TIMESTAMP
TIMESTAMP WITH TIME ZONE TIMESTAMP WITH TIME ZONE
TIME WITH TIME ZONE TIME WITH TIME ZONE
TSQUERY STRING
TSVECTOR STRING
TXID SNAPSHOT STRING
UUID STRING
XID STRING
XID8 STRING
XML STRING

SQL Server のデータ型を Datastream の統合型にマッピングする

SQL Server のデータ型 Datastream の統合タイプ
BIGINT LONG
BINARY BYTES
BIT BOOLEAN
CHAR STRING
DATE DATE
DATETIME2 DATETIME
DATETIME DATETIME
DATETIMEOFFSET TIMESTAMP WITH TIME ZONE
DECIMAL DECIMAL (p, s)
FLOAT DOUBLE
INT INTEGER
IMAGE BYTES
MONEY DECIMAL
NCHAR STRING
NVARCHAR STRING
NVARCHAR(MAX) STRING
NTEXT STRING
NUMERIC DECIMAL (p, s)
REAL FLOAT
SMALLDATETIME DATETIME
SMALLINT INTEGER
SMALLMONEY DECIMAL
TEXT STRING
TINYINT INTEGER
TIME TIME
TIMESTAMP/ROWVERSION BYTES
UNIQUEIDENTIFIER STRING
VARCHAR STRING
VARCHAR(MAX) STRING
VARBINARY BYTES
VARBINARY(MAX) BYTES
XML STRING

Salesforce のデータ型を Datastream の統合型にマッピングする

Salesforce がサポートするデータ型には、次の 2 種類があります。

プリミティブ データ型のマッピング

Salesforce のデータ型 Datastream の統合タイプ
BOOLEAN BOOLEAN
BYTE BYTES
DATE 宛先が BigQuery の場合は DATE、Cloud Storage の場合は TIMESTAMP
DATETIME 宛先が BigQuery の場合は DATETIME、Cloud Storage の場合は TIMESTAMP
DOUBLE DOUBLE
INT INTEGER
STRING STRING
TIME TIME

フィールドのデータ型マッピング

Salesforce のデータ型 Datastream の統合タイプ
ADDRESS この複合フィールドのサブフィールドは、それぞれのデータ型で複製されます。
ANYTYPE

（STRING、DATE、NUMBER、BOOLEAN のいずれか）

 STRING
COMBOBOX STRING
CURRENCY DOUBLE
DATACATEGORYGROUPREFERENCE STRING
EMAIL STRING
ENCRYPTEDSTRING STRING
GEOLOCATION この複合フィールドのサブフィールドは、それぞれのデータ型で複製されます。
ID STRING
JUNCTIONIDLIST STRING
MASTERRECORD STRING
MULTIPICKLIST STRING
PERCENT DOUBLE
PHONE STRING
PICKLIST STRING
REFERENCE STRING
TEXTAREA STRING
URL STRING

Spanner（GoogleSQL）のデータ型を Datastream の統合型にマッピングする

Spanner のデータ型 統合データ型
ARRAY ARRAY
BOOL BOOLEAN
BYTES BYTES
DATE DATE
FLOAT32 FLOAT
FLOAT64 DOUBLE
INT64 LONG
JSON JSON
NUMERIC NUMBER
STRING STRING
TIMESTAMP TIMESTAMP WITH TIME ZONE
UUID STRING
PROTO UNSUPPORTED
ENUM UNSUPPORTED

Spanner（PostgreSQL）のデータ型を Datastream の統合型にマッピングする

Spanner のデータ型 統合データ型
ARRAY ARRAY
BIGINT LONG
BOOL BOOLEAN
BYTEA BYTES
CHARACTER VARYING STRING
DATE DATE
DECIMAL NUMBER
DOUBLE PRECISION DOUBLE
FLOAT8 DOUBLE
INT8 LONG
JSONB JSON
NUMERIC NUMBER
TEXT STRING
TIMESTAMP WITH TIME ZONE TIMESTAMP WITH TIME ZONE
TIMESTAMPTZ TIMESTAMP WITH TIME ZONE
VARCHAR STRING
UUID STRING

ServiceNow のデータ型を Datastream の統合型にマッピングする

ServiceNow データ型 Datastream の統合タイプ
action_conditions STRING
approval_rules STRING
audio STRING
auto_increment LONG
auto_number STRING
boolean BOOLEAN
bootstrap_color STRING
breakdown_element STRING
calendar_date_time DATETIME
catalog_preview STRING
char STRING
choice STRING
collection STRING
color STRING
color_display STRING
composite_field STRING
composite_name STRING
compressed STRING
conditions STRING
condition_string STRING
counter STRING
css STRING
currency DOUBLE
currency2 JSON
data_array STRING
data_object JSON
data_structure JSON
date STRING
datetime DATETIME
days_of_week STRING
day_of_week INTEGER
decimal DOUBLE
documentation_field STRING
document_id JSON
domain_id JSON
domain_path STRING
due_date DATETIME
dynamic_attribute_store STRING
email STRING
email_script STRING
expression STRING
external_names STRING
field_list STRING
field_name STRING
file_attachment STRING
float DOUBLE
formula STRING
geo_point STRING
glide_action_list STRING
glide_date DATE
glide_date_time DATETIME
glide_duration TIME INTERVAL
glide_encrypted STRING
glide_list STRING
glide_precise_time DATETIME
glide_time DATETIME
glide_utc_time TIME
glide_var STRING
glyphicon STRING
graphql_schema STRING
guid STRING
hash STRING
html STRING
html_script STRING
html_template STRING
icon STRING
image STRING
index_name STRING
insert_timestamp DATETIME
int INTEGER
integer INTEGER
integer_date DATE
integer_time TIME
internal_type STRING
ip_addr STRING
ip_address STRING
journal STRING
journal_input STRING
journal_list STRING
json JSON
json_translations JSON
language STRING
le_progress STRING
long LONG
longint LONG
mask_code STRING
metric_absolute DOUBLE
metric_counter DOUBLE
metric_derive DOUBLE
metric_gauge DOUBLE
mid_config STRING
month_of_year INTEGER
multi_small STRING
multi_two_lines STRING
name_values JSON
nds_icon STRING
nl_task_int1 INTEGER
order_index INTEGER
password STRING
password2 STRING
percent_complete DOUBLE
phone_number STRING
phone_number_e164 STRING
ph_number STRING
price DOUBLE
properties STRING
radio STRING
records STRING
record_hierarchy_path STRING
reference JSON
reference_name STRING
related_tags STRING
reminder_field_name STRING
repeat_count INTEGER
repeat_type STRING
replication_payload STRING
schedule_date_time TIMESTAMP WITH TIME ZONE
schedule_interval_count INTEGER
script STRING
script_client STRING
script_plain STRING
script_server STRING
short_field_name STRING
short_table_name STRING
simple_name_values JSON
slushbucket STRING
snapshot_template_value STRING
source_id JSON
source_name STRING
source_table STRING
string STRING
string_boolean STRING
string_full_utf8 STRING
structure STRING
sysevent_name STRING
sysrule_field_name STRING
sys_class_name STRING
sys_class_path STRING
table_name STRING
template_value STRING
timer TIME INTERVAL
time TIME
translated STRING
translated_field STRING
translated_html STRING
translated_text STRING
tree_code STRING
tree_path STRING
url STRING
user_image STRING
user_input STRING
user_roles STRING
variables STRING
variable_conditions STRING
variable_template_value STRING
version STRING
video STRING
week_of_month INTEGER
wide_text STRING
wiki_text STRING
wms_job STRING
workflow STRING
workflow_conditions STRING
xml STRING

MongoDB のデータ型

各 MongoDB ドキュメントは、Datastream の JSON 統一型として書き込まれます。BigQuery でデータ型を書き込む方法の例については、BigQuery の宛先を構成するをご覧ください。

Microsoft Dataverse のデータ型

各 Microsoft Dataverse レコードは、Datastream の JSON 統一型として書き込まれます。

Salesforce Marketing Cloud のデータ型

各 Salesforce Marketing Cloud レコードは、Datastream で JSON 統合型として書き込まれます。

次のステップ