Data Types (SQL)

リテラル・パラメータ

リテラル・パラメータは、DDL データ型と、%n 形式の InterSystems IRIS データ型で識別します。n はデータ型引数の番号です。例えば、VARCHAR(%1) は %String(MAXLEN=%1) にマッピングされます。

一般的なリテラル・パラメータとして、最大文字列長、最小値と最大値、精度と位取りの値などがあります。

最大長

データ型クラスでは、MAXLEN パラメータで文字列データ型の最大長を指定します。多くの場合、DDL 型では、それに対応する名前なしパラメータでこれらの値を定義します。

このフィールドの定義では、データ型は最大 64 文字の文字列です。

DDL Using SQL Data Type DDL Using InterSystems IRIS Data Type

ProductName VARCHAR(64)

ProductName %String(MAXLEN=64)

このパラメータを指定するときは以下の点に注意します。

• MAXLEN 値が指定されていないフィールドには、最大文字列長までの任意の長さの値を設定できます。最大長の文字列フィールドを定義するには、VARCHAR("") を指定します。これにより、データ型 %Library.String(MAXLEN="") のプロパティが作成されます。VARCHAR() では、データ型 %Library.String(MAXLEN=1) のプロパティが作成されます。MAXLEN 値が指定されていないバイナリ・フィールドを定義するには、VARBINARY("") を指定します。これにより、データ型 %Library.Binary(MAXLEN="") のプロパティが作成されます。VARBINARY() では、データ型 %Library.Binary(MAXLEN=1) のプロパティが作成されます。

• 大きい MAXLEN 値の指定 ： MAXLEN 値が大きすぎると、ODBC アプリケーションに影響することがあります。ODBC アプリケーションは、サーバからメタデータに基づいて、必要なフィールド・サイズを決定しようとします。そのため、このアプリケーションは、実際に必要な量よりも多くのバッファ・スペースを割り当てる可能性があります。このため、InterSystems IRIS では、システム全体の既定の ODBC VARCHAR の最大長を 4096 に設定します。このシステム全体の既定値は、管理ポータルを使用して構成可能です。[システム管理] から、[構成]、[SQL およびオブジェクトの設定]、[SQL] の順に選択します。[VARCHAR の既定の長さ] オプションを表示または設定します。現在の設定を確認するには、$SYSTEM.SQL.CurrentSettings()Opens in a new tab を呼び出します。InterSystems ODBC ドライバは、TCP バッファからデータを取得し、それをアプリケーションのバッファに変換します。そのため、MAXLEN のサイズが ODBC クライアントに影響することはありません。

最大値と最小値

データ型クラスでは、MINVAL パラメータと MAXVAL パラメータで数値データ型の最小値と最大値を指定します。多くの場合、データ型クラスにはリテラル・パラメータではなく関数パラメータを使用して、これらの値を定義します。DDL 型には、これに相当するパラメータがありません。

このフィールド定義では、データ型は 0 から 100 までの整数です。

Capacity %Integer(MINVAL=0,MAXVAL=100)

精度と小数桁数

データ型クラスの PRECISION パラメータと SCALE パラメータは、それぞれ精度 (最大桁数) と位取り (最大小数点以下桁数) を指定する整数値です。多くの場合、データ型クラスでは、これらの値をリテラル・パラメータではなく関数パラメータで定義します。NUMERIC などの DDL データ型では、精度と位取りを名前なしパラメータとしてまとめて指定することが普通です。

以下のフィールド定義では、精度が 6 で位取りが 2 の数を定義します。

UnitPrice NUMERIC(6,2) // Range: -9999.99 to 9999.99

精度と位取りのパラメータでは、数値データ型を以下のように定義します。

• 精度 — 最大許容値と最小許容値です。0 から 19 までの整数に s を加算した値を指定します。s は小数点以下桁数です。一般的に精度は数値の合計桁数ですが、その正確な値は、%Library クラス・データ型のマッピングによって決まります。この最大整数値は 9223372036854775807 です。19 + s より大きな精度は既定で 19 + s になります。

• 位取り — 最大許容小数点以下桁数です。整数で指定します。s が精度 p 以上の場合は小数以下の数値のみを使用でき、実際の p 値は無視されます。許容される最大のスケールは 18 です。これは .999999999999999999 に相当します。18 より大きなスケールは既定で 18 になります。

数値のフォーマットの詳細は、$FNUMBER 関数の説明を参照してください。

関数パラメータ

DDL データ型のパラメータを InterSystems IRIS データ型に入力できるように、事前に変換する必要がある場合に関数パラメータを使用します。以下の例では、DDL データ型数値の精度と位取りの各パラメータを InterSystems IRIS データ型の MAXVAL パラメータと MINVAL パラメータに変換しています。

例えば、管理ポータルの [システム定義DDLマッピング] テーブルに表示するために、DECIMAL DDL データ型と %NumericOpens in a new tab クラスとのマッピングを考えます。

DDL Using SQL Data Type DDL Using InterSystems IRIS Data Type

DECIMAL(%1,%2)

%Numeric(MAXVAL=<|'$$maxval^%apiSQL(%1,%2)'|>,MINVAL=<|'$$minval^%apiSQL(%1,%2)'|>,SCALE=%2)

パラメータ %1 と %2 で、目的とするデータ型数値の精度と位取りをそれぞれ指定します。例えば、データ型が DECIMAL(4,2) のフィールドには、精度が 4 桁で小数点以下が 2 桁の数値を格納します。InterSystems SQL では、これらのパラメータを使用して、フィールドの最小許容値 (–99.99) と最大許容値 (99.99) が導き出されます。

%NumericOpens in a new tab クラスの場合、InterSystems IRIS で SCALE パラメータ (SCALE=%2) は設定されますが、設定すべき PRECISION パラメータがありません。代わりに、以下の各変換関数を使用して MAXVAL パラメータと MINVAL パラメータが設定されます。

• maxval^%apiSQL(precision,scale) は、精度と位取りを設定した、有効な数値の最大値 MAXVAL を返します。

• minval^%apiSQL(precision,scale) は、精度と位取りを設定した、有効な数値の最小値 MINVAL を返します。

これらの変換関数の構文は以下のとおりです。

dataTypeClass(param=<|'func'|>, param2=<|func2|>, ...)

その他のパラメータ

DDL データ型では定義できないものの、データ型クラスでは定義できるデータ定義パラメータがあります。これには、許可されるデータ値の列挙リスト、許可されるデータ値のパターン・マッチング、MAXLEN の最大長を超えるデータ値の自動切り捨てなどのデータ検証操作が含まれます。

日付、時刻、およびタイムスタンプのデータ型

InterSystems SQL 標準の日付、時刻の関数を使用して、日付、時刻、タイムスタンプのデータ型を定義できます。また、日付とタイムスタンプを相互に変換することもできます。例えば、CURRENT_DATE や CURRENT_TIMESTAMP をデータ型で定義されたフィールドへの入力として使用したり、DATEADD、DATEDIFF、ATENAME、または DATEPART を使用して、このデータ型で保存された日付値を操作したりできます。

日付、時刻、タイムスタンプのデータ型クラスと SQL のタイプとの対応を以下の表に示します。データ型クラスでは、SQL で計算するときにこのタイプを使用します。カスタムのデータ型クラスを作成すると、これらのマッピングを使用して、どの SQL タイプを指定するべきかをクラス定義の SqlCategory キーワードで指定できます。以下に例を示します。

Class MyApp.MyDateDT [ ClassType = DataType, SQLCategory = DATE ]
{
    // class members
}

演算子 =、<>、>、または < を使用して、POSIXTIME を DATE 値または TIMESTAMP 値と比較できます。詳細は "述語の概要" を参照してください。

InterSystems IRIS では、FMTIMESTAMP カテゴリ値と DATE カテゴリ値を比較する場合に、DATE と比較する前に FMTIMESTAMP 値から時間を削除することはありません。この動作は、TIMESTAMP と DATE の値の比較、および TIMESTAMP と MVDATE の値の比較に対する動作と同じになりました。これは、他の SQL ベンダによるタイムスタンプと日付の比較方法とも互換性があります。つまり、FMTIMESTAMP 320110202.12 と DATE 62124 の比較は、SQL等値 (=) 演算子を使用した比較では等しくなります。アプリケーションでは、FMTIMESTAMP 値を DATE または FMDATE 値に変換して値の日付部分のみを比較する必要があります。

1840 年 12 月 31 日より前の日付

日付は一般的に、DATE データ型、または TIMESTAMP データ型で表されます。

DATE データ型は、$HOROLOG 形式で日付を格納し、任意の開始日 1840 年 12 月 31 日以降の日数を正の整数値としてカウントします。既定では、日付は正の整数値でのみ表すことができます (MINVAL=0。これは 1840 年 12 月 31 日に相当します)。ただし、%Library.DateOpens in a new tab MINVAL 型パラメータを変更することで、1840 年 12 月 31 日より前の日付の格納を可能にできます。MINIVAL を負の数値に設定すると、1840 年 12 月 31 日より前の日付を負の整数値として格納できます。使用可能な最も前の MINIVAL 値は -672045 です。これは西暦 1 年 (CE) 1 月 1 日に対応します。DATE データ型で BCE (紀元前) の日付を表すことはできません。

TIMESTAMP データ型は、既定で、許容される最も早いタイムスタンプである 1840–12–31 00:00:00 となります。ただし、MINVAL パラメータを変更すれば、1840 年 12 月 31 日より前の日付を保存できるフィールドまたはプロパティを定義できます (例 ： MyTS %Library.TimeStamp(MINVAL='1492-01-01 00:00:00'))。許容される最も早い MINVAL 値は 0001–01–01 00:00:00 です。これは西暦 1 年 1 月 1 日に相当します。%TimeStamp データ型で BCE (紀元前) の日付を表すことはできません。

Note:

これらの日付のカウントでは、グレゴリオ暦の導入 (1582 年 10 月に制定、ただし英国およびその植民地で採用されたのは 1752 年) による日付の変更が考慮されないことに注意してください。

ロケールの最小の日付は、以下のように再定義できます。

  SET oldMinDate = ##class(%SYS.NLS.Format).GetFormatItem("DATEMINIMUM")
  IF oldMinDate=0 {
    DO ##class(%SYS.NLS.Format).SetFormatItem("DATEMINIMUM",-672045)
    SET newMinDate = ##class(%SYS.NLS.Format).GetFormatItem("DATEMINIMUM")
    WRITE "Changed earliest date to ",newMinDate
    }
  ELSE { WRITE "Earliest date was already reset to ",oldMinDate}

上記の例では、ロケールの MINIVAL を、使用可能な最も早い日付 (1/1/01) に設定します。ロケールに基づく日付構成の詳細は、"各国言語サポート (NLS) の構成" を参照してください。

Note:

InterSystems IRIS は、負の論理 DATE 値 (MINVAL<0 の %Library.Date 値) によるユリウス日の使用をサポートしていません。このため、このような MINVAL<0 値には、TO_CHAR 関数で返されるユリウス日付形式との互換性がありません。

文字列

%Library.StringOpens in a new tab データ型は、3,641,144 文字の最大文字列長をサポートします。一般に、極端に長い文字列には %Stream.GlobalCharacterOpens in a new tab データ型のいずれかを割り当てる必要があります。詳細は、"最大文字列長" を参照してください。

IRIS は xDBC プロトコル 50 以降をサポートしているため、ODBC または JDBC 文字列長の制限は適用されません。InterSystems IRIS インスタンスと ODBC ドライバ機能でサポートされているプロトコルが異なる場合は、2 つのプロトコルの中で下位のものが使用されます。実際に使用されたプロトコルは、InterSystems ODBC ログに記録されます。

既定では、InterSystems IRIS はシステム全体の ODBC VARCHAR の最大長を 4096 に設定します。この ODBC の最大長は構成可能です。

リスト構造

InterSystems IRIS は、リスト構造のデータ型 %List (データ型クラス %Library.List) をサポートしています。これは圧縮バイナリ形式であり、InterSystems SQL で対応するネイティブなデータ型にマップしません。その内部表現では、データ型 VARBINARY に対応しており、その MAXLEN の既定値は 32749 です。InterSystems IRIS は、リスト構造データ型 %ListOfBinary (データ型クラス %Library.ListOfBinary) をサポートしています。これはデータ型 VARBINARY に対応しており、その MAXLEN の既定値は 4096 です。

このため、ダイナミック SQL では、WHERE 節での比較に %List データを使用できません。また、型 %List のプロパティ値を設定するときに、INSERT も UPDATE も使用できません。

ダイナミック SQL では、リスト構造化されたデータのデータ型が VARCHAR として返されます。クエリ内のフィールドのデータ型が %List または %ListOfBinary かどうかを確認するには、select-item 列メタデータのブーリアン・フラグ isList を使用できます。これらのデータ型の CType (クライアント・データ型) 整数コードは 6 です。

ODBC クライアントまたは JDBC クライアントを使用する場合には、LogicalToOdbc 変換を使用して、%List データが VARCHAR 文字列データに投影されます。リストは、各要素がコンマで区切られた文字列として投影されます。この型のデータは、WHERE 節、INSERT 文および UPDATE 文で使用できます。既定では、InterSystems IRIS はシステム全体の ODBC VARCHAR の最大長を 4096 に設定します。この ODBC の最大長は構成可能です。

データ型クラス %Library.ListOpens in a new tab の詳細は、"インターシステムズ・クラス・リファレンス" を参照してください。WHERE 節でのリストの使用に関する詳細は、"%INLIST" 述語および "FOR SOME %ELEMENT" 述語の説明を参照してください。リスト・データを文字列として処理する方法の詳細は、"%EXTERNAL" 関数を参照してください。

InterSystems SQL は、$LIST、$LISTBUILD、$LISTDATA、$LISTFIND、$LISTFROMSTRING、$LISTGET、$LISTLENGTH、$LISTTOSTRING の 8 つのリスト関数をサポートしています。ObjectScript は、この他に 3 つのリスト関数をサポートしています。$LISTVALID は式がリストであるかどうかを判断するときに、$LISTSAME は 2 つのリストを比較するときに、$LISTNEXT はリストから要素を順番に取得するときに使用します。

BIT データ型

BIT (%Library.BooleanOpens in a new tab) データ型では、0、1、および NULL を有効な値として使用できます。

• 論理モードおよび ODBC モードでは、使用できる値は 0、1、および NULL だけです。

• 表示モードでは、DisplayToLogical メソッドによって、最初に非 NULL の入力値を以下のように 0 または 1 に変換します。

  • ゼロ以外の数値または数値文字列 = 1。3、'0.1'、'-1'、'7dwarves' など。

  • 非数値文字列 = 0。'true'、'false' など。

  • 空の文字列 = 0。'' など。

ストリーム・データ型

ストリーム・データ型は、InterSystems IRIS クラス・プロパティのデータ型 %Stream.GlobalCharacterOpens in a new tab (CLOB の場合) および %Stream.GlobalBinaryOpens in a new tab (BLOB の場合) に対応します。これらのデータ型クラスは、指定された LOCATION パラメータでストリーム・フィールドを定義するか、このパラメータを省略して既定のシステム定義のストレージ位置にすることができます。

ストリーム・データ型のフィールドは、ほとんどの SQL スカラ関数、集約関数、または単項関数で引数として使用できません。削除しようとすると、SQLCODE -37 エラー・コードが発行されます。例外であるいくつかの機能は、"InterSystems SQL の使用法" の "ストリーム・データ (BLOB と CLOB) の格納と使用" の章にリストされています。

ストリーム・データ型のフィールドは、ほとんどの SQL 述語条件で引数として使用できません。削除しようとすると、SQLCODE -313 エラー・コードが発行されます。ストリーム・フィールドを受け取る述語は、"InterSystems SQL の使用法" の "ストリーム・データ (BLOB と CLOB) の格納と使用" の章にリストされています。

シャード・テーブルにストリーム・データ型のフィールドを含めることはできません。

インデックス内、および挿入/更新の実行時におけるストリーム・データ型の使用も制限されています。ストリームの制限の詳細は、"InterSystems SQL の使用法" の "ストリーム・データ (BLOB と CLOB) の格納と使用" の章を参照してください。

SERIAL データ型

SERIAL (%Library.CounterOpens in a new tab) データ型のフィールドでは、ユーザ指定の正の整数値を使用できます。または、InterSystems IRIS では、連続する正の整数値をそのフィールドに割り当てることができます。%Library.CounterOpens in a new tab は %Library.BigIntOpens in a new tab を拡張します。

INSERT 操作では、SERIAL フィールドに以下のいずれかの値が指定されます。

• 値なし、0 (ゼロ)、または非数値： InterSystems IRIS では、指定された値が無視され、その代わり、このフィールドの現在のシリアル・カウンタ値が 1 ずつインクリメントされ、インクリメント後の整数がフィールドに挿入されます。

• 正の整数値： InterSystems IRIS では、フィールドにユーザ指定の値が挿入され、このフィールドのシリアル・カウンタ値がこの整数値に変更されます。

したがって、SERIAL フィールドには、一連のインクリメンタル整数値が含まれます。これらの値は、連続または一意とは限りません。例えば、SERIAL フィールドでは、1、2、3、17、18、25、25、26、27 といった一連の値が有効です。連続する整数は、InterSystems IRIS で生成されるか、またはユーザが指定します。連続しない整数はユーザが指定します。SERIAL フィールドの値を一意にする場合には、そのフィールドに UNIQUE 制約を適用する必要があります。

UPDATE 操作は、自動的に割り当てられた SERIAL カウンタ・フィールドの値に影響しません。ただし、INSERT OR UPDATE を使用して実行される更新では、SERIAL フィールドに対する後続の挿入操作で整数シーケンスのスキップが発生します。

UPDATE 操作では、SERIAL フィールドに現在、値がない (NULL) 場合、またはその値が 0 の場合にのみ、そのフィールドを変更できます。それ以外の場合には、SQLCODE -105 エラーが生成されます。

InterSystems IRIS では、テーブル内の SERIAL フィールドの数には制約がありません。

ROWVERSION データ型

ROWVERSION データ型は、システムによって割り当てられる、1 で始まる一意の正の整数を含む読み取り専用フィールドを定義します。InterSystems IRIS は、挿入、更新、または %Save の各処理の一部として連続した整数を割り当てます。これらの値をユーザが変更することはできません。

InterSystems IRIS は、ネームスペース全体で 1 つの行バージョン・カウンタを維持します。ROWVERSION フィールドを含むネームスペース内のすべてのテーブルが、同じ行バージョン・カウンタを共有します。このように、ROWVERSION フィールドでは行レベルのバージョン・コントロールが可能なため、ユーザはネームスペース内の 1 つ以上のテーブルの行に対して行った変更の順序を決定できます。

テーブルごとに指定できる ROWVERSION データ型のフィールドは 1 つのみです。

一意キーや主キーに ROWVERSION フィールドを含めることはできません。ROWVERSION フィールドを IDKey インデックスの一部にすることはできません。

ROWVERSION の使用の詳細は、"InterSystems SQL の使用法" の “テーブルの定義” の章にある "RowVersion フィールド" セクションを参照してください。

ROWVERSION カウンタと SERIAL カウンタ

ROWVERSION と SERIAL (%Library.CounterOpens in a new tab) データ型フィールドは両方とも、INSERT 操作の一部として内部カウンタから連続した整数を受け取ります。ただし、これらの 2 つのカウンタは大きく異なるうえ、使用目的も異なります。

• ROWVERSION カウンタはネームスペース・レベルにあります。SERIAL カウンタはテーブル・レベルにあります。これらの 2 つのカウンタは相互から完全に独立しており、RowID カウンタからも独立しています。

• ROWVERSION カウンタは挿入、更新、または %Save 操作によってインクリメントされます。SERIAL カウンタは挿入操作によってのみインクリメントされます。INSERT OR UPDATE を使用して実行される更新によって、SERIAL カウンタ・シーケンスにギャップが生じる可能性があります。

• ROWVERSION フィールドの値をユーザ指定にすることはできません。この値には常に ROWVERSION カウンタから指定されます。ユーザが SERIAL フィールドの値を指定していない場合、このフィールドの値には、挿入操作中のテーブルの内部カウンタの値が指定されます。挿入によって SERIAL の整数値が指定される場合、現在のカウンタ値ではなくその値が挿入されます。

  • 挿入によって現在の内部カウンタ値よりも大きい SERIAL フィールドの値が指定される場合、InterSystems IRIS はその値をフィールドに挿入し、内部カウンタをその値にリセットします。

  • 挿入によって現在のカウンタ値よりも小さい SERIAL フィールドの値が指定されると、InterSystems IRIS は内部カウンタをリセットしません。

  • 挿入によって SERIAL フィールドの値を負の整数または小数に指定できます。InterSystems IRIS は、小数を切り捨てて、その整数部分のみにします。指定された SERIAL フィールドの値が 0 または NULL の場合、InterSystems IRIS はユーザ指定の値を無視し、現在の内部カウンタ値を挿入します。

  既存の SERIAL フィールドの値を更新することはできません。

• ROWVERSION フィールドの値は常に一意です。ユーザ指定の SERIAL フィールドの値の挿入が可能なため、一意のSERIALフィールドの値を保証するには、UNIQUE フィールド制約を指定する必要があります。

• ROWVERSION カウンタはリセットできません。TRUNCATE TABLE は SERIAL カウンタをリセットします。すべての行に対して DELETE を実行しても SERIAL カウンタはリセットされません。

• ROWVERSION フィールドは、テーブルごとに 1 つのみ許可されます。SERIAL フィールドは、1 つのテーブルに複数指定できます。

InterSystems ODBC / JDBC で使用される DDL データ型

InterSystems ODBC は、DDL データ型のサブセットを使用して、このデータ型のサブセットに、その他のデータ型をマップします。これらのマッピングを元に戻すことはできません。例えば、CREATE TABLE mytable (f1 BINARY) 文は、mytable (f1 VARBINARY) として ODBC に投影される InterSystems IRIS クラスを作成します。InterSystems IRIS のリスト・データ型は、VARCHAR 文字列として ODBC に投影されます。

ODBC は、BIGINT、BIT、DATE、DOUBLE、GUID、INTEGER、LONGVARBINARY、LONGVARCHAR、NUMERIC、OREF、POSIXTIME、SMALLINT、TIME、TIMESTAMP、TINYINT、VARBINARY、VARCHAR のデータ型を公開します。既定では、InterSystems IRIS はシステム全体の ODBC VARCHAR の最大長を 4096 に設定します。この ODBC の最大長は構成可能です。

これらの ODBC/JDBC データ型の値の 1 つが InterSystems SQL にマップされると、以下の演算が実行されます。DOUBLE データが $DOUBLE を使用してキャストされます。NUMERIC データが $DECIMAL を使用してキャストされます。

GUID データ型は、InterSystems SQL の UNIQUEIDENTIFIER データ型に相当します。GUID / UNIQUEIDENTIFIER フィールドに有効な値を指定できないと、#7212 一般エラーが生成されます。GUID 値を生成するには、%SYSTEM.Util.CreateGUID()Opens in a new tab メソッドを使用します。