Unicode 文字形式を使用したデータのインポートまたはエクスポート (SQL Server)
適用対象:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
拡張文字や DBCS 文字を含むデータ ファイルを使用して SQL Server の複数のインスタンス間でデータを一括転送する場合は、Unicode 文字形式を使用することをお勧めします。 Unicode 文字データ形式を使用すると、操作を実行するクライアントで使用しているコード ページとは異なるコード ページを使用して、サーバーからデータをエクスポートできます。 このような場合、Unicode 文字形式を使用すると、次の利点があります。
転送元のデータと転送先のデータが Unicode データ型の場合、Unicode 文字形式を使用するとすべての文字データが保持されます。
転送元のデータと転送先のデータが Unicode 以外のデータ型の場合、Unicode 文字形式を使用すると、転送先のデータで表現できない転送元のデータに含まれる拡張文字の損失を最小限に抑えられます。
Unicode 文字形式の使用に関する注意点
Unicode 文字形式を使用するときは、以下の点をご考慮ください。
既定では、 bcp ユーティリティ は、文字データ フィールド間の区切りにはタブ文字を、レコードの終わりには改行文字を使用します。 別のターミネータの指定方法の詳細については、「フィールド ターミネータと行ターミネータの指定 (SQL Server)」を参照してください。
Unicode 文字形式のデータ ファイルに格納されている sql_variant データの動作は、 char データではなく nchar データとして格納されている点を除いて、文字形式のデータ ファイルの場合と同様になります。 文字形式の詳細については、「 Collation and Unicode Support」を参照してください。
Unicode 文字形式、bcp、フォーマット ファイルの使用に関する特別な注意点
Unicode 文字形式のデータ ファイルは、Unicode ファイルの規則に従います。 ファイルの先頭の 2 バイトは、16 進数の 0xFFFE です。 これらのバイトは、バイト順マーク (BOM) としての役割を果たし、高位のバイトをファイルの先頭に格納するか、最後に格納するかを指定します。 bcp ユーティリティ が BOM の解釈を間違えてインポート プロセスの一部が失敗し、次のようなエラー メッセージが表示される場合があります。
Starting copy...
SQLState = 22005, NativeError = 0
Error = [Microsoft][ODBC Driver 13 for SQL Server]Invalid character value for cast specification
次の条件下で BOM の解釈を間違える可能性があります。
cp ユーティリティ を使用しており、 -w スイッチを使用して Unicode 文字を指定している
フォーマット ファイルを使用している
データ ファイルの最初のフィールドが文字以外である
特定の 状況に次の回避策のいずれかを使用できるかどうかご検討ください。
フォーマット ファイルを使用しないでください。 この回避策の例については、以下の「 フォーマット ファイルなしで bcp と Unicode文字形式を使用してデータをインポートする方法」をご覧ください。
-w スイッチの代わりに -cスイッチを使用します。
ネイティブ形式を使用して、データをもう一度エクスポートします。
BULK INSERT または OPENROWSETを使用します。 これらの回避策の例については、以下の「 XML 形式以外のフォーマット ファイルで BULK INSERT と Unicode 文字形式を使用する方法 」と「 XML 形式以外のフォーマット ファイルで OPENROWSET と Unicode 文字形式を使用する方法」をご覧ください。
転送先のテーブルに手動で最初のレコードを挿入し、 -F 2 スイッチを使用して、2 番目のレコードからインポートを開始します。
データ ファイルに手動でダミーの最初のレコードを挿入し、 -F 2 スイッチを使用して、2 番目のレコードからインポートを開始します。 この回避策の例については、「 XML 形式以外のフォーマット ファイルで bcp と Unicode文字形式を使用してデータをインポートする方法」をご覧ください。
最初の列が文字データ型のステージング テーブルを使用します。
データをもう一度エクスポートし、最初のデータ フィールドが文字になるように、データ フィールドの順序を変更します。 その後、フォーマット ファイルを使用して、データ フィールドをテーブルの実際の順序にもう一度マッピングします。 例については、「 フォーマット ファイルを使用したテーブル列とデータ ファイル フィールドのマッピング (SQL Server)」をご覧ください。
Unicode 文字形式のコマンド オプション
Unicode 文字形式のデータは bcp、BULK INSERT、または INSERT ...SELECT * FROM OPENROWSET(BULK...) を使用してテーブルにインポートできます。bcp コマンドまたは BULK INSERT ステートメントの場合は、ステートメントでデータ形式を指定できます。 INSERT ...SELECT * FROM OPENROWSET(BULK...) ステートメントの場合は、フォーマット ファイルでデータ形式を指定する必要があります。
Unicode 文字形式は、次のコマンド オプションでサポートされています。
| command | オプション | 説明 |
|---|---|---|
| bcp | -w | Unicode 文字形式を使用します。 |
| BULK INSERT | DATAFILETYPE ='widechar' | データの一括インポート時に Unicode 文字形式を使用します。 |
| OPENROWSET | 該当なし | フォーマット ファイルを使用する必要があります |
注意
また、フォーマット ファイルでフィールドごとに形式を指定することもできます。 詳細については、「データのインポートまたはエクスポート用のフォーマット ファイル (SQL Server)」を参照してください。
テスト条件の例
このトピックの例は、以下に定義されたテーブルとフォーマット ファイルに基づいています。
サンプル テーブル
次のスクリプトは、 myWidechar という名前のテーブルのテスト データベースを作成し、テーブルにいくつかの初期値を設定します。 Microsoft SQL Server Management Studio (SSMS) で次の Transact-SQL を実行します。
CREATE DATABASE TestDatabase;
GO
USE TestDatabase;
CREATE TABLE dbo.myWidechar (
PersonID smallint NOT NULL,
FirstName nvarchar(25) NOT NULL,
LastName nvarchar(30) NOT NULL,
BirthDate date,
AnnualSalary money
);
-- Populate table
INSERT TestDatabase.dbo.myWidechar
VALUES
(1, N'ϴAnthony', N'Grosse', '02-23-1980', 65000.00),
(2, N'❤Alica', N'Fatnowna', '11-14-1963', 45000.00),
(3, N'☎Stella', N'Rossenhain', '03-02-1992', 120000.00);
-- Review Data
SELECT * FROM TestDatabase.dbo.myWidechar;
XML 形式以外のフォーマット ファイルのサンプル
SQL Server は、非 XML 形式と XML 形式の 2 種類のフォーマット ファイルをサポートしています。 XML 以外のフォーマットとは、以前のバージョンの SQL Server でサポートされる従来のフォーマットです。 詳細については、「 XML 以外のフォーマット ファイル (SQL Server) 」を参照してください。 次のコマンドでは、 bcp ユーティリティ を使用し、 myWidechar.fmtのスキーマに基づいて XML 以外のフォーマット ファイル myWidecharを生成します。 bcp コマンドを使用してフォーマット ファイルを作成するには、 format 引数を指定し、データ ファイルのパスの代わりに nul を使用します。 format オプションには、次に示す -f オプションが必要です。 さらに、この例では、修飾子 c を使用して文字データを指定し、 T を使用して統合セキュリティによる信頼関係接続を指定します。 コマンド プロンプトで、次のコマンドを入力します。
bcp TestDatabase.dbo.myWidechar format nul -f D:\BCP\myWidechar.fmt -T -w
REM Review file
Notepad D:\BCP\myWidechar.fmt
重要
XML 以外のフォーマット ファイルは、キャリッジ リターン\ライン フィードで終わるようにします。 そうしないと、次のエラー メッセージが発生する可能性があります。
SQLState = S1000, NativeError = 0
Error = [Microsoft][ODBC Driver 13 for SQL Server]I/O error while reading BCP format file
使用例
次の例では、上記で作成したデータベースとフォーマット ファイルを使用します。
bcp と Unicode 文字形式を使用したデータのエクスポート
-w スイッチと OUT コマンドです。 注: この例で作成するデータ ファイルをその後のすべての例で使用します。 コマンド プロンプトで、次のコマンドを入力します。
bcp TestDatabase.dbo.myWidechar OUT D:\BCP\myWidechar.bcp -T -w
REM Review results
NOTEPAD D:\BCP\myWidechar.bcp
フォーマット ファイルなしで bcp と Unicode文字形式を使用してデータをインポートする方法
-w スイッチと IN コマンドです。 コマンド プロンプトで、次のコマンドを入力します。
REM Truncate table (for testing)
SQLCMD -Q "TRUNCATE TABLE TestDatabase.dbo.myWidechar;"
REM Import data
bcp TestDatabase.dbo.myWidechar IN D:\BCP\myWidechar.bcp -T -w
REM Review results is SSMS
XML 形式以外のフォーマット ファイルで bcp と Unicode文字形式を使用してデータをインポートする方法
-w および -f スイッチと IN コマンドです。 この例は bcp、フォーマット ファイル、Unicode 文字を使用し、かつデータ ファイル内の最初のデータ フィールドが文字でないため、回避策を実行する必要があります。 上記の「 Unicode 文字形式、bcp、フォーマット ファイルの使用に関する特別な注意点」をご覧ください。 データ ファイル myWidechar.bcp は、"ダミー" のレコードとして追加のレコードを追加して変更されます。このレコードはその後、-F 2 スイッチでスキップされます。
コマンド プロンプトで次のコマンドを入力し、変更手順を実行します。
REM Truncate table (for testing)
SQLCMD -Q "TRUNCATE TABLE TestDatabase.dbo.myWidechar;"
REM Open data file
Notepad D:\BCP\myWidechar.bcp
REM Copy first record and then paste as new first record. This additional record is the "dummy" record.
REM Close file.
REM Import data instructing bcp to skip dummy record with the -F 2 switch.
bcp TestDatabase.dbo.myWidechar IN D:\BCP\myWidechar.bcp -f D:\BCP\myWidechar.fmt -T -F 2
REM Review results is SSMS
REM Return data file to original state for usage in other examples
bcp TestDatabase.dbo.myWidechar OUT D:\BCP\myWidechar.bcp -T -w
フォーマット ファイルなしで BULK INSERT と Unicode文字形式を使用する方法
DATAFILETYPE 引数です。 Microsoft SQL Server Management Studio (SSMS) で次の Transact-SQL を実行します。
TRUNCATE TABLE TestDatabase.dbo.myWidechar; -- for testing
BULK INSERT TestDatabase.dbo.myWidechar
FROM 'D:\BCP\myWidechar.bcp'
WITH (
DATAFILETYPE = 'widechar'
);
-- review results
SELECT * FROM TestDatabase.dbo.myWidechar;
XML 形式以外のフォーマット ファイルで BULK INSERT と Unicode 文字形式を使用する方法
FORMATFILE 引数。 Microsoft SQL Server Management Studio (SSMS) で次の Transact-SQL を実行します。
TRUNCATE TABLE TestDatabase.dbo.myWidechar; -- for testing
BULK INSERT TestDatabase.dbo.myWidechar
FROM 'D:\BCP\myWidechar.bcp'
WITH (
FORMATFILE = 'D:\BCP\myWidechar.fmt'
);
-- review results
SELECT * FROM TestDatabase.dbo.myWidechar;
XML 形式以外のフォーマット ファイルで OPENROWSET と Unicode 文字形式を使用する方法
FORMATFILE 引数。 Microsoft SQL Server Management Studio (SSMS) で次の Transact-SQL を実行します。
TRUNCATE TABLE TestDatabase.dbo.myWidechar; -- for testing
INSERT INTO TestDatabase.dbo.myWidechar
SELECT *
FROM OPENROWSET (
BULK 'D:\BCP\myWidechar.bcp',
FORMATFILE = 'D:\BCP\myWidechar.fmt'
) AS t1;
-- review results
SELECT * FROM TestDatabase.dbo.myWidechar;
関連タスク
一括インポートまたは一括エクスポートのデータ形式を使用するには
参照
bcp ユーティリティ
BULK INSERT (Transact-SQL)
OPENROWSET (Transact-SQL)
データ型 (Transact-SQL)
照合順序と Unicode のサポート
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示