Menyambungkan dengan bcp

Unduh driver ODBC

Utilitas bcp tersedia dengan Microsoft ODBC Driver untuk SQL Server di Linux dan macOS. Halaman ini mencakup perbedaan dari versi Windows bcp.

• Terminator bidang adalah tab ("\t").

• Terminator baris adalah baris baru ("\n").

• Mode karakter adalah format yang disukai untuk bcp file format dan file data yang tidak berisi karakter yang diperluas.

Catatan

Garis miring terbalik '\' pada argumen baris perintah harus dikutip atau diloloskan. Misalnya, untuk menentukan baris baru sebagai terminator baris kustom, Anda harus menggunakan salah satu mekanisme berikut:

• -r\\n
• -r"\n"
• -r'\n'

Contoh berikut adalah pemanggilan bcp perintah untuk menyalin baris tabel ke file teks:

bcp AdventureWorks2008R2.Person.Address out test.dat -Usa -Pxxxx -Sxxx.xxx.xxx.xxx

Opsi yang tersedia

Dalam rilis saat ini, sintaks dan opsi berikut tersedia:

[database.]skema.tabel di data_file data_file |

-a packet_size
Menentukan jumlah byte, per paket jaringan, yang dikirim ke dan dari server.

-b batch_size
Menentukan jumlah baris per batch data yang diimpor.

-c
Menggunakan jenis data karakter.

-d database_name
Menentukan database yang akan disambungkan.

-D
Menyebabkan nilai yang diteruskan ke bcp opsi -S ditafsirkan sebagai nama sumber data (DSN). Untuk informasi selengkapnya, lihat "Dukungan DSN di sqlcmd dan bcp" di Menyambungkan dengan sqlcmd.

-e error_file
Menentukan jalur lengkap file kesalahan yang digunakan untuk menyimpan baris apa pun yang tidak dapat ditransfer bcp utilitas dari file ke database.

-E
Menggunakan nilai identitas atau nilai dalam file data yang diimpor untuk kolom identitas.

-f format_file
Menentukan jalur lengkap file format.

-F first_row
Menentukan jumlah baris pertama yang akan diekspor dari tabel atau mengimpor dari file data.

-G
Sakelar ini digunakan oleh klien saat menyambungkan ke Azure SQL Database, Azure SQL Managed Instance, atau Azure Synapse Analytics untuk menentukan bahwa pengguna diautentikasi dengan ID Microsoft Entra (sebelumnya Azure Active Directory). Ini dapat dikombinasikan hanya dengan opsi -P untuk menggunakan autentikasi token akses (v17.8+). Sakelar -G memerlukan setidaknya bcp versi 17.6. Untuk menentukan versi Anda, jalankan bcp -v.

Penting

Opsi -G ini hanya berlaku untuk Azure SQL Database, Azure SQL Managed Instance, dan Azure Synapse Analytics. Autentikasi interaktif Microsoft Entra saat ini tidak didukung di Linux atau macOS. Autentikasi terintegrasi Microsoft Entra memerlukan Microsoft ODBC Driver 17 untuk SQL Server versi 17.6.1 atau yang lebih tinggi dan lingkungan Kerberos yang dikonfigurasi dengan benar.

-k
Menentukan bahwa kolom kosong harus menyimpan nilai null selama operasi, daripada memiliki nilai default untuk kolom yang disisipkan.

-L
Menentukan batas waktu masuk. Opsi -l menentukan jumlah detik sebelum waktu masuk ke SQL Server habis saat Anda mencoba menyambungkan ke server. Batas waktu masuk default adalah 15 detik. Batas waktu masuk harus berupa angka antara 0 dan 65534. Jika nilai yang disediakan tidak numerik atau tidak termasuk dalam rentang tersebut, bcp menghasilkan pesan kesalahan. Nilai 0 menentukan batas waktu tak terbatas.

-L last_row
Menentukan jumlah baris terakhir yang akan diekspor dari tabel atau mengimpor dari file data.

-m max_errors
Menentukan jumlah maksimum kesalahan sintaks yang dapat terjadi sebelum bcp operasi dibatalkan.

-n
Menggunakan jenis data asli (database) data untuk melakukan operasi penyalinan massal.

Kata sandi -P
Menentukan kata sandi untuk ID masuk. Saat digunakan dengan opsi -G tanpa -U, menentukan file yang berisi token akses (v17.8+). File token harus dalam format UTF-16LE (tanpa BOM).

Token akses dapat diperoleh melalui berbagai metode. Penting untuk memastikan token akses benar byte-for-byte, karena akan dikirim apa adanya. Di bawah ini adalah contoh perintah yang mendapatkan token akses. Perintah ini menggunakan perintah Azure CLI dan Linux dan menyimpannya ke file dalam format yang tepat. Jika pengodean default sistem atau terminal Anda bukan ASCII atau UTF-8, Anda mungkin perlu menyesuaikan iconv opsi. Pastikan untuk mengamankan file yang dihasilkan dengan hati-hati dan menghapusnya saat tidak lagi diperlukan.

az account get-access-token --resource https://database.windows.net --output tsv | cut -f 1 | tr -d '\n' | iconv -f ascii -t UTF-16LE > /tmp/tokenFile

-q
Menjalankan pernyataan SET QUOTED_IDENTIFIER ON dalam koneksi antara bcp utilitas dan instans SQL Server.

-r row_terminator
Menentukan terminator baris.

-R
Menentukan bahwa data mata uang, tanggal, dan waktu disalin secara massal ke SQL Server menggunakan format regional yang ditentukan untuk pengaturan lokal komputer klien.

Server -S
Menentukan nama instans SQL Server yang akan disambungkan, atau jika -D digunakan, DSN.

-t field_terminator
Menentukan terminator bidang.

-T
Menentukan bahwa bcp utilitas tersambung ke SQL Server dengan koneksi tepercaya (keamanan terintegrasi).

-u
Percayai sertifikat server. (tersedia sejak bcp versi 18)

-U login_id
Menentukan ID masuk yang digunakan untuk menyambungkan ke SQL Server.

-v
bcp Melaporkan nomor versi utilitas dan hak cipta.

-w
Menggunakan karakter Unicode untuk melakukan operasi penyalinan massal.

Dalam rilis ini, karakter Latin-1 dan UTF-16 didukung.

-Y[s|m|o]
Menentukan mode enkripsi koneksi. Opsinya adalah Ketat, Wajib, dan Opsional. Menggunakan -Y tanpa parameter apa pun menggunakan mode enkripsi Wajib, dan setara dengan -Ym. (tersedia sejak bcp versi 18)

Opsi tidak tersedia

Dalam rilis saat ini, sintaks dan opsi berikut tidak tersedia:

-C
Menentukan halaman kode data dalam file data.

-h petunjuk
Menentukan petunjuk atau petunjuk yang digunakan selama impor data secara massal ke dalam tabel atau tampilan.

-i input_file
Menentukan nama file respons.

-N
Menggunakan jenis data asli (database) data untuk data noncharacter, dan karakter Unicode untuk data karakter.

-o output_file
Menentukan nama file yang menerima output yang dialihkan dari prompt perintah.

-V (80 | 90 | 100)
Menggunakan jenis data dari versi SQL Server yang lebih lama.

-x
Digunakan dengan format dan opsi -f format_file, menghasilkan file format berbasis XML alih-alih file format non-XML default.

Lihat juga

Menyambungkan dengan sqlcmd
Catatan rilis