6.2.1　データ型の種類

(1)　数データ

数データについて説明します。

ページの先頭へ

(2)　文字データ

■CHARACTER

• 固定長文字列を扱うデータ型です。

• データ型を指定する際の記述形式を次に示します。

  CHAR，CHAR(n)，CHARACTER，またはCHARACTER(n)

• 文字列の長さ（バイト数）をnで指定します。nは1〜32,000の整数で，nを省略すると1が仮定されます。

• 定数は，'char'，'Ｃｈａｒ'，'charＣｈａｒ'という形式で記述します。定数については，「6.3　定数」を参照してください。

• 半角文字，全角文字の両方を扱うことができます。

• 文字データの比較を行う場合，文字コードの大小が比較するデータの大小となります。

■VARCHAR，STRING

• 可変長文字列を扱うデータ型です。

• データ型を指定する際の記述形式を次に示します。

  • VARCHAR型の場合

    VARCHAR(n)

  • STRING型の場合

    STRING

  重要

  • STRING型の列は外部表にだけ定義できます。実表にはSTRING型の列を定義できません。

  • データ型にSTRING型が指定された場合，HADBはデータ型にVARCHAR(32000000)が指定されたと見なします。

• 文字列の最大長（バイト数）をnで指定します。nは1〜64,000の整数でなければなりません。nは省略できません。

• VARCHAR型のデータ形式を次の図に示します。

  図6‒6　VARCHAR型のデータ形式

  文字データの長さ（L）を4バイトで表します。

• 半角文字，全角文字の両方を扱うことができます。また，文字列の長さが0バイトのデータを扱うこともできます。

• 文字データの比較を行う場合，文字コードの大小が比較するデータの大小となります。

• 次に示す個所に，データ長が32,000バイトを超えるVARCHAR型は指定できません。

  • ALTER TABLE文の列定義に指定するデータ型

  • CREATE FOREIGN TABLE文の列定義に指定するデータ型

  • CREATE TABLE文の列定義に指定するデータ型

  • 表関数列リストに指定するデータ型

  • スカラ関数CASTに指定する変換後のデータ型

  • スカラ関数CONVERTに指定する変換後のデータ型

• 次に示す個所にSTRING型は指定できません。

  • ALTER TABLE文の列定義に指定するデータ型

  • CREATE TABLE文の列定義に指定するデータ型

  • 表関数列リストに指定するデータ型

ページの先頭へ

(3)　日時データ

■DATE

• 年，月，日の情報を持つ日付のデータ型です。

• データ型を指定する際の記述形式を次に示します。

  DATE

• 値の範囲が，0001年1月1日〜9999年12月31日の日付を扱います。

• データ長は4バイトになります。入力するデータ長は，この長さである必要があります。

• DATE型のデータ形式を次の図に示します。

  図6‒7　DATE型のデータ形式

• 定数は，DATE'2012-03-30'またはDATE'2012/03/30'という形式で記述します。定数については，「6.3　定数」を参照してください。

■TIME

• 時，分，秒の情報を持つ時刻のデータ型です。

• データ型を指定する際の記述形式を次に示します。

  TIME(p)，またはTIME

  小数秒精度（小数秒の桁数）をpで指定します。pに指定できる値は，0，3，6，9，または12です。

  TIMEと指定した場合は，pに0が仮定されます。

• 値の範囲が，0時0分0.000000000000秒〜23時59分59.999999999999秒の時刻を扱います。

• データ長は，3＋↑p÷2↑バイトになります。入力するデータ長は，この長さである必要があります。

• TIME型のデータ形式を次の図に示します。

  図6‒8　TIME型のデータ形式

  4ビットで1桁を表します。小数秒精度が奇数の場合は，末尾の4ビットに0が格納されます。

• 定数は，TIME'11:03:58.123456'という形式で記述します。定数については，「6.3　定数」を参照してください。

■TIMESTAMP（TIMESTAMP WITHOUT TIME ZONE，TIMESTAMP WITH TIME ZONE）

• 年，月，日，時，分，秒の情報を持つ時刻印のデータ型です。

• TIMESTAMP型には，次の2つのデータ型があります。

  • TIMESTAMP WITHOUT TIME ZONE（時刻帯なしの時刻印データ）

  • TIMESTAMP WITH TIME ZONE（時刻帯付きの時刻印データ）

• データ型を指定する際の記述形式を次に示します。

  • TIMESTAMP WITHOUT TIME ZONEの場合

    次のどちらかの形式で指定します。

    TIMESTAMP(p)
    TIMESTAMP

  • TIMESTAMP WITH TIME ZONEの場合

    次のどちらかの形式で指定します。

    TIMESTAMP(p) WITH TIME ZONE
    TIMESTAMP WITH TIME ZONE

    TIMESTAMP WITH TIME ZONE（時刻帯付きの時刻印データ）に入力された値は，協定世界時（UTC）に変換され，時刻帯がUTC（+00:00）のデータとして扱われます。

    （例）2025-10-21 15:00+09:00の値は，2025-10-21 06:00+00:00に変換されます。

  小数秒精度（小数秒の桁数）をpで指定します。pに指定できる値は，0，3，6，9，または12です。

  (p)の指定を省略した場合は，pに0が仮定されます。

• 値の範囲が，0001年1月1日0時0分0.000000000000秒〜9999年12月31日23時59分59.999999999999秒の時刻印を扱います。

• データ長は，7＋↑p÷2↑バイトになります。入力するデータ長は，この長さである必要があります。

• TIMESTAMP型のデータ形式を次の図に示します。

  図6‒9　TIMESTAMP型のデータ形式

  4ビットで1桁を表します。小数秒精度が奇数の場合は，末尾の4ビットに0が格納されます。

  メモ

  TIMESTAMP WITH TIME ZONE（時刻帯付きの時刻印データ）は，TIMESTAMP WITHOUT TIME ZONE（時刻帯なしの時刻印データ）に変換されるため（UTCに変換されるため），時刻帯付きの時刻印データも時刻帯なしの時刻印データも同じデータ形式になります。

• 定数は次のような形式で記述します。定数については，「6.3　定数」を参照してください。

  • TIMESTAMP WITHOUT TIME ZONEの場合

    TIMESTAMP'2025-07-30 11:03:58'

  • TIMESTAMP WITH TIME ZONEの場合

    TIMESTAMP'2025-07-30 11:03:58+09:00'
    TIMESTAMP'2025-07-30 11:03:58Z'

ページの先頭へ

(4)　バイナリデータ

■BINARY

• 固定長バイナリデータを扱うデータ型です。

• データ型を指定する際の記述形式を次に示します。

  BINARY(n)，またはBINARY

• バイナリデータの長さ（バイト数）をnで指定します。nは1〜32,000の整数で，nを省略すると1が仮定されます。

• 定数は，X'0A38ef92'という形式で記述します。定数については，「6.3　定数」を参照してください。

• BINARY型のデータ形式を次の図に示します。

  図6‒10　BINARY型のデータ形式

■VARBINARY

• 可変長バイナリデータを扱うデータ型です。

• データ型を指定する際の記述形式を次に示します。

  VARBINARY(n)

• バイナリデータの最大長（バイト数）をnで指定します。nは1〜32,000の整数でなければなりません。nは省略できません。

• 定数は，X'0A38ef92'という形式で記述します。定数については，「6.3　定数」を参照してください。

• バイナリデータの長さが0バイトのデータを扱うこともできます。

• VARBINARY型のデータ形式を次の図に示します。

  図6‒11　VARBINARY型のデータ形式

  バイナリデータの長さ（L）を2バイトで表します。

ページの先頭へ

(5)　論理データ

■BOOLEAN

• 真，偽，または不定のどれかを取る論理値を表すデータ型です。

• 論理データの不定はナル値と見なされます。

• データ型を指定する際の記述形式を次に示します。

  BOOLEAN

• データ長は1バイトです。真の場合は'T'(0x54)，偽の場合は'F'(0x46)として扱います。

• 定数は，TRUEまたはFALSEと記述します。定数については，「6.3　定数」を参照してください。

ページの先頭へ

(6)　UUIDデータ

■UUID

• UUIDを表すデータ型です。

• データ型を指定する際の記述形式を次に示します。

  UUID

• データは，16バイトの固定長バイナリデータです。

• 定数は，UUID'd68fab5b-f44c-42ae-8b8d-8da66ab31042'という形式で記述します。定数については，「6.3　定数」を参照してください。

• UUID型のデータ形式を次の図に示します。

  図6‒12　UUID型のデータ形式

  ［説明］

  4ビットで1桁を表します。

  AAAAAAAA-BBBB-CCCC-DDDD-EEEEEEEEEEEEのUUIDデータの場合，次の値が格納されます。

  A：0x0～0x9，0xA～0xF

  B：0x0～0x9，0xA～0xF

  C：0x0～0x9，0xA～0xF

  D：0x0～0x9，0xA～0xF

  E：0x0～0x9，0xA～0xF

• HADBで扱うUUIDのバージョンは，UUIDデータを生成したアプリケーションやシステムに依存します。HADBは，UUIDのバージョンを意識した処理は行いません。

ページの先頭へ

(7)　配列データ

■ARRAY（配列型）

• 配列型は，順序付けられた一連のデータを要素とする一次元の配列データを扱うデータ型です。

• データ型を指定する際の記述形式を次に示します。

  要素データ型 ARRAY[最大要素数]

  要素データ型：

  配列要素のデータ型を指定します。

  要素データ型には，数データ，文字データ，日時データ，バイナリデータ，論理データ，UUIDデータ，または構造データのどれかのデータ型を指定してください。要素データ型の記述形式は，各データ型の記述形式の規則に従います。

  重要

  要素データ型に構造データを指定できるのは，CREATE FOREIGN TABLE文の列定義だけです。

  最大要素数：

  配列要素の最大数を指定します。

  最大要素数には，2～30,000の符号なし整数定数を指定してください。

  ＜指定例＞

  • 要素データ型がCHAR(5)で，最大要素数が20の場合

    CHAR(5) ARRAY[20]

  • 要素データ型がINTEGERで，最大要素数が5の場合

    INTEGER ARRAY[5]

• 配列データの各要素を，配列要素といいます。各配列要素には，要素番号が割り当てられます。先頭の配列要素の要素番号を1とし，順に2，3，…となる符号なし整数定数の要素番号が各配列要素に割り当てられます。

• 配列要素数が0の配列データを，空の配列データといいます。

• 配列型の列を定義する際の考慮点については，マニュアルHADB　システム構築・運用ガイドの配列型の列の定義【カラムストア表】を参照してください。

• 要素データ型に構造データを入れ子にして指定する場合，構造データと配列データの繰り返しは8回までできます。

  （例）要素データ型に構造データを8回入れ子にして指定する場合

  STRUCT 
    {"A1" INT, 
     "A2" STRUCT 
          {"B1" INT,
           "B2" STRUCT 
                {"C1" INT,
                 "C2" STRUCT 
                      {"D1" INT,
                       "D2" INT ARRAY[2]
                      } ARRAY[3]
                } ARRAY[4]
          } ARRAY[5]
    } ARRAY[6]

ページの先頭へ

(8)　構造データ

■STRUCT

• 構造データは，複数のデータ型から構成されるデータを扱うデータ型です。

  重要

  STRUCT型の列は外部表にだけ定義できます。実表にはSTRUCT型の列を定義できません。

• データ型を指定する際の記述形式を次に示します。

  STRUCT {フィールド名 フィールドデータ型〔,フィールド名 フィールドデータ型〕…}

  フィールド名

  構造データのフィールドの名称を指定します。フィールド名の指定規則については，「6.1.4　名前の指定」の「(2)　名前に使用できる文字の規則」を参照してください。

  フィールドデータ型

  構造データのフィールドのデータ型を指定します。フィールドデータ型には，数データ，文字データ，日時データ，バイナリデータ，論理データ，UUIDデータ，配列データ，または構造データのどれかのデータ型を指定できます。

  メモ

  フィールド名とフィールドデータ型の組み合わせをフィールドといいます。

  ＜指定例＞

  • 次のフィールド名とフィールドデータ型から構成されるSTRUCT型の場合

    • A1：INTEGER

    • A2：CHAR(5)

    • A3：DATE

    STRUCT {"A1" INTEGER,"A2" CHAR(5),"A3" DATE}

  • 次のフィールド名とフィールドデータ型から構成されるSTRUCT型の場合

    • B1：INTEGER

    • B2：CHAR(5)

    • B3：STRUCT

      A1：INTEGER

      A2：CHAR(5)

      A3：DATE

    STRUCT {"B1" INTEGER,
            "B2" CHAR(5),
            "B3" STRUCT {"A1" INTEGER,"A2" CHAR(5),"A3" DATE}}

• フィールド数は最大1,000個となります。構造データ中に構造データを定義した場合，全構造データのフィールド数の合計が最大1,000個となります。

• フィールド名は重複できません。ただし，構造データ中に構造データを定義した場合，構造データとその入れ子の構造データで同じフィールド名を指定できます。

• フィールドデータ型に構造データまたは配列データを入れ子にして指定する場合，構造データと配列データの繰り返しは8回までできます。フィールドデータ型に，構造データまたは配列データを8回入れ子にして指定する場合の例を次に示します。

  （例1）

  STRUCT {"A1" INT, "B1" 
    STRUCT {"A2" INT, "B2"
      STRUCT {"A3" INT, "B3"
        STRUCT {"A4" INT, "B4"
          STRUCT {"A5" INT, "B5"
            STRUCT {"A6" INT, "B6"
              STRUCT {"A7" INT, "B7"
                STRUCT {"A8" INT, "B8"
                  STRUCT {"A9" INT, "B9" INT}}}}}}}}}

  （例2）

  STRUCT {"A1" INT, "B1" 
    STRUCT {"A2" INT, "B2"
      STRUCT {"A3" INT, "B3"
        STRUCT {"A4" INT, "B4"
          STRUCT {"A5" INT, "B5"
            STRUCT {"A6" INT, "B6"
              STRUCT {"A7" INT, "B7"
                STRUCT {"A8" INT, "B8" INT} ARRAY[9]}}}}}}}

ページの先頭へ