Udostępnij za pośrednictwem

Instrukcje: tworzenie magazynu z sortowaniem bez uwzględniania wielkości liter

  • Artykuł

Dotyczy:✅ Magazyn w usłudze Microsoft Fabric

Wszystkie magazyny sieci szkieletowej są domyślnie konfigurowane przy użyciu sortowania uwzględniającego wielkość liter (CS) Latin1_General_100_BIN2_UTF8. Magazyny można również tworzyć z sortowaniem bez uwzględniania wielkości liter — Latin1_General_100_CI_AS_KS_WS_SC_UTF8.

Obecnie jedyną metodą dostępną do tworzenia magazynu danych bez uwzględniania wielkości liter jest interfejs API REST. Ten artykuł zawiera szczegółowy przewodnik dotyczący tworzenia magazynu z sortowaniem bez uwzględniania wielkości liter za pośrednictwem interfejsu API REST. Wyjaśniono również, jak używać programu Visual Studio Code z rozszerzeniem klienta REST w celu ułatwienia procesu.

Ważne

Po utworzeniu magazynu nie można zmienić ustawienia sortowania. Przed zainicjowaniem procesu tworzenia należy dokładnie rozważyć swoje potrzeby.

Wymagania wstępne

Punkt końcowy interfejsu API

Aby utworzyć magazyn za pomocą interfejsu API REST, użyj punktu końcowego interfejsu API: POST https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/items

Oto przykładowa treść żądania JSON do utworzenia magazynu:

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

Wywoływanie interfejsu API REST przy użyciu programu Visual Studio Code

Nowy magazyn można łatwo utworzyć z sortowaniem bez uwzględniania wielkości liter przy użyciu programu Visual Studio Code (VS Code) i rozszerzenia klienta REST. Wykonaj te kroki:

  1. Utwórz nowy plik tekstowy w programie VS Code z .http rozszerzeniem .

  2. Wprowadź szczegóły żądania w treści pliku. Należy pamiętać, że między nagłówkiem a treścią powinna znajdować się pusta spacja umieszczona po wierszu "Autoryzacja".

      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. Zastąp wartości symboli zastępczych:

    • <workspaceID>: Znajdź identyfikator GUID obszaru roboczego w adresie URL po /groups/ sekcji lub przez uruchomienie SELECT @@SERVERNAME w istniejącym magazynie.

    • <bearer token>: Uzyskaj to, wykonując następujące kroki:

      1. Otwórz obszar roboczy usługi Microsoft Fabric w przeglądarce (Microsoft Edge lub Google Chrome).
      2. Naciśnij F12 , aby otworzyć narzędzia deweloperskie.
      3. Wybierz kartę Konsola. W razie potrzeby wybierz pozycję Rozwiń szybki widok, aby wyświetlić monit >konsoli .
      4. Wpisz polecenie copy(powerBIAccessToken) i naciśnij Enter. Gdy konsola odpowiada na niezdefiniowane, token elementu nośnego zostanie skopiowany do schowka.
      5. Wklej go zamiast <bearer token>.

      Notatka

      W niektórych scenariuszach copy(powerBIAccessToken) może zakończyć się niepowodzeniem z powodu błędu uncaught TypeError: copy is not a function, jeśli na stronie znajduje się element o identyfikatorze "copy". W takich przypadkach ręcznie usuń identyfikator elementu przy użyciu następującego polecenia przed użyciem funkcji "copy": document.querySelector('#copy').remove().

    • <Warehouse name here>: wprowadź żądaną nazwę magazynu.

    • <Warehouse description here>: wprowadź żądany opis magazynu.

  4. Wybierz link Wyślij żądanie wyświetlany za pośrednictwem polecenia POST w edytorze programu VS Code.

  5. Powinna zostać odebrana odpowiedź z kodem stanu 202 Zaakceptowane wraz z dodatkowymi szczegółami dotyczącymi żądania POST.

  6. Przejdź do nowo utworzonego magazynu w portalu sieci szkieletowej.

  7. Wykonaj następującą instrukcję języka T-SQL w edytorze zapytań, aby potwierdzić, że sortowanie magazynu jest zgodne z tym, co zostało określone w powyższym kodzie JSON:

    SELECT name, collation_name FROM sys.databases;

Powiązana zawartość