フィールド ターミネータと行ターミネータの指定

ターミネータとしてサポートされる文字

bcp コマンド、BULK INSERT ステートメント、および OPENROWSET 一括行セット プロバイダーでは、フィールド ターミネータまたは行ターミネータとしてさまざまな文字がサポートされます。また、常に、各ターミネータの最初のインスタンスが検索されます。ターミネータ用にサポートされる文字を次の表に示します。

1 円記号のエスケープ文字と共に制御文字として機能するのは、t、n、r、0 および '\0' だけです。

2 印刷時には NULL 制御文字 (\0) が表示されませんが、データ ファイルでは 1 つの文字です。つまり、フィールド ターミネータまたは行ターミネータとして NULL 制御文字を使用することと、フィールド ターミネータまたは行ターミネータをまったく使用しないことは異なります。

重要
データ内にターミネータ文字が出現すると、データではなく、ターミネータとして解釈されます。その文字に続くデータは、次のフィールドまたは次のレコードに属すると解釈されます。したがって、ターミネータがデータに出現することがないように、注意深くターミネータを選択してください。

行ターミネータの使用

行ターミネータと最後のフィールドのターミネータを兼用できます。ただし、通常は、行ターミネータを別に指定する方が便利です。たとえば、表形式の出力を生成するには、各行の最後のフィールドを改行文字 (\n) で終了し、他のすべてのフィールドをタブ文字 (\t) で終了します。各データ レコードをデータ ファイル内の独自の行に配置するには、行ターミネータに \r\n の組み合わせを指定します。

注
bcp を対話的に使用し、\n (改行) を行ターミネータとして指定すると、bcp によって自動的に \r (キャリッジ リターン) 文字が前に付加され、結果的には行ターミネータが \r\n になります。

一括エクスポートのターミネータの指定

char データまたは nchar データを一括エクスポートするときに、既定のターミネータ以外を使用する場合、bcp コマンドに対してターミネータを指定する必要があります。次のいずれかの方法で、ターミネータを指定できます。

• フォーマット ファイルで、フィールドごとにターミネータを指定します。

  注
  フォーマット ファイルの使用方法については、「データのインポートまたはエクスポート用のフォーマット ファイル」を参照してください。

• フォーマット ファイルを使用しない場合には、次の方法があります。

  • -t スイッチを使用して、行内の最後のフィールドを除くすべてのフィールドのフィールド ターミネータを指定します。および、-r スイッチを使用して、行ターミネータを指定します。

  • -t スイッチを指定しないで、文字形式のスイッチ (-c または -w) を使用すると、フィールド ターミネータがタブ文字 \t に設定されます。-t\t を指定した場合と同じです。

    注
    -n (ネイティブ データ) スイッチまたは -N (Unicode ネイティブ) スイッチを指定すると、ターミネータは挿入されません。

  • 対話的な bcp コマンドに、in オプションまたは out オプションが含まれていて、フォーマット ファイル スイッチ (-f) またはデータ形式スイッチ (-n、-c、-w、または -N) のいずれも含まれていない場合に、プレフィックス長とフィールド長の指定をしないと、各フィールドのフィールド ターミネータが要求されます。既定ではターミネータは "なし" になっています。

    Enter field terminator [none]:

    通常は、既定値を選択することをお勧めします。ただし、char データ フィールドまたは nchar データ フィールドについては、次の「ターミネータ使用のガイドライン」を参照してください。コンテキスト内でこのプロンプトが表示される例については、「bcp を使用した互換性のためのデータ形式の指定」を参照してください。

    注
    bcp コマンドですべてのフィールドを対話形式で指定すると、各フィールドへの応答を XML 形式以外のファイルに保存するように要求するプロンプトが表示されます。XML 以外のフォーマット ファイルの詳細については、「XML 以外のフォーマット ファイルについて」を参照してください。

ターミネータ使用のガイドライン

使用例

bcp AdventureWorks2008R2.HumanResources.Department out C:\myDepartment-c-t.txt -c -t, -r \n -T

bcp AdventureWorks2008R2.HumanResources.Department out C:\myDepartment-c-t.txt -c -t, -r \n -T

一括インポートのターミネータの指定

char データまたは nchar データを一括インポートするときに、一括インポート コマンドではデータ ファイルで使用されているターミネータが認識される必要があります。次のように、ターミネータの指定方法は一括インポート コマンドによって異なります。

• bcp

  インポート操作のターミネータの指定には、エクスポート操作と同じ構文を使用します。詳細については、このトピックの「一括エクスポートのターミネータの指定」を参照してください。

• BULK INSERT

  次の表に示す修飾子を使用して、フォーマット ファイル内の個別のフィールドまたはデータ ファイル全体にターミネータを指定できます。

  修飾子	説明
  FIELDTERMINATOR ='field_terminator'	文字データ ファイルや Unicode 文字データ ファイルに使用されるフィールド ターミネータを指定します。 既定値は \t (タブ文字) です。
  ROWTERMINATOR ='row_terminator'	文字データ ファイルや Unicode 文字データ ファイルに使用される行ターミネータを指定します。 既定値は \n (改行記号) です。

  詳細については、「BULK INSERT (Transact-SQL)」を参照してください。

• INSERT ...SELECT * FROM OPENROWSET(BULK...)

  OPENROWSET 一括行セット プロバイダーでは、ターミネータを指定できるのはフォーマット ファイルのみです (Large Object データ型を除き、これは必須です)。文字データ ファイルで既定以外のターミネータが使用されている場合、フォーマット ファイルで定義する必要があります。詳細については、「フォーマット ファイルの作成」および「データの一括インポートでのフォーマット ファイルの使用」を参照してください。

  OPENROWSET BULK 句の詳細については、「OPENROWSET (Transact-SQL)」を参照してください。

使用例

USE AdventureWorks2008R2;
GO
DROP TABLE myDepartment;
CREATE TABLE myDepartment 
(DepartmentID smallint,
Name nvarchar(50),
GroupName nvarchar(50) NULL,
ModifiedDate datetime not NULL CONSTRAINT DF_AddressType_ModifiedDate DEFAULT (GETDATE())
);
GO

USE AdventureWorks2008R2;
GO
DROP TABLE myDepartment;
CREATE TABLE myDepartment 
(DepartmentID smallint,
Name nvarchar(50),
GroupName nvarchar(50) NULL,
ModifiedDate datetime not NULL CONSTRAINT DF_AddressType_ModifiedDate DEFAULT (GETDATE())
);
GO

bcp AdventureWorks2008R2..myDepartment in C:\myDepartment-c-t.txt -c -t , -r \n -T

bcp AdventureWorks2008R2..myDepartment in C:\myDepartment-c-t.txt -c -t , -r \n -T

USE AdventureWorks2008R2;
GO
BULK INSERT myDepartment FROM 'C:\myDepartment-c-t.txt'
   WITH (
      DATAFILETYPE = 'char',
      FIELDTERMINATOR = ',',
      ROWTERMINATOR = '\n'
);
GO

USE AdventureWorks2008R2;
GO
BULK INSERT myDepartment FROM 'C:\myDepartment-c-t.txt'
   WITH (
      DATAFILETYPE = 'char',
      FIELDTERMINATOR = ',',
      ROWTERMINATOR = '\n'
);
GO

関連項目

参照

概念