bcp ユーティリティ

[アーティクル]
10/27/2017

bcp ユーティリティは、Microsoft SQL Server のインスタンスとユーザー指定の形式でデータファイルの間でデータを一括コピーします。 bcp ユーティリティを使うと、多数の新規行を SQL Server テーブルにインポートしたり、データをテーブルからデータファイルにエクスポートしたりできます。このユーティリティでは Transact-SQL の知識は必要ありません。ただし、queryout オプションと同時に使う場合はその知識が必要になります。データをテーブルにインポートするには、そのテーブル用に作成されたフォーマットファイルを使用するか、テーブルの構造およびテーブルの列に有効なデータの型を理解しておく必要があります。

トピックリンクアイコン bcp 構文に使用される構文規則については、「Transact-SQL 構文規則 (Transact-SQL)を参照してください。

Note

bcp を使ってデータをバックアップする場合、フォーマットファイルを作成してデータ形式を記録します。 bcp データファイルには、スキーマ情報やフォーマット情報が含まれないので、テーブルまたはビューが削除され、フォーマットファイルがない場合は、データをインポートできないことがあります。

構文

  
   bcp [database_name.] schema.{table_name | view_name | "query" {indata_file | outdata_file | queryoutdata_file | format nul}  
  
[-apacket_size]  
[-bbatch_size]  
[-c]  
[-C { ACP | OEM | RAW | code_page } ]  
[-ddatabase_name]  
[-eerr_file]  
[-E]  
[-fformat_file]  
[-Ffirst_row]  
[-h"hint [,...n]"]   
[-iinput_file]  
[-k]  
[-Kapplication_intent]  
[-Llast_row]  
[-mmax_errors]  
[-n]  
[-N]  
[-ooutput_file]  
[-Ppassword]  
[-q]  
[-rrow_term]  
[-R]  
[-S [server_name[\instance_name]]  
[-tfield_term]  
[-T]  
[-Ulogin_id]  
[-v]  
[-V (80 | 90 | 100 | 110)]  
[-w]  
[-x]  
/?

引数

data_file
データファイルの完全パスを指定します。 SQL Serverにデータを一括インポートする場合は、データファイルには指定したテーブルまたはビューにコピーするデータが含まれます。 SQL Serverからデータを一括エクスポートする場合は、データファイルにはテーブルまたはビューからコピーしたデータが含まれます。パスは、1 文字から 255 文字までです。データファイルに含めることができる行の数は最大 2⁶³ - 1 です。

database_name
指定したテーブルまたはビューを含むデータベースの名前を指定します。指定しない場合は、ユーザーの既定データベースになります。

d- で明示的にデータベース名を指定することもできます。

in data_file | outdata_file | queryoutdata_file | format nul
次に示すように、一括コピーの方向を指定します。

in はファイルからデータベーステーブルまたはビューへのコピーを行います。
out はデータベーステーブルまたはビューからファイルへのコピーを行います。既存のファイルを指定すると、ファイルは上書きされます。 bcp ユーティリティは、データを抽出するときに、空文字列を NULL 文字列で、NULL 文字列を空文字列で表すことに注意してください。
queryout はクエリからのコピーを行います。データをクエリから一括コピーする場合にのみ指定する必要があります。
format は、指定されたオプション (-n、 -c、 -w、または -N) とテーブルまたはビューの区切り記号に基づいてフォーマットファイルを作成します。データを一括コピーするとき、 bcp コマンドはフォーマットファイルを参照することができるため、フォーマット情報を対話的に再入力する必要がなくなります。 format オプションには -f オプションが必要です。XML フォーマットファイルを作成する場合には、 -x オプションも必要です。詳細については、「フォーマットファイルの作成 (SQL Server)」を参照してください。値として nul を指定する必要があります (format nul)。

owner
テーブルまたはビューの所有者の名前を指定します。操作を実行するユーザーが指定のテーブルまたはビューを所有している場合、owner は省略可能です。 所有者が指定されておらず、操作を実行しているユーザーが指定したテーブルまたはビューを所有していない場合、SQL Server はエラーメッセージを返し、操作は取り消されます。

" query "
結果セットを返す Transact-SQL クエリです。クエリから複数の結果セットが返される場合、最初の結果セットのみがデータファイルにコピーされ、それ以降の結果セットは無視されます。クエリは二重引用符で、クエリに埋め込まれたものは単一引用符で囲みます。クエリからデータを一括コピーする場合には、queryout も指定する必要があります。

ストアドプロシージャ内で参照されるテーブルのすべてが bcp ステートメントの実行前に存在する場合に限り、クエリはストアドプロシージャを参照できます。たとえば、ストアドプロシージャにより一時テーブルが生成される場合、この一時テーブルは実行時にだけ利用でき、ステートメントの実行時には利用できないため、 bcp ステートメントは失敗します。このような場合、ストアドプロシージャの結果をテーブルに挿入し、 bcp を使用してテーブルからデータファイルにデータをコピーすることを検討してください。

table_name
データを SQL Server にインポートする (in) 場合はインポート先のテーブルの名前、データを SQL Server からエクスポートする (out) 場合はエクスポート元のテーブルの名前です。

view_name
データを SQL Server にコピーする (in) 場合はコピー先のビューの名前、データを SQL Server からコピーする (out) 場合はコピー元のビューの名前です。すべての列が同じテーブルを参照しているビューのみが、コピー先のビューとして使用できます。ビューにデータをコピーするときの制限の詳細については、「INSERT (Transact-SQL)」を参照してください。

-a packet_size
サーバーとの間で送信されるネットワークパケットごとのバイト数を指定します。サーバー構成オプションは、SQL Server Management Studio (または sp_configure システムストアドプロシージャ) を使用して設定できます。ただし、このオプションを使用すると、サーバー構成オプションを個別にオーバーライドできます。 packet_size の有効値は 4,096 から 65,535 バイトです。既定値は 4,096 です。

パケットサイズを大きくすると、一括コピーのパフォーマンスを向上させることができます。より大きなサイズのパケットを要求しても、許可されない場合、既定値が使用されます。 bcp ユーティリティが生成するパフォーマンス統計には、使用したパケットサイズが示されます。

-b batch_size
一括インポートするデータの行数を指定します。コミットされる前に、各バッチはすべてのバッチをインポートする個別のトランザクションとしてインポートおよび記録されます。既定では、データファイルのすべての行が 1 つのバッチとしてインポートされます。複数のバッチに行を分散するには、データファイルの行数よりも少ない batch_size を指定します。バッチのトランザクションが失敗すると、現在のバッチの挿入のみがロールバックされます。コミットされたトランザクションによって既にインポートされているバッチは、それ以降の失敗による影響を受けません。

このオプションは、**-h"**ROWS_PER_BATCH =bb" オプションと組み合わせて使用しないでください。

-c
文字データ型を使用して操作を実行します。このオプションは、各フィールドに対してプロンプトを表示しません。 char をストレージの種類として使用し、プレフィックスを使用せず、フィールド区切り記号として \t (タブ文字) を使用し、行ターミネータとして \r\n (改行文字) を使用します。 -c と -w には互換性がありません。

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

-C { ACP | OEM | RAW | code_page }
データファイル内のデータのコードページを指定します。 code_page は、文字値が 127 より大きいか、32 未満の char、 varchar、または text 列がデータに含まれている場合にのみ関連します。

Note

フォーマットファイルの各列に対して照合順序名を指定することをお勧めします。

コードページ値	説明
ACP	ANSI/Microsoft Windows (ISO 1252)。
OEM	クライアントが使用する既定のコードページです。 -C が指定されていない場合に使用される既定のコードページです。
RAW	コードページの変換は行われません。したがって、これは最も速いオプションです。
code_page	850 などの特定のコードページ番号を指定します。重要 SQL Server はコードページ 65001 (UTF-8 エンコード) をサポートしていません。

-ddatabase_name
接続先のデータベースを指定します。既定では、bcp.exe はユーザーの既定のデータベースに接続します。 -ddatabase_nameと 3 つの部分名 (bcp.exeの最初のパラメーターとして渡されるdatabase_name.schema.table) を指定すると、データベース名を 2 回指定できないため、エラーが発生します。database_nameハイフン (-) またはスラッシュ (/) で始まる場合は、-dとデータベース名の間にスペースを追加しないでください。

-e err_file
bcp ユーティリティがファイルからデータベースに転送できなかったすべての行を格納するエラーファイルの完全パスを指定します。 bcp コマンドからのエラーメッセージは、ユーザーのワークステーションに送られます。このオプションを指定しないと、エラーファイルは作成されません。

err_file がハイフン (-) またはスラッシュ (/) で始まる場合は、 -e と err_file 値の間に空白を入れないでください。

-E
インポートしたデータファイルの ID 値 (複数可) を ID 列に使用することを指定します。 -E を指定しない場合、インポートされるデータファイルのこの列の ID 値は無視され、 SQL Server はテーブルの作成時に指定されたシードと増分の値に基づいて一意の値を自動的に割り当てます。

データファイルにテーブルまたはビュー内の ID 列の値が含まれない場合は、フォーマットファイルを使用して、データのインポート時にテーブルまたはビュー内の ID 列を無視するように指定します。 SQL Server では、一意な値が自動的にこの列に割り当てられます。詳細については、「DBCC CHECKIDENT (Transact-SQL)」をご覧ください。

-E オプションには、特別な権限が必要です。詳細については、後の「解説」を参照してください。

-f format_file
フォーマットファイルの完全パスを指定します。このオプションの意味は、オプションが使用されている環境によって次のように異なります。

-f を format オプションと共に使用した場合、指定されたテーブルまたはビューに対して、指定された format_file が作成されます。 XML フォーマットファイルを作成するには、 -x オプションも指定します。詳細については、「フォーマットファイルの作成 (SQL Server)」を参照してください。
in または out オプションと共に使用する場合、 -f を使うには既存のフォーマットファイルが必要です。

Note

in または out オプションを使う場合、フォーマットファイルは省略可能です。 -fオプションがない場合、-n、-c、-w、または-Nが指定されていない場合、コマンドはフォーマット情報を求めるプロンプトを表示し、応答をフォーマットファイル (既定のファイル名は Bcp.fmt) に保存できます。

format_file がハイフン (-) またはスラッシュ (/) で始まる場合は、 -f と format_file 値の間に空白を入れないでください。

-F first_row
テーブルからエクスポートする最初の行、またはデータファイルからインポートする最初の行の番号を指定します。このパラメーターには、0 より大きく (> 0)、行の合計数以下 (< または =) となる値が必要です。このパラメーターがない場合、既定ではファイルの最初の行となります。

first_row には、2^63-1 以下の正の整数を指定できます。 -Ffirst_row は 1 から始まります。

-h" hint[ ,... n] "
データをテーブルまたはビューに一括インポートするときに使用するヒントを指定します。

ORDER**(column[ASC |DESC] [,...n])**
データファイルのデータの並べ替え順序です。インポートするデータをテーブル上のクラスター化インデックスに従って並べ替えると、一括インポートのパフォーマンスが向上します。データファイルが異なる順序で並べ替えられている場合、つまり、クラスター化インデックスキーの順序以外で並べ替えられている場合、またはテーブルにクラスター化インデックスが存在しない場合、ORDER 句は無視されます。指定する列の名前は、インポート先のテーブル内で有効な列の名前であることが必要です。既定では、 bcp はデータファイルの並べ替えが行われていないことを前提としています。最適な一括インポートのため、 SQL Server では、インポートするデータが並べ替えられているかどうかも検証されます。

ROWS_PER_BATCH =bb
各バッチあたりのデータ行数 ( bb) です。 -b を指定しない場合に使うと、データファイル全体が 1 つのトランザクションとしてサーバーに送られます。サーバーは、 bbの値に応じて一括コピーの負荷を最適化します。 ROWS_PER_BATCH の既定値はありません。

KILOBYTES_PER_BATCH = cc
バッチごとのデータの概算キロバイト数 (KB) です ( cc)。 KILOBYTES_PER_BATCH の既定値はありません。

TABLOCK
一括読み込み操作中に一括更新のテーブルレベルのロックが適用されます。これを指定しない場合、行レベルのロックが適用されます。一括コピー操作時だけロックすることにより、テーブルロックの競合が少なくなるので、このヒントはパフォーマンスを大幅に向上させます。テーブルにインデックスがなく、 TABLOCK を指定した場合は、複数のクライアントで同時に 1 つのテーブルを読み込むことができます。既定では、ロック動作はテーブルオプション table lock on bulk loadによって決定されます。

CHECK_CONSTRAINTS
一括インポート操作中、対象テーブルまたはビューに対するすべての制約を検証します。 CHECK_CONSTRAINTS ヒントを指定しない場合、CHECK 制約および FOREIGN KEY 制約は無視され、操作の後でテーブルの制約は信頼されていないものとしてマークされます。

Note

UNIQUE、PRIMARY KEY、および NOT NULL 制約は常に適用されます。

テーブル全体の制約は、任意の時点で必ず検証してください。一括インポート操作の前にテーブルが空でなかった場合、制約を再検証するコストは、増分データに CHECK 制約を適用するコストを超える場合があります。したがって、通常は、増分一括インポート時の制約チェックを有効にすることをお勧めします。

入力データに制約違反の行が含まれている場合などは、制約を無効 (既定の動作) にできます。 CHECK 制約を無効にした場合、データをインポートした後で、Transact-SQL ステートメントを使用して無効なデータを削除できます。

Note

bcp によってデータ検証とデータチェックが実行されるようになったため、無効なデータを含むデータファイルに対して実行した場合、このスクリプトは失敗する可能性があります。

Note

-m max_errors スイッチは、制約チェックには適用されません。

FIRE_TRIGGERS
in 引数と共に指定されている場合、一括コピーの操作時に、コピー先のテーブル上で定義されている挿入トリガーを実行します。 FIRE_TRIGGERS が指定されていない場合は、挿入トリガーは実行されません。 FIRE_TRIGGERS は、 out引数、 queryout引数、および format 引数では無視されます。

-i input_file
対話型モード (-n、 -c、 -w、または -N) を使用して一括コピーを実行するときに、各データフィールドのコマンドプロンプトの質問に対する応答を含む応答ファイルの名前 指定します。

input_file がハイフン (-) またはスラッシュ (/) で始まる場合は、 -i と input_file 値の間に空白を入れないでください。

-k
一括コピー操作時、空の列には、挿入される列の既定値ではなく、NULL 値が保持されます。詳細については、「一括インポート中の NULL の保持または既定値の使用 (SQL Server)」を参照してください。

-K application_intent
アプリケーションがサーバーに接続するときのワークロードのタイプを宣言します。指定できる値は、 ReadOnlyだけです。 -K を指定しない場合、bcp ユーティリティでは AlwaysOn 可用性グループのセカンダリレプリカへの接続がサポートされません。詳細については、「アクティブなセカンダリ: 読み取り可能なセカンダリレプリカ (AlwaysOn 可用性グループ)」を参照してください。

-L last_row
テーブルからエクスポートする最後の行、またはデータファイルからインポートする最後の行の番号を指定します。このパラメーターには、0 より大きく (> 0)、最後の行の番号以下 (< または =) となる値が必要です。このパラメーターがない場合、既定ではファイルの最後の行となります。

last_row には、2^63-1 以下の正の整数を指定できます。

-m max_errors
bcp 操作が取り消される前に発生可能な構文エラーの最大数を指定します。構文エラーは、対象となるデータ型へのデータの変換エラーを意味しています。 max_errors の合計では、制約違反など、サーバーでのみ検出できるエラーはすべて対象外となります。

bcp ユーティリティでコピーできない行は無視され、1 つのエラーとしてカウントされます。このオプションが指定されない場合の既定値は 10 になります。

Note

-m オプションは、moneyまたはbigintデータ型の変換にも適用されません。

-n
データのネイティブ (データベース) データ型を使用して一括コピー操作を実行します。このオプションを使用すると、フィールドごとにプロンプトが表示されません。ネイティブ値が使用されます。

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

-N
文字以外のデータについてはデータベースのネイティブなデータ型を使用し、文字データについては Unicode 文字を使用して、一括コピー操作を実行します。 -w オプションの代わりにこのオプションを使用すると、高いパフォーマンスが得られます。このオプションは、データファイルを使用して SQL Server のインスタンスから別のインスタンスにデータを転送する場合に使用します。フィールドごとにプロンプトは表示されません。 ANSI 拡張文字を含むデータを転送し、ネイティブモードのパフォーマンスを利用する場合は、このオプションを使用します。

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

-N でbcp.exeを使用して同じテーブルスキーマにデータをエクスポートしてインポートすると、固定長の Unicode 以外の文字列 (char(10) など) がある場合、切り捨て警告が表示されることがあります。

この警告は、無視してもかまいません。この警告を解決するには、 -N ではなく -nを使用する方法があります。

-o output_file
コマンドプロンプトからリダイレクトされた出力を受け取るファイル名を指定します。

output_file がハイフン (-) またはスラッシュ (/) で始まる場合は、 -o と output_file 値の間に空白を入れないでください。

-P password
ログイン ID のパスワードを指定します。このオプションを指定しない場合、 bcp コマンドによってパスワードが要求されます。また、このオプションをコマンドプロンプトの最後にパスワードなしで使用すると、 bcp では既定のパスワード (NULL) が使用されます。

重要

空白のパスワードは使用しないでください。強力なパスワードを使用してください。

パスワードをマスクする場合は、 -P オプションを -U オプションと共に指定しないでください。 bcp を -U オプションおよび他のスイッチと共に指定した後 ( -Pは指定しない)、Enter キーを押すと、このコマンドによってパスワードが要求されます。この方法を使用すると、入力時にパスワードが確実にマスクされます。

password がハイフン (-) またはスラッシュ (/) で始まる場合は、 -P と password 値の間に空白を入れないでください。

-q
bcp ユーティリティと SQL Serverのインスタンス間の接続で、SET QUOTED_IDENTIFIERS ON ステートメントを実行します。名前に空白や単一引用符が含まれるデータベース、所有者、テーブル、またはビューを指定する場合に、このオプションを使用します。 3 つの要素から成るテーブル名またはビュー名全体を、二重引用符 (" ") で囲みます。

空白や単一引用符を含むデータベース名を指定するには、 -q オプションを使用する必要があります。

-q は、-d に渡される値には適用されません。

詳細については、後の「解説」を参照してください。

-r row_term
行ターミネータを指定します。既定値は \n (改行文字) です。既定の行ターミネータをオーバーライドする場合、このパラメーターを使用します。詳細については、「フィールドターミネータと行ターミネータの指定 (SQL Server)」を参照してください。

bcp.exe コマンドでは、行ターミネータを 16 進数表記で指定すると、値が 0x00 で切り捨てられます。たとえば、0x410041 を指定した場合、使用されるのは 0x41 になります。

row_term がハイフン (-) またはスラッシュ (/) で始まる場合は、 -r と row_term 値の間に空白を入れないでください。

-R
通貨、日付、時刻のデータを SQL Server に一括コピーする場合に、クライアントコンピューターのロケール設定に定義された地域別設定が使用されます。既定の設定では、地域別設定は無視されます。

-S server_name[ \instance_name]
接続先となる SQL Server のインスタンスを指定します。サーバーを指定しない場合、 bcp ユーティリティは、ローカルコンピューター上の SQL Server の既定のインスタンスに接続されます。ネットワーク上のリモートコンピューターまたはローカルの名前付きインスタンスから bcp コマンドを実行するときは、このオプションが必要です。サーバー上にある SQL Server の既定のインスタンスに接続するには、 server_nameのみを指定します。 SQL Server の名前付きインスタンスに接続するには、server_name*\*instance_name を指定します。

-tfield_term
フィールドターミネータを指定します。既定値は \t (タブ文字) です。既定のフィールドターミネータをオーバーライドする場合、このパラメーターを使用します。詳細については、「フィールドターミネータと行ターミネータの指定 (SQL Server)」を参照してください。

bcp.exe コマンドでは、フィールドターミネータを 16 進数表記で指定すると、値が 0x00 で切り捨てられます。たとえば、0x410041 を指定した場合、使用されるのは 0x41 になります。

field_termハイフン (-) またはスラッシュ (/) で始まる場合は、-tとfield_term値の間にスペースを含めないでください。

-T
bcp ユーティリティが統合セキュリティを使用した信頼関係接続を使用して SQL Server に接続することを指定します。ネットワークユーザーのセキュリティ資格情報である login_idおよび password は必要ありません。 -T を指定しない場合、正常にログインするには -U と -P を指定する必要があります。

-U login_id
SQL Serverへの接続に使用されるログイン ID を指定します。

重要

bcp ユーティリティが、統合セキュリティを使用したセキュリティ接続で SQL Server に接続している場合は、 user name と password の組み合わせではなく、 -T オプション (セキュリティ接続) を使用します。

-v
bcp ユーティリティのバージョン番号と著作権に関する情報を報告します。

-V (80 | 90 | 100| 110)
以前のバージョンの SQL Serverのデータ型を使用して一括コピー操作を実行します。このオプションを使用すると、フィールドごとにプロンプトが表示されません。既定値が使用されます。

80 = SQL Server 2000

90 = SQL Server 2005

100 = SQL Server 2008 および SQL Server 2008 R2

110 = SQL Server 2012

たとえば、SQL Server 2000 ではサポートされていないが、新しいバージョンの SQL Server で導入された型のデータを生成するには、-V80 オプションを使用します。

詳細については、「以前のバージョンの SQL Server からのネイティブ形式データおよび文字形式データのインポート」をご覧ください。

-w
Unicode 文字を使用して一括コピー操作を実行します。このオプションは、各フィールドに対してプロンプトを表示しません。 nchar をストレージの種類として使用し、プレフィックスなし、フィールド区切り記号として \t (タブ文字)、行終端記号として \n (改行文字) を使用します。 -w と -c には互換性がありません。

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

-x
format および -fformat_file オプションと共に使用し、既定の XML ではないフォーマットファイルの代わりに XML ベースのフォーマットファイルを生成します。 -x はデータのインポート時とエクスポート時には機能しません。 format および -fformat_file の両方を指定せずに使用すると、エラーが生成されます。

解説

bcp 12.0 クライアントは、MicrosoftSQL Server 2014 ツールをインストールするときにインストールされます。 SQL Server 2014 と以前のバージョンの SQL Server の両方にツールがインストールされている場合は、PATH 環境変数の値に応じて、bcp 12.0 クライアントではなく、以前の bcp クライアントを使用している可能性があります。この環境変数によって Windows で実行可能ファイルを探すときに使用されるディレクトリのセットが定義されます。使用しているバージョンを確認するには、Windows のコマンドプロンプトで bcp /v コマンドを実行します。コマンドパスを PATH 環境変数で設定する方法の詳細については、Windows のヘルプを参照してください。

XML フォーマットファイルは SQL Server ツールが SQL Server Native Client と共にインストールされている場合のみサポートされます。

bcp ユーティリティのある場所や、実行する方法、コマンドプロンプトユーティリティの構文規則については、「コマンドプロンプトユーティリティリファレンス (データベースエンジン)」を参照してください。

データを一括インポートまたはエクスポート用に準備する方法については、「一括エクスポートまたは一括インポートのデータの準備 (SQL Server)」を参照してください。

一括インポートによって実行される行挿入操作がトランザクションログに記録される条件について詳しくは、「一括インポートで最小ログ記録を行うための前提条件」をご覧ください。

ネイティブデータファイルのサポート

SQL Server 2014 では、 bcp ユーティリティは、SQL Server 2000、SQL Server 2005、SQL Server 2008、SQL Server 2008 R2、および SQL Server 2012 と互換性のあるネイティブデータファイルをサポートします。

計算列とタイムスタンプ列

計算列または timestamp 列に対してインポートされるデータファイル内の値は無視され、SQL Server によって自動的に値が割り当てられます。データファイルにテーブル内の計算列または timestamp 列の値が含まれていない場合は、フォーマットファイルを使用して、データのインポート時にテーブル内の計算列または timestamp 列をスキップするように指定します。SQL Server では、列の値が自動的に割り当てられます。

計算列と timestamp 列は、通常どおり SQL Server からデータファイルに一括コピーされます。

空白や引用符を含む識別子の指定

SQL Server 識別子には、空白や引用符などを埋め込むことができます。これらの識別子は次のように扱う必要があります。

コマンドプロンプトで空白や引用符を含む識別子またはファイル名を指定する場合、識別子を二重引用符 (" ") で囲みます。

たとえば、次の bcp out コマンドでは、 Currency Types.datという名前のデータファイルが作成されます。
```
bcp AdventureWorks2012.Sales.Currency out "Currency Types.dat" -T -c  
```
空白や引用符を含むデータベース名を指定するには、-q オプションを使用する必要があります。
空白文字や引用符を含んでいる所有者、テーブル、またはビューの名前については、次のうちのいずれかを行うことができます。
- -q オプションを指定します。
- 所有者名、テーブル名、またはビュー名を、引用符内でかっこ ([ ]) を使用して囲みます。

データ検証

bcp によってデータ検証とデータチェックが実行されるようになったため、無効なデータを含むデータファイルに対して実行した場合、このスクリプトは失敗する可能性があります。たとえば、 bcp では次の検証が行われます。

float データ型と real データ型のネイティブ表記が有効かどうか。
Unicode データが偶数バイト長かどうか。

以前のリリースでは、クライアントが無効なデータにアクセスを試みるまでは失敗が発生することはありませんでしたが、以前のバージョンの SQL Server で一括インポート可能であった無効な形式のデータが、新しいバージョンでは読み込みに失敗する場合があります。今回のリリースでは検証機能が追加されたため、一括読み込み後のクエリで発生する問題を最小限に抑えられます。

SQLXML ドキュメントの一括エクスポートまたは一括インポート

SQLXML データを一括エクスポートまたは一括インポートする場合、フォーマットファイルのデータ型には次のいずれかを使用します。

データ型	結果
SQLCHAR または SQLVARYCHAR	データは、クライアントコードページまたは照合順序で暗黙的に指定されるコードページで送られます。結果は、フォーマットファイルを指定せずに、`-c` スイッチを指定した場合と同じです。
SQLNCHAR または SQLNVARCHAR	データは Unicode として送られます。結果は、フォーマットファイルを指定せずに、`-w` スイッチを指定した場合と同じです。
SQLBINARY または SQLVARYBIN	データは変換なしで送られます。

アクセス許可

bcpout 操作には、ソーステーブルでの SELECT 権限が必要です。

bcpin 操作には、対象となるテーブルでの SELECT/INSERT 権限が最低限必要となります。また、次のうちのいずれかに該当する場合は、ALTER TABLE 権限が必要です。

制約が存在するため、CHECK_CONSTRAINTS ヒントを指定しません。

Note

制約の無効化は既定の動作です。制約を明示的に有効にするには、CHECK_CONSTRAINTS ヒントと共に -h オプションを使用します。
トリガーが存在するため、FIRE_TRIGGER ヒントを指定しません。

Note

既定では、トリガーは起動しません。トリガーを明示的に起動するには、FIRE_TRIGGERS ヒントと共に -h オプションを使用します。
-E オプションを使用して、データファイルから ID 値をインポートします。

Note

ターゲットテーブルに対する ALTER TABLE 権限の要求は、SQL Server 2005 の新機能でした。この新しい要件により、対象テーブルでの ALTER TABLE 権限がユーザーアカウントに与えられていないと、トリガーおよび制約チェックを実行しない bcp スクリプトは失敗する可能性があります。

キャラクターモード (-c) およびネイティブモード (-n) のベストプラクティス

このセクションでは、キャラクターモード (-c) およびネイティブモード (-n) の推奨事項について説明します。

(管理者/ユーザー) 可能であれば、ネイティブ形式 (-n) を使用して、区切り記号の問題を回避します。 SQL Serverを使用してエクスポートおよびインポートを行うには、ネイティブ形式を使用します。データを SQL Server 以外のデータベースにインポートする場合は、データをSQL Server からエクスポートするときに -c または -w オプションを使用します。
(管理者) BCP OUT を使用するときに、データを検証します。たとえば、BCP OUT、BCP IN、その後 BCP OUT を使用する場合、データが正しくエクスポートされ、ターミネータ値がデータ値の一部として使用されていないことを確認します。ターミネータ値とデータ値の競合を回避するために、-t および -r オプションを使用して、既定のターミネータ値をランダムな 16 進数値でオーバーライドすることを検討してください。
(ユーザー) 実際の文字列値と競合する可能性を最小限に抑えるために、長くて一意のターミネータ (バイトまたはキャラクターの任意のシーケンス) を使用します。これには、-t および -r オプションを使用します。

例

このセクションには、次の例が含まれています。

A. データファイルへのテーブル行のコピー (セキュリティ接続を使用)
B. データファイルへのテーブル行のコピー (混合モード認証を使用)
C: ファイルからテーブルへのデータのコピー
D. データファイルへの特定の列のコピー
E. データファイルへの特定の行のコピー
F. クエリからデータファイルへのデータのコピー
G. XML 以外のフォーマットファイルの作成
H. XML フォーマットファイルの作成
I. フォーマットファイルを使用した bcpでの一括インポート

A. データファイルへのテーブル行のコピー (セキュリティ接続を使用)

次の例では、AdventureWorks2012.Sales.Currencyテーブルに対して out オプションを実行します。 Currency.dat という名前のデータファイルを作成し、文字形式を使用してテーブルのデータをこのデータファイルにコピーします。この例では、Windows 認証を使用していること、および bcp コマンドを実行しているサーバーインスタンスへのセキュリティ接続があることを前提としています。

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

bcp AdventureWorks2012.Sales.Currency out Currency.dat -T -c

B. データファイルへのテーブル行のコピー (混合モード認証を使用)

次の例では、AdventureWorks2012.Sales.Currencyテーブルに対して out オプションを実行します。 Currency.dat という名前のデータファイルを作成し、文字形式を使用してテーブルのデータをこのデータファイルにコピーします。

この例では、混合モード認証を使用していることを前提としているため、ログイン ID の指定に -U スイッチを使用する必要があります。また、ローカルコンピューター上にある SQL Server の既定のインスタンスに接続する以外の場合は、 -S スイッチを使用して、システム名と、オプションでインスタンス名を指定します。

bcp AdventureWorks2012.Sales.Currency out Currency.dat -c -U<login_id> -S<server_name\instance_name>

システムによってパスワードの入力が求められます。

C: ファイルからテーブルへのデータのコピー

次の例では、前の例で作成したファイル (Currency.dat) を使用して、in オプションを実行します。ただし、最初に AdventureWorks2012 Sales.Currency テーブルの空のコピー、Sales.Currency2 が作成され、これにデータがコピーされます。この例では、Windows 認証を使用していること、および bcp コマンドを実行しているサーバーインスタンスへのセキュリティ接続があることを前提としています。

空のテーブルを作成するには、クエリエディターで次のコマンドを入力します。

USE AdventureWorks2012;  
GO  
SELECT * INTO AdventureWorks2012.Sales.Currency2   
FROM AdventureWorks2012.Sales.Currency WHERE 1=2;

文字データを新規のテーブルに一括コピーする、つまりデータをインポートするには、コマンドプロンプトで次のコマンドを入力します。

bcp AdventureWorks2012.Sales.Currency2 in Currency.dat -T -c

コマンドが正常終了したことを確認するには、クエリエディターでテーブルの内容を表示し、次を入力します。

USE AdventureWorks2012;  
GO  
SELECT * FROM Sales.Currency2

D. データファイルへの特定の列のコピー

特定の列をコピーする場合に、 queryout オプションを使用できます。次の例では、 Name テーブルの Sales.Currency 列のみをデータファイルにコピーします。この例では、Windows 認証を使用していること、および bcp コマンドを実行しているサーバーインスタンスへのセキュリティ接続があることを前提としています。

Windows コマンドプロンプトで、次のように入力します。

bcp "SELECT Name FROM AdventureWorks.Sales.Currency" queryout Currency.Name.dat -T -c

E. データファイルへの特定の行のコピー

特定の行をコピーする場合に、 queryout オプションを使用できます。次の例では、Jarrod Rana という名前の連絡先の行のみを AdventureWorks2012.Person.Person テーブルからデータファイル (Jarrod Rana.dat) にコピーします。この例では、Windows 認証を使用していること、および bcp コマンドを実行しているサーバーインスタンスへのセキュリティ接続があることを前提としています。

Windows コマンドプロンプトで、次のように入力します。

bcp "SELECT * FROM AdventureWorks2012.Person.Person WHERE FirstName='Jarrod' AND LastName='Rana' "  queryout "Jarrod Rana.dat" -T -c

F. クエリからデータファイルへのデータのコピー

Transact-SQL ステートメントからデータファイルに結果セットをコピーするには、 queryout オプションを使用します。次の例では、名前 (姓、名の順) を AdventureWorks2012.Person.Person テーブルから、Contacts.txt データファイルへコピーします。この例では、Windows 認証を使用していること、および bcp コマンドを実行しているサーバーインスタンスへのセキュリティ接続があることを前提としています。

Windows コマンドプロンプトで、次のように入力します。

bcp "SELECT FirstName, LastName FROM AdventureWorks2012.Person.Person ORDER BY LastName, Firstname" queryout Contacts.txt -c -T

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

次の例では、AdventureWorks2012 データベースのSales.Currency テーブルに対して XML 形式以外のフォーマットファイルCurrency.fmtを作成します。この例では、Windows 認証を使用していること、および bcp コマンドを実行しているサーバーインスタンスへのセキュリティ接続があることを前提としています。

Windows コマンドプロンプトで、次のように入力します。

bcp AdventureWorks2012.Sales.Currency format nul -T -c  -f Currency.fmt

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

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

次の例では、AdventureWorks2012 データベース内のSales.Currency テーブルのCurrency.xmlという名前の XML フォーマットファイルを作成します。この例では、Windows 認証を使用していること、および bcp コマンドを実行しているサーバーインスタンスへのセキュリティ接続があることを前提としています。

Windows コマンドプロンプトで、次のように入力します。

bcp AdventureWorks2012.Sales.Currency format nul -T -c -x -f Currency.xml

Note

-x スイッチを使用するには、 bcp 9.0 クライアントを使用している必要があります。 bcp 9.0 クライアントの使用方法の詳細については、「解説」をご覧ください。

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

I. フォーマットファイルを使用した bcpでの一括インポート

SQL Serverのインスタンスにデータをインポートするときに、既に作成してあるフォーマットファイルを使用するには、 -f スイッチを in オプションと共に使用します。たとえば、次のコマンドは、作成済みのフォーマットファイル (Currency.dat) を使用して、データファイル (Sales.Currency) の内容を Sales.Currency2 テーブルのコピー (Currency.xml) に一括コピーします。この例では、Windows 認証を使用していること、および bcp コマンドを実行しているサーバーインスタンスへのセキュリティ接続があることを前提としています。

Windows コマンドプロンプトで、次のように入力します。

bcp AdventureWorks2012.Sales.Currency2 in Currency.dat -T -f Currency.xml

Note

フォーマットファイルは、データファイルのフィールドとテーブル列の数、順序、データ型などが異なる場合に役立ちます。詳細については、「データのインポートまたはエクスポート用のフォーマットファイル (SQL Server)」を参照してください。

その他の例

次のトピックでは、bcp の使用例を示します。

参照

一括エクスポートまたは一括インポートのデータの準備 (SQL Server)
BULK INSERT (Transact-SQL)
OPENROWSET (Transact-SQL)
SET QUOTED_IDENTIFIER (Transact-SQL)
sp_configure (Transact-SQL)
sp_tableoption (Transact-SQL)
データのインポートまたはエクスポート用のフォーマットファイル (SQL Server)

次の方法で共有

bcp ユーティリティ

構文

引数

解説

ネイティブデータファイルのサポート

計算列とタイムスタンプ列

空白や引用符を含む識別子の指定

データ検証

SQLXML ドキュメントの一括エクスポートまたは一括インポート

アクセス許可

キャラクターモード (-c) およびネイティブモード (-n) のベストプラクティス

例

A. データファイルへのテーブル行のコピー (セキュリティ接続を使用)

B. データファイルへのテーブル行のコピー (混合モード認証を使用)

C: ファイルからテーブルへのデータのコピー

D. データファイルへの特定の列のコピー

E. データファイルへの特定の行のコピー

F. クエリからデータファイルへのデータのコピー

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

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

I. フォーマットファイルを使用した bcpでの一括インポート

その他の例

参照

その他のリソース

次の方法で共有

bcp ユーティリティ

構文

引数

解説

ネイティブ データ ファイルのサポート

計算列とタイムスタンプ列

空白や引用符を含む識別子の指定

データ検証

SQLXML ドキュメントの一括エクスポートまたは一括インポート

アクセス許可

キャラクター モード (-c) およびネイティブ モード (-n) のベスト プラクティス

例

A. データ ファイルへのテーブル行のコピー (セキュリティ接続を使用)

B. データ ファイルへのテーブル行のコピー (混合モード認証を使用)

C: ファイルからテーブルへのデータのコピー

D. データ ファイルへの特定の列のコピー

E. データ ファイルへの特定の行のコピー

F. クエリからデータ ファイルへのデータのコピー

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

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

I. フォーマット ファイルを使用した bcpでの一括インポート

その他の例

参照

その他のリソース

ネイティブデータファイルのサポート

キャラクターモード (-c) およびネイティブモード (-n) のベストプラクティス

A. データファイルへのテーブル行のコピー (セキュリティ接続を使用)

B. データファイルへのテーブル行のコピー (混合モード認証を使用)

D. データファイルへの特定の列のコピー

E. データファイルへの特定の行のコピー

F. クエリからデータファイルへのデータのコピー

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

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

I. フォーマットファイルを使用した bcpでの一括インポート