GridDB Advanced Edition SQLリファレンス

テーブルを作成します。

構文

-- テーブル(コレクション)
CREATE TABLE [IF NOT EXISTS] テーブル名 ( 列定義 [, 列定義 ...] );

-- 時系列テーブル(時系列コンテナ)
CREATE TABLE [IF NOT EXISTS] テーブル名 ( 列名 TIMESTAMP PRIMARY KEY [, 列定義 ...] )
USING TIMESERIES [WITH (プロパティキー=プロパティ値 [, プロパティキー=プロパティ値 ...])];

列定義

• 列名 型名 [ 列制約 ]

列制約

• PRIMARY KEY (先頭の列のみ指定可)
• NULL
• NOT NULL

仕様

• テーブル名、列名の規則はネーミングの規則を参照ください。
• “IF NOT EXISTS”が指定された場合、指定したテーブル名と同じ名前のテーブルが存在しないときのみ作成します。
• 列定義 では、列名と型名の指定が必須です。指定可能な型名はデータ格納に使用する型を参照ください。
• 時系列テーブル（時系列コンテナ）については『GridDB テクニカルリファレンス』(GridDB_TechnicalReference.html)を参照ください。
• 時系列テーブルの場合、期限解放に関するオプションを" WITH (プロパティキー=プロパティ値, ...)"の形式で指定することができます。

  機能	内容	プロパティキー	プロパティ値の型
  期限解放機能	種別	expiration_type	STRING型
  			(指定可能な値は次の1種類。
  			ROW: ロウ期限解放)
  	経過時間	expiration_time	INTEGER型
  	経過単位	expiration_time_unit	STRING型
  			(指定可能な値は次の5種類。
  			DAY / HOUR / MINUTE / SECOND / MILLISECOND )
  	分割数	expiration_division_count	INTEGER型

  • 各項目の内容については『GridDB テクニカルリファレンス』(GridDB_TechnicalReference.html)を参照ください。

例

• テーブルの作成

  CREATE TABLE IF NOT EXISTS myTable (
    key INTEGER PRIMARY KEY,
    value1 DOUBLE NOT NULL,
    value2 DOUBLE NOT NULL
  );
  

• ロウ期限解放を使用する時系列テーブルの作成

  CREATE TABLE IF NOT EXISTS myTimeseries (
    mycolumn1 TIMESTAMP PRIMARY KEY,
    mycolumn2 STRING
  ) USING TIMESERIES WITH (
    expiration_type='ROW',
    expiration_time=10,
    expiration_time_unit='DAY'
  );
  

パーティションテーブルを作成します。

各パーティショニングの機能については、『GridDB テクニカルリファレンス』(GridDB_TechnicalReference.html)を参照ください。

(1) ハッシュパーティションテーブルの作成

構文

-- テーブル(コレクション)
CREATE TABLE [IF NOT EXISTS] テーブル名 ( 列定義 [, 列定義 ...] )
PARTITION BY HASH (パーティショニングキーの列名) PARTITIONS 分割数;

-- 時系列テーブル(時系列コンテナ)
CREATE TABLE [IF NOT EXISTS] テーブル名 ( 列定義 [, 列定義 ...] )
USING TIMESERIES [WITH (プロパティキー=プロパティ値, ...)]]
PARTITION BY HASH (パーティショニングキーの列名) PARTITIONS 分割数;

仕様

• 指定されたパーティショニングキーの列名と分割数の値により、ハッシュパーティションテーブルを作成します。
• 「分割数」は、1以上かつ1024以下の値を指定してください。
• パーティショニングキーに指定した列の値は、更新できません。
• 時系列テーブルの場合、期限解放に関するオプションを" WITH (プロパティキー=プロパティ値, ...)"の形式で指定することができます。指定可能なオプションは通常のテーブルと同様です。

例

• ハッシュパーティションテーブルの作成

  CREATE TABLE IF NOT EXISTS myHashPartition (
    id INTEGER PRIMARY KEY,
    value STRING
  ) PARTITION BY HASH (id) PARTITIONS 128;
  

(2) インターバルパーティションテーブルの作成

構文

-- テーブル(コレクション)
CREATE TABLE [IF NOT EXISTS] テーブル名 ( 列定義 [, 列定義 ...] )
[WITH (プロパティキー=プロパティ値, ...)]
PARTITION BY RANGE(パーティショニングキーの列名) EVERY(分割幅値 [, 単位 ]);

-- 時系列テーブル(時系列コンテナ)
CREATE TABLE [IF NOT EXISTS] テーブル名 ( 列定義 [, 列定義 ...] )
USING TIMESERIES [WITH (プロパティキー=プロパティ値, ...)]
PARTITION BY RANGE(パーティショニングキーの列名) EVERY(分割幅値 [, 単位 ]);

仕様

• 「パーティショニングキーの列名」には、BYTE型、SHORT型、INTEGER型、LONG型、TIMESTAMP型のいずれかの列を指定してください。
• 「パーティショニングキーの列名」に指定する列は、"PRIMARY KEY"または"NOT NULL"制約を指定する必要があります。
• パーティショニングキーに指定した列の値は、更新できません。
• 分割幅値には次の値が指定できます。

  パーティショニングキーの型	分割幅値に指定できる値
  BYTE型	1～127
  SHORT型	1～32767
  INTEGER型	1～2147483647
  LONG型	1000～9223372036854775807
  TIMESTAMP型	1以上

  • TIMESTAMP型の列を指定した場合は、単位を指定する必要があります。単位に指定できる値は、DAYです。
  • TIMESTAMP型以外の列を指定した場合は、単位は指定できません。
• 期限解放に関するオプションを" WITH (プロパティキー=プロパティ値, ...)"の形式で指定することができます。

  機能	内容	プロパティキー	プロパティ値の型
  期限解放機能	種別	expiration_type	STRING型
  			(指定可能な値は次の2種類。指定省略時はPARTITION。
  			PARTITION: パーティション期限解放
  			ROW: ロウ期限解放)
  	経過時間	expiration_time	INTEGER型
  	経過単位	expiration_time_unit	STRING型
  			(指定可能な値は次の5種類。
  			DAY / HOUR / MINUTE / SECOND / MILLISECOND )
  	分割数	expiration_division_count	INTEGER型
  			(ロウ期限解放の場合のみ指定)

  • ロウ期限解放は時系列テーブル(時系列コンテナ)の場合に指定できます。
  • パーティション期限解放は次の場合に指定できます。
    • 時系列テーブル(時系列コンテナ)
    • パーティショニングキーがTIMESTAMP型のテーブル(コレクション)
  • 各項目の内容については『GridDB テクニカルリファレンス』(GridDB_TechnicalReference.html)を参照ください。

例

• インターバルパーティションテーブルの作成

  CREATE TABLE IF NOT EXISTS myIntervalPartition (
    date TIMESTAMP PRIMARY KEY,
    value STRING
  ) PARTITION BY RANGE (date) EVERY (30, DAY);
  

• パーティション期限解放を使用するインターバルパーティションテーブル(時系列テーブル)の作成

  CREATE TABLE IF NOT EXISTS myIntervalPartition2 (
    date TIMESTAMP PRIMARY KEY,
    value STRING
  ) USING TIMESERIES WITH (
    expiration_type='PARTITION',
    expiration_time=90,
    expiration_time_unit='DAY'
  ) PARTITION BY RANGE (date) EVERY (30, DAY);
  

(3) インターバル-ハッシュパーティションテーブルの作成

構文

-- テーブル(コレクション)
CREATE TABLE [IF NOT EXISTS] テーブル名 ( 列定義 [, 列定義 ...] )
[WITH (プロパティキー=プロパティ値, ...) ]
PARTITION BY RANGE(インターバルパーティショニングキーの列名) EVERY(分割幅値 [, 単位 ])
SUBPARTITION BY HASH(ハッシュパーティショニングキーの列名) SUBPARTITIONS 分割数;

-- 時系列テーブル(時系列コンテナ)
CREATE TABLE [IF NOT EXISTS] テーブル名 ( 列定義 [, 列定義 ...] )
USING TIMESERIES [WITH (プロパティキー=プロパティ値, ...)]
PARTITION BY RANGE(インターバルパーティショニングキーの列名) EVERY(分割幅値 [, 単位 ])
SUBPARTITION BY HASH(ハッシュパーティショニングキーの列名) SUBPARTITIONS 分割数;

仕様

• 「インターバルパーティショニングキーの列名」には、BYTE型、SHORT型、INTEGER型、LONG型、TIMESTAMP型のいずれかの列を指定してください。
• 「インターバルパーティショニングキーの列名」に指定する列には、"PRIMARY KEY"または"NOT NULL"制約を指定する必要があります。
• インターバルパーティショニングの分割幅値には次の値が指定できます。

  パーティショニングキーの型	分割幅値に指定できる値
  BYTE型	1～127
  SHORT型	1～32767
  INTEGER型	1～2147483647
  LONG型	1000×ハッシュの分割数～9223372036854775807
  TIMESTAMP型	1以上

  • TIMESTAMP型の列を指定した場合は、単位を指定する必要があります。単位に指定できる値は、DAYです。
  • TIMESTAMP型以外の列を指定した場合は、単位は指定できません。
• ハッシュパーティショニングの「分割数」は、1以上かつ1024以下の値を指定してください。
• パーティショニングキーに指定した列の値は、更新できません。
• 期限解放に関するオプションを" WITH (プロパティキー=プロパティ値, ...)"の形式で指定することができます。指定可能なオプションはインターバルパーティションテーブルと同様です。

例

• インターバルハッシュパーティションテーブルの作成

  CREATE TABLE IF NOT EXISTS myIntervalHashPartition (
    date TIMESTAMP PRIMARY KEY,
    value STRING
  ) PARTITION BY RANGE (date) EVERY (60, DAY)
  SUBPARTITION BY HASH (value) SUBPARTITIONS 64;
  

• パーティション期限解放を使用するインターバルハッシュパーティションテーブル(時系列テーブル)の作成

  CREATE TABLE IF NOT EXISTS myIntervalHashPartition2 (
    date TIMESTAMP PRIMARY KEY,
    value STRING
  ) USING TIMESERIES WITH (
    expiration_type='PARTITION',
    expiration_time=90,
    expiration_time_unit='DAY'
  ) PARTITION BY RANGE (date) EVERY (60, DAY)
  SUBPARTITION BY HASH (value) SUBPARTITIONS 64;
  

テーブルの末尾にカラムを追加します。

構文

ALTER TABLE テーブル名 ADD [COLUMN] 列定義 [,ADD [COLUMN] 列定義 ...];

列定義

• 列名 型名 [ 列制約 ]

列制約

• NULL
• NOT NULL

仕様

• 追加するカラムは、テーブルの末尾に配置します。複数のカラムを指定した場合は指定した順序で配置します。
• 列制約に"PRIMARY KEY"は指定できません。
• 既に同じ名前のカラムが存在した場合はエラーになります。

例

• 複数のカラムの追加

  ALTER TABLE myTable1
    ADD COLUMN col111 STRING NOT NULL,
    ADD COLUMN col112 INTEGER;
  

テーブルパーティショニングで作成されたデータパーティションを削除します。

構文

ALTER TABLE テーブル名 DROP PARTITION FOR ( 削除するデータパーティションの区間(下限値から上限値)に含まれる値 );

仕様

• インターバルとインターバル-ハッシュパーティショニングの場合のみ、データパーティションを削除できます。
• 削除するデータパーティションの区間(下限値から上限値)に含まれる値を指定してください。
• 一度削除したデータパーティションの区間(下限値から上限値)に該当するデータの新規登録はできません。
• データパーティションの下限値は、メタテーブルで確認できます。上限値は、下限値＋分割幅値の値です。
• インターバル-ハッシュパーティショニングの場合は、同じ下限値のデータパーティションが、ハッシュの分割数分(最大)存在します。データパーティションを削除する場合は、それらの同じ下限値をもつデータパーティションは同時に削除されます。削除の確認はメタテーブルで行います。

メタテーブルの詳細はメタテーブルを参照ください。

例

インターバルパーティショニングテーブル

• インターバルパーティショニングのテーブル「myIntervalPartition1」(パーティショニングキーの型：TIMESTAMP、分割幅値30DAY)のデータパーティションの下限値一覧を確認する

  SELECT PARTITION_BOUNDARY_VALUE FROM "#table_partitions"
  WHERE TABLE_NAME='myIntervalPartition1' ORDER BY PARTITION_BOUNDARY_VALUE;
  
  PARTITION_BOUNDARY_VALUE
  -----------------------------------
   2017-01-10T13:00:00Z
   2017-02-09T13:00:00Z
   2017-03-11T13:00:00Z
         :
  

• 不要なデータパーティションを削除する

  ALTER TABLE myIntervalPartition1 DROP PARTITION FOR ('2017-01-10T13:00:00Z');
  

インターバルハッシュパーティショニングテーブル

• インターバルハッシュパーティショニングのテーブル「myIntervalHashPartition」(インターバルパーティショニングキーの型：TIMESTAMP、分割幅値90DAY、ハッシュパーティショニングキーの分割数3)のデータパーティションの下限値一覧を確認する

  SELECT PARTITION_BOUNDARY_VALUE FROM "#table_partitions"
  WHERE TABLE_NAME='myIntervalHashPartition' ORDER BY PARTITION_BOUNDARY_VALUE;
  
  PARTITION_BOUNDARY_VALUE 
  -----------------------------------
  2016-08-01T10:00:00Z    同じ下限値のデータがハッシュされて3つの
  2016-08-01T10:00:00Z    データパーティションに分割されている
  2016-08-01T10:00:00Z
  2016-10-30T10:00:00Z
  2016-10-30T10:00:00Z
  2016-10-30T10:00:00Z
  2017-01-29T10:00:00Z
         :
  

• 不要なデータパーティションを削除する

  ALTER TABLE myIntervalHashPartition DROP PARTITION FOR ('2016-09-15T10:00:00Z');
  

• 同じ下限値のデータパーティションが削除される

  SELECT PARTITION_BOUNDARY_VALUE FROM "#table_partitions"
  WHERE TABLE_NAME='myIntervalHashPartition' ORDER BY PARTITION_BOUNDARY_VALUE;
  
  PARTITION_BOUNDARY_VALUE 
  -----------------------------------
  2016-10-30T10:00:00Z    '2016-09-15T10:00:00Z'を含む区間(下限値'2016-08-01T10:00:00Z')の
  2016-10-30T10:00:00Z    3つのデータパーティションが削除される
  2016-10-30T10:00:00Z
  2017-01-29T10:00:00Z
         :
  

並列化処理の制御を行います。

• MaxDegreeOfParallelism(並列数上限)
  • あるノードでSQLを処理する場合の、1クエリあたりの最大並列スレッド数を指定します。
• MaxDegreeOfTaskInput(上限数)
  • 1タスクへの入力の上限数を指定します。以下の処理に適用されます。
    • テーブルパーティショニングの設定されたテーブルをスキャンした場合のUNION ALL処理
• MaxDegreeOfExpansion(上限数)
  • プランノードの展開数の上限を指定します。以下の処理に適用されます。
    • プッシュダウンジョイン最適化処理

分散プランニングの方針を指定します。

• DistributedPolicy(分散プラン方針)
  • 分散プラン方針として、以下のいずれかが指定可能です。
    • 'LOCAL_ONLY'
      • 分散プランとして、接続したノードだけで分散させずにプランニングします。ローカルになければエラーとなります。
    • 'LOCAL_PREFER'
      • 分散プランとして、接続したノードのローカル情報を優先してプランニングします。ローカルになければリモートプランを生成します。

テーブルのスキャン方式を指定します。

• IndexScan(テーブル)
  • 可能な場合はインデックススキャンを選択します。元々インデックススキャンが不可能な場合は何もしません。
• NoIndexScan(テーブル)
  • インデックススキャンを選択しません。

結合方式を指定します。

• IndexJoin(テーブル テーブル)
  • 可能な場合はインデックスジョインを選択します。 元々インデックスジョインが不可能な場合は何もしません。
• NoIndexJoin(テーブル テーブル)
  • インデックスジョインを選択しません。

テーブルのジョイン処理でどのような順番で結合するかを指定します。

(1) 結合順序のみ指定: Leading(テーブル テーブル[ テーブル ...])

先に結合するテーブルから順にテーブル名または別名を指定します。この指定方式の場合、常にLeft-deep joinで結合されます。

(例1)

/*+ Leading(S R Q P) */
SELECT * FROM P,Q,R,S WHERE P.x = Q.x AND ...

(2) 結合方向を含めた指定: Leading((テーブル集合 テーブル集合))

テーブル集合 = { テーブル or (テーブル集合 テーブル集合) }

(1)のように結合順序のみを指定した場合、結合方向(外部表/内部表の別)が期待と異なる場合があります。結合方向を固定したい場合は以下の書式を使います。

/*+ Leading((t1 (t2 t3))) */
SELECT ...

この書式では、括弧をネストして記述できます。括弧内の1つ目に指定したテーブル集合を外部表、2つ目に指定したテーブル集合を内部表として結合されます。

(例2-1)

/*+ Leading(((P Q) R)) */
SELECT * FROM P,Q,R WHERE P.x = Q.x AND ...

(例2-2)

/*+ Leading((R (Q P))) */
SELECT * FROM P,Q,R WHERE P.x = Q.x AND ...

(例2-3)

/*+ Leading(((P Q) (R S))) */
SELECT * FROM P,Q,R,S WHERE P.x = Q.x AND ...

【メモ】

• 3つ以上のテーブルの結合で、テーブル間の結合条件が1つもない場合は、ヒントによる順序指定は出来ません。