Bagikan melalui


Cara: Membuat gudang dengan kolater tidak peka huruf besar/kecil (CI)

Berlaku untuk:✅ Gudang di Microsoft Fabric

Semua gudang Fabric secara default dikonfigurasi dengan kolab peka huruf besar/kecil (CS) Latin1_General_100_BIN2_UTF8. Anda juga dapat membuat gudang dengan kolater peka huruf besar/kecil (CI) - Latin1_General_100_CI_AS_KS_WS_SC_UTF8.

Saat ini, satu-satunya metode yang tersedia untuk membuat gudang data yang tidak peka huruf besar/kecil adalah melalui REST API. Artikel ini menyediakan panduan langkah demi langkah tentang cara membuat gudang dengan kolaborasi yang tidak peka huruf besar/kecil melalui REST API. Ini juga menjelaskan cara menggunakan Visual Studio Code dengan ekstensi Klien REST untuk memfasilitasi proses.

Penting

Setelah gudang dibuat, pengaturan kolase tidak dapat diubah. Pertimbangkan kebutuhan Anda dengan hati-hati sebelum memulai proses pembuatan.

Prasyarat

Titik akhir API

Untuk membuat gudang dengan REST API, gunakan titik akhir API: POST https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/items

Berikut adalah contoh isi permintaan JSON untuk membuat gudang:

{ 
  "type": "Warehouse", 
  "displayName": "CaseInsensitiveAPIDemo", 
  "description": "New warehouse with case-insensitive collation", 
  "creationPayload": { 
    "defaultCollation": "Latin1_General_100_CI_AS_KS_WS_SC_UTF8" 
  } 
}

Menggunakan Visual Studio Code untuk memanggil REST API

Anda dapat dengan mudah membuat gudang baru dengan kolater yang tidak peka huruf besar/kecil menggunakan Visual Studio Code (VS Code) dan ekstensi Klien REST. Ikuti langkah-langkah ini:

  1. Buat file teks baru di Visual Studio Code dengan .http ekstensi .

  2. Masukkan detail permintaan dalam isi file. Perhatikan bahwa harus ada ruang kosong antara header dan isi, ditempatkan setelah baris "Otorisasi".

      POST https://api.fabric.microsoft.com/v1/workspaces/<workspaceID>/items HTTP/1.1
      Content-Type: application/json
      Authorization: Bearer <bearer token>
    
    { 
       "type": "Warehouse", 
       "displayName": "<Warehouse name here>", 
       "description": "<Warehouse description here>", 
       "creationPayload": { 
         "defaultCollation": "Latin1_General_100_CI_AS_KS_WS_SC_UTF8" 
       } 
     }
    
  3. Ganti nilai tempat penampung:

    • <workspaceID>: Temukan GUID ruang kerja di URL setelah bagian /groups/ , atau dengan menjalankan SELECT @@SERVERNAME di gudang yang ada.

    • <bearer token>: Dapatkan ini dengan mengikuti langkah-langkah berikut:

      1. Buka ruang kerja Microsoft Fabric Anda di browser (Microsoft Edge atau Google Chrome).
      2. Tekan F12 untuk membuka Alat Pengembang.
      3. Pilih tab Konsol . Jika perlu, pilih Perluas Tampilan Cepat untuk menampilkan perintah >konsol .
      4. Ketik perintah copy(powerBIAccessToken) dan tekan Enter. Meskipun konsol merespons tidak terdefinisi, token pembawa akan disalin ke clipboard Anda.
      5. Tempelkan sebagai pengganti <bearer token>.

      Nota

      Dalam beberapa skenario, copy(powerBIAccessToken) mungkin gagal dengan kesalahan uncaught TypeError: copy is not a function jika ada id elemen bernama "copy" di halaman. Dalam kasus seperti itu, hapus id elemen secara manual menggunakan perintah berikut sebelum menggunakan fungsi "salin": document.querySelector('#copy').remove().

    • <Warehouse name here>: Masukkan nama gudang yang diinginkan.

    • <Warehouse description here>: Masukkan deskripsi gudang yang diinginkan.

  4. Pilih tautan Kirim Permintaan yang ditampilkan melalui perintah POST Anda di editor Visual Studio Code.

  5. Anda akan menerima respons dengan kode status 202 Diterima, bersama dengan detail tambahan tentang permintaan POST Anda.

  6. Buka gudang yang baru dibuat di portal Fabric.

  7. Jalankan pernyataan T-SQL berikut di editor Kueri untuk mengonfirmasi bahwa kolase untuk gudang Anda selaras dengan apa yang Anda tentukan dalam JSON di atas:

    SELECT name, collation_name FROM sys.databases;