使用上の注意 - FastLoad

GRAPHICデータ型は、マルチバイト文字セットのデータを定義します。Teradata FastLoadは、サイトが漢字に定義されている場合、入力データにGRAPHICデータを受け入れます。

NULLIFオプションは、データ フィールドが特定の値の場合に表の中のある列をヌルにします。例として、値が0のフィールドはヌルの日付を表わすとします。この要件を満たすには、DEFINEコマンドのフィールド定義に次のように入力します。

DueDate (DATE, NULLIF =  0)

Teradata FastLoadは、NULLIF句に入力された値と実際のデータ行を比較します。一致する場合、ユーティリティは、該当する標識ビットをその行の列に対してONに設定し、行と標識ビット文字列の両方をデータベースに送信します。データベースは、列に NULL 値を挿入します。

VARCHARフィールドは、NULLIFストリングの長さが(データ行内の) 2 バイトの長さ標識フィールドと一致するかどうかを確認するために検査されます。比較されるのは、値が等しい場合だけです。値が 10 バイトに等しいNULLIF値の場合、Teradata FastLoadはデータ行の対応するフィールドの最初の 10 バイトと比較します。

FastLoadは、期間データ型列ではNULLIF句をサポートしていません。

以下の最小値と最大値は、アプリケーションによっては当てはまらない可能性があります。個々のプラットフォームの実行時環境が異なるためです。

DEFINE T1(BYTE (7), NULLIF = ’01’XB);
DEFINE T1(BYTE (7), NULLIF =
  ’0123456789ABCD’XB);

DEFINE T1(BYTE (7), NULLIF = ’0’XB) ;
DEFINE T1(BYTE (7), NULLIF = ’0M’XB) ;

DEFINE T1(BYTEINT, NULLIF = 123) ;
DEFINE T1(BYTEINT, NULLIF = -123) ; 

DEFINE T1(BYTEINT, NULLIF = 129) ;
DEFINE T1(BYTEINT, NULLIF = -129) ;

DEFINE T1(CHAR (7), NULLIF = ’ ’) ;
DEFINE T1(CHAR (7), NULLIF = ’ABCDEFG’) ;

DEFINE T1(CHAR (7), NULLIF = ’ABCDEFGH’) ;
DEFINE T1(CHAR (7), NULLIF = ’ABCDEFGH’XC) ;

DEFINE T1(INTEGER, NULLIF = 123) ;
DEFINE T1(DATE, NULLIF = 941015) ;

DEFINE T1(DATE, NULLIF=94-10-15);

DEFINE T1(DECIMAL (5,2), NULLIF = 0) ;
DEFINE T1(DECIMAL   (5,2), NULLIF = 123.45) ; 

DEFINE T1(DECIMAL (6,0), NULLIF = 1234567) ;

DEFINE T1(FLOAT, NULLIF = 123) ;

G’<ABC>’
where <ABC> is the quoted string of valid MBC and the characters < and > represent 0x0E and 0x0F.

DEFINE T1(GRAPHIC(4), NULLIF = G'<ABCDEFGH>');
DEFINE T1(GRAPHIC(4), NULLIF = G'<01234567>');

DEFINE T1(GRAPHIC(4), NULLIF =    G'<01234567ABCD>');
DEFINE T1(GRAPHIC(4), NULLIF = G'ABCD0123');

DEFINE T1(GRAPHIC(4), NULLIF = 'ABCDEFGH');
DEFINE T1(GRAPHIC(4), NULLIF = '01234567');

DEFINE T1(GRAPHIC(4), NULLIF = G'<ABCDEFGH>');
DEFINE T1(GRAPHIC(4), NULLIF = G'<01234567>');

DEFINE T1(INTEGER, NULLIF = 123) ;
DEFINE T1(DATE, NULLIF = 941015) ;

DEFINE T1(SMALLINT, NULLIF = 123) ;
DEFINE T1(SMALLINT, NULLIF = -123) ; 

DEFINE T1(SMALLINT, NULLIF = 32768) ;
DEFINE T1(SMALLINT, NULLIF = -32769) ;

すべてのフィールドのMAXIMUMとMINIMUMの範囲は、各マシン実装のデフォルト値です。これらの値は、実装によって制限されている場合を除き、一般的にデータベースに一致します。それらの値はメーカーにより文書化されているか、またはそのマシン用の"C"言語のマニュアルに記載されています。

以下のコマンドのいずれかを使用して、参照表からフィールド名のリストを検索できます。

HELP TABLE  tname  ;
  INSERT  tname.* ;

• KATAKANAEBCDICセッション
• 文字セット名の末尾が_0Iのセッション
• マルチバイト文字 (ASCII、EBCDIC など) をサポートしない文字セットを持つセッション。

  この INSERT ステートメントの形式を使用Teradata FastLoad、テーブル定義からフィールド名のリストを作成します。挿入操作においてユーティリティは、表を定義するのに使用したCREATE TABLE文と表定義から、フィールド名とそれぞれのデータ型を取得します。

  次の例では、INSERT文を使用して、Employeeという表のフィールド名のリストを取得します。

  LOGON dbc/peterson,veep ;
  BEGIN LOADING Employee ERRORFILES   Etable1, Etable2 ;
  DEFINE FILE = Accounts ;
  INSERT Employee.*;

  次の例では、HELPコマンドを使用して、Employeeという表のフィールド名のリストを取得します。

  LOGON dbc/peterson,veep ;
    BEGIN LOADING Employee ERRORFILES   Etable1, Etable2 ;
  DEFINE FILE = INFILE ;
  HELP TABLE Employee ;
  INSERT INTO Employee (EmpNum, Name)   VALUES (:EmpNum, :Name) ;

  どちらの例でも、DEFINEコマンドも入力して、入力データ ソースまたはINMODパラメータを指定する必要があります。

  DEFINEコマンドが1行の入力行に入りきらない場合は、次のどちらかのようにします。

• 複数行にわたってコマンドを入力する

  または

• DEFINEコマンドをいくつかに分ける

  どちらの場合も、Teradata FastLoadはINSERTステートメントが入力されるまでフィールド定義を連結します。

  また、複数のDEFINEコマンドを入力する場合は、そのすべてのフィールド定義を、入力データ レコードの中とまったく同じ順序にする必要があります(単一のDEFINEコマンドでそれらを入力した場合と同じにします)。さらに、1つのDEFINEコマンドだけにFILEまたはINMOD宣言を入れることができます。

DATEFORMコマンドを使用してANSIDATEをDATEデータ タイプとして指定すると、Teradata FastLoadは各DATEフィールドを CHAR(10) フィールドに内部的に変換します。Teradata FastLoad DEFINE コマンドで列/フィールド名を指定するには、すべての ANSI/SQL DateTime TIME, TIMESTAMP 型およびINTERVALデータ型を固定長CHARデータ型に変換する必要があります。

固定長CHARデータ型への変換後、セッション文字セットUTF-16使用する場合は、サイズを 2 倍にし、セッション文字セットUTF-8使用する場合は、サイズを 3 倍にする必要があります。

期間は固定です。対象の期間での連続時間の粒度を表わします。

A period is implemented using a Period data type. 期間には、BEGIN(開始要素)とEND(終了要素)の2つの構成要素があり、ともに3つの日時データ型のうちの1つの要素タイプを持ちます。

CHARデータ型の場合、"n"はフィールドのサイズを表わします。PERIODデータ型の場合は、これとは異なり、"n"は精度(秒の小数部の桁数)を表わします。

PERIODデータは外部的には常にバイナリ形式で表わされます。

Teradata表内でARRAYデータ型として定義されている列は、FIELDコマンドではVARHCARデータ型として指定しなければなりません。The external representation for an ARRAY data type is VARCHAR.

次に、COL003列に1次元のARRAYデータ型が含まれるTeradata表定義の例を示します。

CREATE SET TABLE SOURCE_TABLE ,NO FALLBACK ,
     NO BEFORE JOURNAL,
     NO AFTER JOURNAL,
     CHECKSUM = DEFAULT,
     DEFAULT MERGEBLOCKRATIO
     (
      EMP_ID INTEGER,
      EMP_NO BYTEINT,
      COL003 SYSUDTLIB.PHONENUMBERS_ARY,
      COL004 SYSUDTLIB.DECIMAL_ARY,
      COL005 SYSUDTLIB.INTEGER_ARY)
UNIQUE PRIMARY INDEX ( EMP_ID );

以下はPHONENUMBERS_ARYデータ型のサンプル定義です。

CREATE TYPE PHONENUMBERS_ARY AS CHAR(10) CHARACTER SET LATIN ARRAY [2];

以下はDECIMAL_ARYデータ型のサンプル定義です。

CREATE TYPE DECIMAL_ARY AS DECIMAL(5,2) ARRAY[2];

以下はINTEGER_ARYデータ型のサンプル定義です。

CREATE TYPE INTEGER_ARY AS INTEGER ARRAY[2];

以下は、DEFINEコマンドでSOURCE_TABLE表に指定されるFastLoadフィールド定義のサンプルです。

 EMP_ID  (INTEGER),
  EMP_NO (BYTEINT),
  COL003   (VARCHAR(47)),
  COL004   (VARCHAR(17)),
  COL005   (VARCHAR(25))

上記の例では、COL003列がVARCHAR(47)として定義されており、表内でのCOL003の最大表示を47としています。

以下はCOL003列のサンプル データです。

サンプル データ1: ('3105551234','3105551234')

サンプル データ2: ('''''''''''''''''''''','''''''''''''''''''''')

サンプル データ1には、2つの電話番号要素が含まれています。サンプル データ2には、すべてが単一引用符の要素が2つ含まれています。

上記の例で、COL004列はVARCHAR(17)として定義されており、表内でのCOL004列の最大表示を17としています。

以下はCOL004列のサンプル データです。

サンプル データ1: (-123.45,888.10)

サンプル データ2: (+123.45,-888.10)

上記の例で、COL005列はVARCHAR(25)として定義されており、表内でのCOL005の最大表示を25としています。

以下はCOL005列のサンプル データです。

サンプル データ1: (-2147483648,+2147483647)

サンプル データ2: (0,0)

Use the Teradata SQL "HELP TYPE" command to find out the maximum length for the ARRAY data type. 例えば、サンプルARRAYデータ型PHONENUMBERS_ARY、DECIMAL_ARY、INTEGER_ARY の情報は次のように表示されます。

help type PHONENUMBERS_ARY;

 *** Help information returned. One row.
 *** Total elapsed time was 1 second.

    Name PHONENUMBERS_ARY
    Internal Type A1
    External Type CV
    Max Length            47
    Array(Y/N) Y
    Dimensions             1
    Element Type CF
    UDT Name ?
    Array Scope [1:2]
    Total Digits    ?
    Fractional Digits    ?
    Contains Lob N
    Ordering F
    Ordering Category M
    Ordering Routine LOCAL
    Cast N
    Transform Y
    Method Y
    Char Type  1

HELP TYPE DECIMAL_ARY;

 *** Help information returned. One row.
 *** Total elapsed time was 1 second.
    Name DECIMAL_ARY
    Internal Type A1
    External Type CV
    Max Length            17
    Decimal Total Digits    ?
    Decimal Fractional Digits    ?
    Contains Lob N
    Ordering F
    Ordering Category M
    Ordering Routine LOCAL
    Cast N
    Transform Y
    Method Y
    Char Type  1
    Array(Y/N) Y
    Dimensions             1
    Element Type D
    UDT Name ?
    Array Scope [1:2]

HELP TYPE INTEGER_ARY;

 *** Help information returned. One row.
 *** Total elapsed time was 1 second.
    Name INTEGER_ARY
    Internal Type A1
    External Type CV
    Max Length            25
    Decimal Total Digits    ?
    Decimal Fractional Digits    ?
    Contains Lob N
    Ordering F
    Ordering Category M
    Ordering Routine LOCAL
    Cast N
    Transform Y
    Method Y
    Char Type  1
    Array(Y/N) Y
    Dimensions             1
    Element Type I
    UDT Name ?
    Array Scope [1:2]

HELP TYPEコマンドで返された情報から、サンプルARRAYデータ型PHONENUMBERS_ARYの最大長は47バイトであることが分かります。同じくDECIMAL_ARYの最大長は17バイト、INTEGER_ARYの最大長は25バイトとなっています。

ARRAYデータ型の外部表現の詳細については、Teradata Vantage™ - データ型およびリテラル, B035-1143を参照してください。

使用するセッション文字セットがKANJISJIS_0Sされる場合、ロードされるテーブルの CHAR(n) または VARCHAR(n) が UNICODE 文字セットとして定義されている場合、DEFINEコマンドの対応するフィールドサイズは、それぞれ CHAR(n*2) または VARCHAR(n*2) である必要があります。

ロードされるテーブルの CHAR(n) または VARCHAR(n) が LATIN文字セットとして定義されている場合、DEFINEコマンドの対応するフィールド サイズは、それぞれ CHAR(n) または VARCHAR(n) と同じままです。