フォーマットファイルの作成

[アーティクル]
12/16/2008

SQL Server テーブルにデータを一括インポートしたり、テーブルからデータを一括エクスポートする場合、フォーマットファイルを使用して、そのテーブルに関連するデータファイル内の各フィールドのフォーマット情報を格納できます。フォーマットファイルを使用すると、他のデータ形式に準拠したり、他のソフトウェアプログラムからデータファイルを読み取るための編集をほとんど (あるいはまったく) 行うことなく、データファイルを出力できる柔軟なシステムが実現します。

SQL Server 2005 では、XML 以外のフォーマットファイルと XML フォーマットファイルの 2 種類がサポートされます。XML 以外のフォーマットとは、以前のバージョンの SQL Server でサポートされる従来のフォーマットです。通常、SQL Server 2005 では XML フォーマットファイルと XML 以外のフォーマットファイルはどちらも使用できます。ただし、XML フォーマットファイルの方が XML 以外のフォーマットファイルよりも優れた点がいくつかあるので、新しいフォーマットファイルには XML 構文を使用することをお勧めします。詳細については、「フォーマットファイルの概要」を参照してください。

メモ :
フォーマットファイルの読み取りに使用される bcp ユーティリティ (Bcp.exe) のバージョンは、フォーマットファイルの作成に使用されたバージョン、またはそれ以降のバージョンである必要があります。たとえば、SQL Server 2005 bcp では、SQL Server 2000 bcp によって生成されるバージョン 8.0 のフォーマットファイルを読み取ることができますが、SQL Server 2000 bcp では、SQL Server 2005 bcp によって生成されるバージョン 9.0 のフォーマットファイルを読み取ることができません。

フォーマットファイルの読み取りに使用される bcp ユーティリティ (Bcp.exe) のバージョンは、フォーマットファイルの作成に使用されたバージョン、またはそれ以降のバージョンである必要があります。たとえば、SQL Server 2005 bcp では、SQL Server 2000 bcp によって生成されるバージョン 8.0 のフォーマットファイルを読み取ることができますが、SQL Server 2000 bcp では、SQL Server 2005 bcp によって生成されるバージョン 9.0 のフォーマットファイルを読み取ることができません。

このトピックでは、bcp ユーティリティを使用して、特定のテーブルのフォーマットファイルを作成する方法について説明します。フォーマットファイルは、指定されたデータの種類のオプション (-n、-c、-w、-6、または-N)、およびテーブルやビューの区切り記号から構成されます。

XML 以外のフォーマットファイルの作成

bcp コマンドを使用してフォーマットファイルを作成するには、format 引数を指定し、データファイルのパスの代わりに nul を使用します。format オプションには、次に示す -f オプションが必要です。

bcptable_or_viewformat nul -fformat_file_name

メモ :
XML 以外のフォーマットファイルであることを区別するには、MyTable.fmt のように、ファイル名拡張子として .fmt を使用することをお勧めします。

XML 以外のフォーマットファイルの構造およびフィールドについては、「XML 以外のフォーマットファイルについて」を参照してください。

例

ここでは、bcp コマンドを使用して XML 以外のフォーマットファイルを作成する方法を示す次の例について説明します。

A. ネイティブデータ用の XML 以外のフォーマットファイルの作成
B. 文字データ用の XML 以外のフォーマットファイルの作成
C. Unicode ネイティブデータ用の XML 以外のフォーマットファイルの作成
D. Unicode 文字データ用の XML 以外のフォーマットファイルの作成

この例では、AdventureWorks サンプルデータベースの HumanResources.Department テーブルを使用しています。HumanResources.Department テーブルには、DepartmentID、Name、GroupName、および ModifiedDate の 4 つの列があります。このテーブルの定義の詳細については、「Department テーブル (AdventureWorks)」を参照してください。

メモ :
Adventure Works Cycles は、データベースの概念とシナリオを説明するために使用する架空の製造会社です。

A. ネイティブデータ用の XML 以外のフォーマットファイルの作成

次の例では、AdventureWorks``HumanResources.Department テーブルに対して Department-n.xml という名前の XML フォーマットファイルを作成します。このフォーマットファイルでは、ネイティブデータ型が使用されます。生成されたフォーマットファイルの内容をコマンドの後に示します。

bcp コマンドには、次の修飾子が含まれます。

修飾子	説明
formatnul-fformat_file	XML 以外のフォーマットファイルを指定します。
-n	ネイティブデータ型を指定します。
-T	bcp ユーティリティが統合セキュリティを使用した信頼関係接続を使用して SQL Server に接続することを指定します。-T を指定しない場合、正常にログインするには、-U および -P を指定する必要があります。

Windows コマンドプロンプトで、次の bcp コマンドを入力します。

bcp AdventureWorks.HumanResources.Department format nul -T -n -f Department-n.fmt

生成されるフォーマットファイル Department-n.fmt には、次の情報が含まれます。

9.0
4
1       SQLSMALLINT   0       2       ""   1     DepartmentID                 ""
2       SQLNCHAR      2       100     ""   2     Name                         SQL_Latin1_General_CP1_CI_AS
3       SQLNCHAR      2       100     ""   3     GroupName                    SQL_Latin1_General_CP1_CI_AS
4       SQLDATETIME   0       8       ""   4     ModifiedDate                 ""

詳細については、「XML 以外のフォーマットファイルについて」を参照してください。

B. 文字データ用の XML 以外のフォーマットファイルの作成

次の例では、AdventureWorks``HumanResources.Department テーブルに対して Department.fmt という名前の XML フォーマットファイルを作成します。このフォーマットファイルでは、文字データ形式と、既定と異なるフィールドターミネータ (,) が使用されます。生成されたフォーマットファイルの内容をコマンドの後に示します。

bcp コマンドには、次の修飾子が含まれます。

修飾子	説明
formatnul-fformat_file	XML 以外のフォーマットファイルを指定します。
-c	文字データを指定します。
-T	bcp ユーティリティが統合セキュリティを使用した信頼関係接続を使用して SQL Server に接続することを指定します。-T を指定しない場合、正常にログインするには、-U および -P を指定する必要があります。

Windows コマンドプロンプトで、次の bcp コマンドを入力します。

bcp AdventureWorks.HumanResources.Department format nul -c -f Department-c.fmt -T

生成されるフォーマットファイル Department-c.fmt には、次の情報が含まれます。

9.0
4
1       SQLCHAR       0       7       "\t"     1     DepartmentID                 ""
2       SQLCHAR       0       100     "\t"     2     Name                         SQL_Latin1_General_CP1_CI_AS
3       SQLCHAR       0       100     "\t"     3     GroupName                    SQL_Latin1_General_CP1_CI_AS
4       SQLCHAR       0       24      "\r\n"   4     ModifiedDate                 ""

詳細については、「XML 以外のフォーマットファイルについて」を参照してください。

C. Unicode ネイティブデータ用の XML 以外のフォーマットファイルの作成

HumanResources.Department テーブルの、Unicode ネイティブデータ用の XML 以外のフォーマットファイルを作成するには、次のコマンドを使用します。

bcp AdventureWorks.HumanResources.Department format nul -T -N -f Department-n.fmt

Unicode ネイティブデータの使用方法の詳細については、「Unicode ネイティブ形式を使用したデータのインポートまたはエクスポート」を参照してください。

D. Unicode 文字データ用の XML 以外のフォーマットファイルの作成

既定のターミネータを使用する HumanResources.Department テーブルの、Unicode 文字データ用の XML 以外のフォーマットファイルを作成するには、次のコマンドを使用します。

bcp AdventureWorks.HumanResources.Department format nul -T -w -f Department-w.fmt

Unicode 文字データの使用方法の詳細については、「Unicode 文字形式を使用したデータのインポートまたはエクスポート」を参照してください。

XML フォーマットファイルの作成

bcp コマンドを使用してフォーマットファイルを作成するには、format 引数を指定し、データファイルのパスの代わりに nul を使用します。format オプションには常に -f オプションが必要です。XML フォーマットファイルを作成するには、次に示すように -x オプションも指定する必要があります。

bcptable_or_viewformat nul-fformat_file_name-x

メモ :
XML フォーマットファイルであることを区別するには、MyTable.xml のように、ファイル名拡張子として .xml を使用することをお勧めします。

XML フォーマットファイルの構造およびフィールドについては、「XML フォーマットファイルについて」を参照してください。

例

ここでは、bcp コマンドを使用して XML フォーマットファイルを作成する方法を示す次の例について説明します。

A. 文字データ用の XML フォーマットファイルの作成
B. ネイティブデータ用の XML フォーマットファイルの作成

メモ :
Adventure Works Cycles は、データベースの概念とシナリオを説明するために使用する架空の製造会社です。

A. 文字データ用の XML フォーマットファイルの作成

次の例では、AdventureWorks``HumanResources.Department テーブルに対して Department.xml という名前の XML フォーマットファイルを作成します。このフォーマットファイルでは、文字データ形式と、既定と異なるフィールドターミネータ (,) が使用されます。生成されたフォーマットファイルの内容をコマンドの後に示します。

bcp コマンドには、次の修飾子が含まれます。

修飾子

説明

formatnul-fformat_file-x

XML フォーマットファイルを指定します。

-c

文字データを指定します。

-t,

コンマ (,) をフィールドターミネータとして指定します。

ms191516.note(ja-jp,SQL.90).gif メモ :

データファイルで既定のフィールドターミネータ (\t) が使用されている場合、-t スイッチは不要です。

-T

bcp ユーティリティが統合セキュリティを使用した信頼関係接続を使用して SQL Server に接続することを指定します。-T を指定しない場合、正常にログインするには、-U および -P を指定する必要があります。

Windows コマンドプロンプトで、次の bcp コマンドを入力します。

bcp AdventureWorks.HumanResources.Department format nul -c -x -f Department-c..xml –t, -T

生成されるフォーマットファイル Department-c.xml には、次の XML 要素が含まれます。

<?xml version="1.0"?>
<BCPFORMAT xmlns="https://schemas.microsoft.com/sqlserver/2004/bulkload/format" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <RECORD>
  <FIELD ID="1" xsi:type="CharTerm" TERMINATOR="," MAX_LENGTH="7"/>
  <FIELD ID="2" xsi:type="CharTerm" TERMINATOR="," MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
  <FIELD ID="3" xsi:type="CharTerm" TERMINATOR="," MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
  <FIELD ID="4" xsi:type="CharTerm" TERMINATOR="\r\n" MAX_LENGTH="24"/>
 </RECORD>
 <ROW>
  <COLUMN SOURCE="1" NAME="DepartmentID" xsi:type="SQLSMALLINT"/>
  <COLUMN SOURCE="2" NAME="Name" xsi:type="SQLNVARCHAR"/>
  <COLUMN SOURCE="3" NAME="GroupName" xsi:type="SQLNVARCHAR"/>
  <COLUMN SOURCE="4" NAME="ModifiedDate" xsi:type="SQLDATETIME"/>
 </ROW>
</BCPFORMAT>

このフォーマットファイルの構文については、「XML フォーマットファイルのスキーマ構文」を参照してください。文字データについては、「文字形式を使用したデータのインポートまたはエクスポート」を参照してください。

B. ネイティブデータ用の XML フォーマットファイルの作成

bcp コマンドには、次の修飾子が含まれます。

修飾子	説明
formatnul-fformat_file-x	XML フォーマットファイルを指定します。
-n	ネイティブデータ型を指定します。
-T	bcp ユーティリティが統合セキュリティを使用した信頼関係接続を使用して SQL Server に接続することを指定します。-T を指定しない場合、正常にログインするには、-U および -P を指定する必要があります。

Windows コマンドプロンプトで、次の bcp コマンドを入力します。

bcp AdventureWorks.HumanResources.Department format nul -x -f Department-n..xml -n -T

生成されるフォーマットファイル Department-n.xml には、次の XML 要素が含まれます。

<?xml version="1.0"?>
<BCPFORMAT xmlns="https://schemas.microsoft.com/sqlserver/2004/bulkload/format" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <RECORD>
  <FIELD ID="1" xsi:type="NativeFixed" LENGTH="2"/>
  <FIELD ID="2" xsi:type="NCharPrefix" PREFIX_LENGTH="2" MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
  <FIELD ID="3" xsi:type="NCharPrefix" PREFIX_LENGTH="2" MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
  <FIELD ID="4" xsi:type="NativeFixed" LENGTH="8"/>
 </RECORD>
 <ROW>
  <COLUMN SOURCE="1" NAME="DepartmentID" xsi:type="SQLSMALLINT"/>
  <COLUMN SOURCE="2" NAME="Name" xsi:type="SQLNVARCHAR"/>
  <COLUMN SOURCE="3" NAME="GroupName" xsi:type="SQLNVARCHAR"/>
  <COLUMN SOURCE="4" NAME="ModifiedDate" xsi:type="SQLDATETIME"/>
 </ROW>
</BCPFORMAT>

このフォーマットファイルの構文については、「XML フォーマットファイルのスキーマ構文」を参照してください。ネイティブデータの使用方法については、「ネイティブ形式を使用したデータのインポートまたはエクスポート」を参照してください。

データフィールドからテーブル列へのマッピング

bcp によって作成されたフォーマットファイルには、すべてのテーブル列が順番に記述されます。テーブル行を再配置または削除する場合は、フォーマットファイルを変更できます。その結果、フィールドとテーブル列とが直接マップされないデータファイル用に、フォーマットファイルをカスタマイズできます。詳細については、次のトピックを参照してください。

参照

次の方法で共有

フォーマットファイルの作成

XML 以外のフォーマットファイルの作成

例

A. ネイティブデータ用の XML 以外のフォーマットファイルの作成

B. 文字データ用の XML 以外のフォーマットファイルの作成

C. Unicode ネイティブデータ用の XML 以外のフォーマットファイルの作成

D. Unicode 文字データ用の XML 以外のフォーマットファイルの作成

XML フォーマットファイルの作成

例

A. 文字データ用の XML フォーマットファイルの作成

B. ネイティブデータ用の XML フォーマットファイルの作成

データフィールドからテーブル列へのマッピング

参照

概念

その他の技術情報

ヘルプおよび情報

その他のリソース

次の方法で共有

フォーマット ファイルの作成

XML 以外のフォーマット ファイルの作成

例

A. ネイティブ データ用の XML 以外のフォーマット ファイルの作成

B. 文字データ用の XML 以外のフォーマット ファイルの作成

C. Unicode ネイティブ データ用の XML 以外のフォーマット ファイルの作成

D. Unicode 文字データ用の XML 以外のフォーマット ファイルの作成

XML フォーマット ファイルの作成

例

A. 文字データ用の XML フォーマット ファイルの作成

B. ネイティブ データ用の XML フォーマット ファイルの作成

データ フィールドからテーブル列へのマッピング

参照

概念

その他の技術情報

ヘルプおよび情報

その他のリソース

フォーマットファイルの作成

XML 以外のフォーマットファイルの作成

A. ネイティブデータ用の XML 以外のフォーマットファイルの作成

B. 文字データ用の XML 以外のフォーマットファイルの作成

C. Unicode ネイティブデータ用の XML 以外のフォーマットファイルの作成

D. Unicode 文字データ用の XML 以外のフォーマットファイルの作成

XML フォーマットファイルの作成

A. 文字データ用の XML フォーマットファイルの作成

B. ネイティブデータ用の XML フォーマットファイルの作成

データフィールドからテーブル列へのマッピング