CREATE TABLE

省略可能。このキーワードは、ステートメントに指定できますが、Amazon Redshift では効果がありません。

現在のセッション内でのみ表示可能な一時テーブルを作成するキーワード。このテーブルは、作成したセッションの終了時に自動的に削除されます。一時テーブルには永続テーブルと同じ名前を付けることができます。一時テーブルは、別のセッション固有のスキーマ内に作成されます (このスキーマの名前を指定することはできません)。この一時スキーマは検索パスの最初のスキーマになるため、永続テーブルにアクセスするようにスキーマ名でテーブル名を修飾しない限り、一時テーブルは永続テーブルよりも優先されます。スキーマと優先順位の詳細については、「search_path」を参照してください。

指定されたテーブルが既に存在する場合、コマンドはエラーで終了するのではなく、何も変更せずに、テーブルが存在するというメッセージを返すことを示す句。既存のテーブルの内容が、作成予定のテーブルとはまったく異なる可能性があることに注意してください。比較されるのはテーブル名のみです。

この句は、CREATE TABLE で既存のテーブルを作成しようとしてもスクリプトが失敗しないため、スクリプトを作成する際に便利です。

作成するテーブルの名前。

create table #newtable (id int);

select * from #newtable;

テーブル名の最大長は 127 バイトです。それより長い名前は 127 バイトまで切り詰められます。最大 4 バイトまで UTF-8 マルチバイト文字を使用できます。Amazon Redshift は、ユーザー定義の一時テーブルや、クエリ処理またはシステムメンテナンス中に Amazon Redshift によって作成された一時テーブルを含む、各ノードタイプのクラスターあたりのテーブル数のクォータを適用します。オプションで、テーブル名は、データベース名およびスキーマ名で修飾することができます。次の例では、データベース名は tickit、スキーマ名は public、テーブル名は test です。

create table tickit.public.test (c1 int);

データベースまたはスキーマが存在し、テーブルが作成されていない場合、このステートメントはエラーを返します。システムデータベース template0、template1、padb_harvest、または sys:internal にテーブルまたはビューを作成することはできません。

スキーマ名を指定すると、新しいテーブルはそのスキーマ内に作成されます (作成者がスキーマにアクセス権を持っている場合)。テーブル名は、そのスキーマで一意の名前にする必要があります。スキーマを指定しない場合、現在のデータベーススキーマを使用してテーブルが作成されます。一時テーブルを作成する場合、一時テーブルは特殊なスキーマに作成されるので、スキーマ名を指定することはできません。

同じ名前の一時テーブルでも、別のセッションで作成される場合は同じデータベース内に同時に存在することができます。これは、テーブルに割り当てられるスキーマが異なるためです。有効な名前の詳細については、「名前と識別子」を参照してください。

新しいテーブルで作成される列の名前。列名の最大長は 127 バイトです。それより長い名前は 127 バイトまで切り詰められます。最大 4 バイトまで UTF-8 マルチバイト文字を使用できます。1 つのテーブルで定義できる列の最大数は 1,600 です。有効な名前の詳細については、「名前と識別子」を参照してください。

作成する列のデータ型。CHAR および VARCHAR の列の場合、最大長を宣言する代わりに MAX キーワードを使用できます。MAX は、最大長を CHAR では 4096 バイト、VARCHAR では 65535 バイトに設定します。GEOMETRY オブジェクトの最大サイズは 1,048,447 バイトです。

Amazon Redshift でサポートされているデータ型の詳細については、「データ型」を参照してください。

列のデフォルトのデータ値を割り当てる句。default_expr のデータ型は列のデータ型に一致する必要があります。DEFAULT 値は、変数を使用しない式にする必要があります。サブクエリ、現在のテーブルに含まれる他の列の相互参照、およびユーザー定義の関数は使用できません。

default_expr 式は、列の値を指定しないすべての INSERT 操作で使用されます。デフォルト値を指定しなかった場合、列のデフォルト値は null です。

定義済み列リストの COPY 操作で、DEFAULT 値が含まれている列を省略すると、COPY コマンドで default_expr の値が挿入されます。

列が IDENTITY 列であることを指定する句。IDENTITY 列には、一意の自動生成値が含まれます。IDENTITY 列のデータ型は、INT または BIGINT にする必要があります。

INSERT または INSERT INTO [tablename] VALUES() ステートメントを使用して行を追加する場合、これらの値は、seed として指定された値で始まり、step として指定された数が増分されます。

INSERT INTO [tablename] SELECT * FROM または COPY ステートメントを使用してテーブルをロードすると、データはパラレルにロードされ、ノードスライスに分散されます。ID 値が一意であることを確認するために、Amazon Redshift は ID 値を作成するときにいくつかの値をスキップします。ID 値は一意ですが、順序はソースファイルの順序と一致しない場合があります。

列がデフォルトの IDENTITY 列であることを指定し、一意の値を列に自動的に割り当てることができるようにする句。IDENTITY 列のデータ型は、INT または BIGINT にする必要があります。値のない行を追加する場合、これらの値は、seed として指定された値で始まり、step として指定された数が増分されます。値の生成方法については、「IDENTITY」を参照してください。

また、INSERT、UPDATE、または COPY の間に、EXPLICIT_IDS なしで値を指定できます。Amazon Redshift は、システムで生成された値を使用する代わりに、その値を使用して ID 列に挿入します。値は、重複、seed より小さい値、または step 値間の値にすることができます。Amazon Redshift は、列値の一意性を確認しません。値を指定しても、システムが生成する次の値には影響しません。

デフォルトの identity 列については、次のことに注意してください。

列の圧縮エンコード。ENCODE AUTO は、テーブルのデフォルトです。Amazon Redshift は、テーブル内のすべての列の圧縮エンコードを自動的に管理します。テーブル内のいずれかの列に圧縮エンコードを指定すると、テーブルは ENCODE AUTO に設定されなくなります。Amazon Redshift は、テーブルにあるすべての列の圧縮エンコードを自動的に管理しないようになりました。テーブルに ENCODE AUTO オプションを指定して、Amazon Redshift がテーブルにあるすべての列の圧縮エンコードを自動的に管理できるようになります。

Amazon Redshift は、圧縮エンコードを指定していない列に、次のように初期圧縮エンコードを自動的に割り当てます。

次の compression encodings がサポートされています。

列がテーブルの分散キーであることを指定するキーワード。テーブル内の 1 つの列のみを分散キーに指定できます。DISTKEY キーワードは列名の後に使用するか、DISTKEY (column_name) 構文を使用してテーブル定義の一部として使用できます。どちらの方法でも同じ結果が得られます。詳細については、このトピックで後述する DISTSTYLE パラメータを参照してください。

ディストリビューションキー列のデータ型には、BOOLEAN、REAL、DOUBLE PRECISION、SMALLINT、INTEGER、BIGINT、DECIMAL、DATE、TIME、TIMETZ、TIMESTAMP、または TIMESTAMPTZ、CHAR、または VARCHAR のいずれかを使用できます。

列がテーブルのソートキーであることを指定するキーワード。データをテーブルにロードすると、データはソートキーとして指定された 1 つまたは複数の列に従ってソートされます。列名の後に SORTKEY キーワードを使用して 1 列のソートキーを指定することができます。または、SORTKEY (column_name [, ...]) 構文を使用して、テーブルのソートキーとして 1 つまたは数の列を指定することができます。この構文では複合ソートキーのみが作成されます。

1 つのテーブルで、最大 400 の SORTKEY 列を定義できます。

ソートキー列のデータ型には、BOOLEAN、REAL、DOUBLE PRECISION、SMALLINT、INTEGER、BIGINT、DECIMAL、DATE、TIME、TIMETZ、TIMESTAMP、または TIMESTAMPTZ、CHAR、または VARCHAR のいずれかを使用できます。

列での文字列検索または比較が、CASE_SENSITIVE か CASE_INSENSITIVE かを指定する句。デフォルト値は、大文字と小文字を区別する、現行のデータベースの設定と同じです。

データベース照合に関する情報を検索するには、次のコマンドを使用します。

SELECT db_collation();
                     
db_collation
----------------
 case_sensitive
(1 row)

NOT NULL は、列に null 値を使用できないことを指定します。NULL はデフォルトであり、列で null 値を使用できることを指定します。IDENTITY 列はデフォルトで NOT NULL として宣言されます。

列に一意の値のみを含めることができることを指定するキーワード。一意のテーブル制約の動作は、列制約の動作と同じですが、さらに複数の列に適用される点が異なります。一意のテーブル制約を定義するには、UNIQUE ( column_name [, ... ] ) 構文を使用します。

列がテーブルのプライマリキーであることを指定するキーワード。列定義を使用してプライマリキーとして定義できるのは 1 列だけです。複数列のプライマリキーを使用してテーブル制約を定義するには、PRIMARY KEY ( column_name [, ... ] ) 構文を使用します。

列をプライマリキーに指定すると、スキーマの設計に関するメタデータが提供されます。プライマリキーは、他のテーブルが、行の一意の識別子としてこの列セットに依存している可能性があることを示します。列制約かテーブル制約かにかかわらず、テーブルに指定できるプライマリキーは 1 つです。プライマリキーの制約は、同じテーブルに定義されている一意の制約で指定された列セットとは異なる列セットを指定する必要があります。

PRIMARY KEY 列は NOT NULL としても定義されます。

参照テーブルの行の参照列に含まれている値と一致する値を列に格納する必要があることを意味する、外部キー制約を指定する句。参照列は、参照テーブルの一意の制約またはプライマリキーの制約の列にする必要があります。

新しいテーブルで、列名、データ型、NOT NULL 制約を自動的にコピーする既存のテーブルを指定する句。新しいテーブルと親テーブル間に関連付けはなく、親テーブルを変更しても、新しいテーブルに変更は適用されません。コピーした列定義のデフォルトの式は、INCLUDING DEFAULTS を指定した場合にのみコピーされます。デフォルトの動作では、デフォルトの式が除外されるため、新しいテーブルのすべての列は NULL のデフォルト値になります。

LIKE オプションを指定して作成したテーブルは、プライマリキーと外部キーの制約を継承しません。分散スタイル、ソートキー、BACKUP、NULL のプロパティは LIKE テーブルで継承されますが、CREATE TABLE ..。LIKE ステートメントで明示的に設定することはできません。

テーブルを自動および手動クラスター スナップショットに含めるかどうかを指定する句。

重要なデータを含まないステージングテーブルなどのテーブルについては、スナップショットの作成やスナップショットからの復元にかかる時間を節約し、Amazon Simple Storage Service のストレージスペースを節約するため、BACKUP NO を指定します。BACKUP NO の設定は、クラスター内の別ノードへのデータの自動レプリケーションには影響しません。そのため、BACKUP NO が指定されたテーブルはノードの障害時に回復されます。デフォルトは BACKUP YES です。

テーブル全体のデータディストリビューションスタイルを定義するキーワード。Amazon Redshift は、テーブルに指定されたディストリビューションスタイルに従って、テーブルの行をコンピューティングノードに分散します。デフォルトは AUTO です。

テーブルにどの分散スタイルを選択するかによって、データベースの全体的なパフォーマンスが左右されます。詳細については、「クエリ最適化のためのデータのディストリビューション」を参照してください。可能な分散スタイルは次のとおりです。

テーブルの分散キーとして使用する列を指定する制約。DISTKEY キーワードは列名の後に使用するか、DISTKEY (column_name) 構文を使用してテーブル定義の一部として使用できます。どちらの方法でも同じ結果が得られます。詳細については、このトピックで先述した DISTSTYLE パラメータを参照してください。

テーブルに対して 1 つ以上のソートキーを指定します。データをテーブルにロードすると、データはソートキーとして指定された列に従ってソートされます。列名の後に SORTKEY キーワードを使用して 1 列のソートキーを指定することができます。または、SORTKEY (column_name [ , ... ] )構文を使用して、テーブルのソートキーとして 1 つまたは数の列を指定することができます。

オプションでソート方式として COMPOUND または INTERLEAVED を指定できます。列とともに SORTKEY を指定した場合、デフォルトは COMPOUND です。詳細については、「ソートキー」を参照してください。

ソートキーオプションを指定しない場合、デフォルトは AUTO です。

1 つのテーブルで最大 400 の COMPOUND SORTKEY 列または 8 の INTERLEAVED SORTKEY 列を定義できます。

Amazon Redshift がテーブル内のすべての列のエンコードタイプを自動的に調整して、クエリのパフォーマンスを最適化できるようにします。ENCODE AUTO は、テーブルの作成時に指定した初期エンコードタイプを保持します。その後、Amazon Redshift が新しいエンコードタイプによってクエリのパフォーマンスが向上すると判断した場合、Amazon Redshift はテーブル列のエンコードタイプを変更できます。テーブルのどの列にもエンコード型を指定しない場合、デフォルトは ENCODE AUTO です。

テーブルの 1 つまたは複数の列のグループに、一意の値のみを含めることができることを指定する制約。一意のテーブル制約の動作は、列制約の動作と同じですが、さらに複数の列に適用される点が異なります。一意の制約がある場合、NULL 値は等値と見なされません。各一意のテーブル制約は、テーブルに定義されている他の一意のキーまたはプライマリキーで指定された列セットとは異なる列セットを指定する必要があります。

テーブルの 1 つまたは複数の列のグループに、一意の (重複しない) NULL 以外の値のみを含めることができることを指定する制約。列セットをプライマリキーに指定すると、スキーマの設計に関するメタデータも提供されます。プライマリキーは、他のテーブルが、行の一意の識別子としてこの列セットに依存している可能性があることを示します。単一の列制約かテーブル制約かにかかわらず、テーブルに指定できるプライマリキーは 1 つです。プライマリキーの制約は、同じテーブルに定義されている一意の制約で指定された列セットとは異なる列セットを指定する必要があります。

外部キーの制約を指定する制約。この制約では、新しいテーブルの 1 列以上のグループに、参照テーブルのいずれかの行の参照列の値と一致する値のみを含める必要があります。refcolumn を省略すると、reftable のプライマリキーが使用されます。参照列は、参照テーブルの一意の制約またはプライマリキーの制約の列にする必要があります。

列レベルで設定されるかテーブルレベルで設定されるかにかかわらず、結果に違いはありません。

列レベルかテーブルレベルかにかかわらず、DISTKEY が設定されている場合は、DISTSTYLE を KEY に設定するか、まったく設定しない必要があります。DISTSTYLE はテーブルレベルでしか設定できません。

列レベルで設定されている場合、SORTKEY は 1 列でなければなりません。SORTKEY がテーブルレベルで設定されている場合は、1 つまたは複数の列で複合ソートキーまたはインターリーブコンポジットソートキーを構成できます。

Amazon Redshift では、列での大文字と小文字の区別に関する設定の変更はサポートされていません。新しい列をテーブルに追加すると、Amazon Redshift は、大文字と小文字の区別に関する設定にデフォルト値を適用します。Amazon Redshift は、新しい列を追加するときに、COLLATE キーワードをサポートしません。

データベース照合を使用してデータベースを作成する方法については、「CREATE DATABASE」を参照してください。

COLLATE 関数の詳細については、「COLLATE 関数」を参照してください。

列レベルでは、1 つまたは複数のキーを UNIQUE に設定できます。UNIQUE 制約は各列に個別に適用されます。UNIQUE がテーブルレベルで設定されている場合は、1 つまたは複数の列で複合 UNIQUE 制約を構成できます。

列レベルで設定されている場合、PRIMARY KEY は 1 列でなければなりません。PRIMARY KEY がテーブルレベルで設定されている場合は、1 つまたは複数の列で複合プライマリキーを構成できます。

FOREIGN KEY が列レベルで設定されるかテーブルレベルで設定されるかにかかわらず、結果に違いはありません。列レベルでは、構文は単に REFERENCES reftable [ ( refcolumn )] になります。