Aracılığıyla paylaş


Nasıl yapılır: Büyük/küçük harfe duyarlı olmayan (CI) harmanlama ile bir ambar oluşturma

Şunlar için geçerlidir:✅ Microsoft Fabric'te Ambar

Varsayılan olarak tüm Doku ambarları büyük/küçük harfe duyarlı (CS) harmanlama Latin1_General_100_BIN2_UTF8 yapılandırılır. Büyük/küçük harfe duyarlı olmayan (CI) harmanlamalı ambarlar da oluşturabilirsiniz - Latin1_General_100_CI_AS_KS_WS_SC_UTF8.

Şu anda büyük/küçük harfe duyarlı olmayan bir veri ambarı oluşturmak için kullanılabilen tek yöntem REST API aracılığıyladır. Bu makalede REST API aracılığıyla büyük/küçük harfe duyarlı olmayan harmanlama ile bir ambar oluşturma hakkında adım adım bir kılavuz sunulmaktadır. Ayrıca, işlemi kolaylaştırmak için Visual Studio Code'un REST İstemci uzantısıyla nasıl kullanılacağı da açıklanmaktadır.

Önemli

Ambar oluşturulduktan sonra harmanlama ayarı değiştirilemez. Oluşturma işlemini başlatmadan önce gereksinimlerinizi dikkatle göz önünde bulundurun.

Önkoşullar

API uç noktası

REST API ile bir ambar oluşturmak için API uç noktasını kullanın: POST https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/items

Ambar oluşturmak için örnek bir JSON istek gövdesi aşağıda verilmişti:

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

REST API'yi çağırmak için Visual Studio Code kullanma

Visual Studio Code (VS Code) ve REST İstemci uzantısını kullanarak büyük/küçük harfe duyarlı olmayan harmanlama ile kolayca yeni bir ambar oluşturabilirsiniz. Şu adımları izleyin:

  1. VS Code'da uzantısıyla .http yeni bir metin dosyası oluşturun.

  2. İstek ayrıntılarını dosya gövdesine girin. Üst bilgi ile gövde arasında "Yetkilendirme" satırından sonra yerleştirilmiş boş bir boşluk olması gerektiğini unutmayın.

      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. Yer tutucu değerlerini değiştirin:

    • <workspaceID>: Bölümünden sonraki URL'de veya var olan bir ambarda çalıştırarak /groups/ çalışma alanı GUID'sini SELECT @@SERVERNAME bulun.

    • <bearer token>: Aşağıdaki adımları izleyerek bunu elde edin:

      1. Microsoft Fabric çalışma alanınızı tarayıcıda (Microsoft Edge veya Google Chrome) açın.
      2. Geliştirici Araçları'nı açmak için F12 tuşuna basın.
      3. Konsol sekmesini seçin. Gerekirse, konsol istemini görüntülemek için Hızlı Görünümü>.
      4. Komutunu copy(powerBIAccessToken) yazın ve Enter tuşuna basın. Konsol tanımsız yanıt verirken taşıyıcı belirteci panonuza kopyalanır.
      5. yerine <bearer token>yapıştırın.

      Not

      Bazı senaryolarda, sayfada "copy" adlı bir öğe kimliği varsa copy(powerBIAccessToken), uncaught TypeError: copy is not a function hatasını vererek başarısız olabilir. Böyle durumlarda, "copy" işlevini kullanmadan önce aşağıdaki komutu kullanarak öğe kimliğini el ile kaldırın: document.querySelector('#copy').remove().

    • <Warehouse name here>: İstenen ambar adını girin.

    • <Warehouse description here>: İstenen ambar açıklamasını girin.

  4. VS Code düzenleyicisinde POST komutunuz üzerinden görüntülenen İstek Gönder bağlantısını seçin.

  5. POST isteğinizle ilgili ek ayrıntılarla birlikte 202 Kabul Edildi durum kodunu içeren bir yanıt almanız gerekir.

  6. Doku portalında yeni oluşturulan ambara gidin.

  7. Ambarınızın harmanlamasının yukarıdaki JSON'da belirttiğiniz değerle uyumlu olduğunu onaylamak için Sorgu düzenleyicisinde aşağıdaki T-SQL deyimini yürütebilirsiniz:

    SELECT name, collation_name FROM sys.databases;