Bagikan melalui

Tulis Pernyataan Transact-SQL Internasional

  • Artikel

Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Database dan aplikasi database yang menggunakan pernyataan Transact-SQL akan menjadi lebih portabel dari satu bahasa ke bahasa lain, atau akan mendukung beberapa bahasa, jika panduan berikut diikuti:

  • Dimulai dengan SQL Server 2019 (15.x) dan di Azure SQL Database, gunakan:

    • Jenis data char, varchar, dan varchar(max) dengan kolase berkemampuan UTF-8 , dan data dikodekan menggunakan UTF-8.
    • Jenis data nchar, nvarchar, dan nvarchar(max) dengan kolase karakter tambahan (SC) diaktifkan, dan data dikodekan menggunakan UTF-16. Menggunakan kolase non-SC menghasilkan data yang dikodekan menggunakan UCS-2.

    Ini menghindari masalah konversi halaman kode. Untuk pertimbangan lain, lihat Perbedaan penyimpanan antara UTF-8 dan UTF-16.

  • Hingga SQL Server 2017 (14.x), ganti semua penggunaan jenis data char, varchar, dan varchar(max) dengan nchar, nvarchar, dan nvarchar(max). Jika menggunakan kolase karakter tambahan (SC) diaktifkan, data dikodekan menggunakan UTF-16. Menggunakan kolase non-SC menghasilkan data yang dikodekan menggunakan UCS-2. Ini menghindari masalah konversi halaman kode. Untuk informasi selengkapnya, lihat Dukungan Kolate dan Unicode.

    Penting

    Jenis data teks tidak digunakan lagi dan tidak boleh digunakan dalam pekerjaan pengembangan baru. Rencanakan untuk mengonversi data teks ke varchar(maks).

  • Saat melakukan perbandingan dan operasi bulan dan hari dalam seminggu, gunakan bagian tanggal numerik alih-alih string nama. Pengaturan bahasa yang berbeda mengembalikan nama yang berbeda untuk bulan dan hari kerja. Misalnya, DATENAME(MONTH,GETDATE()) mengembalikan May saat bahasa diatur ke bahasa Inggris A.S. , kembali Mai saat bahasa diatur ke Bahasa Jerman, dan kembali mai saat bahasa diatur ke Bahasa Prancis. Sebagai gantinya, gunakan fungsi seperti DATEPART yang menggunakan jumlah bulan, bukan nama. Gunakan nama DATEPART saat Anda membuat tataan hasil yang akan ditampilkan kepada pengguna, karena nama tanggal sering lebih bermakna daripada representasi numerik. Namun, jangan kode logika apa pun yang bergantung pada nama yang ditampilkan berasal dari bahasa tertentu.

  • Saat Anda menentukan tanggal dalam perbandingan atau untuk input ke pernyataan INSERT atau UPDATE, gunakan konstanta yang ditafsirkan dengan cara yang sama untuk semua pengaturan bahasa:

    • Aplikasi ADO, OLE DB, dan ODBC harus menggunakan klausul tanda waktu, tanggal, dan waktu escape ODBC:

      { ts' yyyy - mm - dd hh : mm : ss [.fff] '} seperti: { ts'1998-09-24 10:02:20'}

      { d' yyyy - mm - dd '} seperti: { d'1998-09-24'}

      { t' hh : mm : ss '} seperti: { t'10:02:20'}

    • Aplikasi yang menggunakan API lain, atau skrip Transact-SQL, prosedur tersimpan, dan pemicu, harus menggunakan string numerik yang tidak dipisahkan. Misalnya, yyyymmdd sebagai 19980924.

    • Aplikasi yang menggunakan API lain, atau skrip Transact-SQL, prosedur tersimpan, dan pemicu harus menggunakan pernyataan CONVERT dengan parameter gaya eksplisit untuk semua konversi antara jenis data time, date, datedate, datetime, datetime2, dan datetimeoffset dan data string karakter. Misalnya, pernyataan berikut ditafsirkan dengan cara yang sama untuk semua pengaturan koneksi format bahasa atau tanggal:

      SELECT *  
FROM AdventureWorks2022.Sales.SalesOrderHeader  
WHERE OrderDate = CONVERT(DATETIME, '20060719', 101)

Lihat juga

CAST dan CONVERT (Transact-SQL)
DATEPART (Transact-SQL)
Dukungan Kolajeasi dan Unicode