Condividi tramite

Procedura: Creare un warehouse con regole di confronto senza distinzione tra maiuscole e minuscole

  • Articolo

Si applica a✅: warehouse in Microsoft Fabric

Tutti i warehouse di Fabric per impostazione predefinita sono configurati con regole di confronto con distinzione tra maiuscole e minuscole (CS) Latin1_General_100_BIN2_UTF8. È anche possibile creare warehouse con regole di confronto senza distinzione tra maiuscole e minuscole , Latin1_General_100_CI_AS_KS_WS_SC_UTF8.

Attualmente, l'unico metodo disponibile per la creazione di un data warehouse senza distinzione tra maiuscole e minuscole è tramite l'API REST. Questo articolo fornisce una guida dettagliata su come creare un warehouse con regole di confronto senza distinzione tra maiuscole e minuscole tramite l'API REST. Viene inoltre illustrato come usare Visual Studio Code con l'estensione client REST per facilitare il processo.

Importante

Dopo aver creato un magazzino, non è possibile modificare l'impostazione delle regole di confronto. Considerare attentamente le esigenze prima di avviare il processo di creazione.

Prerequisiti

Endpoint API

Per creare un warehouse con l'API REST, usare l'endpoint API: POST https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/items

Ecco un esempio di corpo della richiesta JSON per la creazione di un warehouse:

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

Usare Visual Studio Code per richiamare l'API REST

È possibile creare facilmente un nuovo warehouse con regole di confronto senza distinzione tra maiuscole e minuscole usando Visual Studio Code (VS Code) e l'estensione client REST. Seguire questa procedura:

  1. Creare un nuovo file di testo in VS Code con l'estensione .http .

  2. Immettere i dettagli della richiesta nel corpo del file. Si noti che deve essere presente uno spazio vuoto tra l'intestazione e il corpo, posizionato dopo la riga "Autorizzazione".

      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. Sostituire i valori segnaposto;

    • <workspaceID>: trovare il GUID dell'area di lavoro nell'URL dopo la /groups/ sezione o eseguendo SELECT @@SERVERNAME in un warehouse esistente.
    • <bearer token>: ottenere questa operazione seguendo questa procedura:
      1. Aprire l'area di lavoro di Microsoft Fabric in un browser (Microsoft Edge o Google Chrome).
      2. Premere F12 per aprire Strumenti di sviluppo.
      3. Selezionare la scheda Console. Se necessario, selezionare Espandi visualizzazione rapida per visualizzare il prompt >della console.
      4. Digitare il comando copy(powerBIAccessToken) e premere INVIO. Mentre la console risponde indefinita, il token di connessione verrà copiato negli Appunti.
      5. Incollarlo al posto di <bearer token>.
    • <Warehouse name here>: immettere il nome del magazzino desiderato.
    • <Warehouse description here>: immettere la descrizione del magazzino desiderata.

  4. Selezionare il collegamento Invia richiesta visualizzato sul comando POST nell'editor di VS Code.

  5. Si dovrebbe ricevere una risposta con il codice di stato 202 Accettato, insieme a dettagli aggiuntivi sulla richiesta POST.

  6. Passare al magazzino appena creato nel portale di Infrastruttura.

  7. Eseguire l'istruzione T-SQL seguente nell'editor di query per verificare che le regole di confronto per il warehouse siano allineate a quanto specificato nel codice JSON precedente:

    SELECT name, collation_name FROM sys.databases;

Contenuto correlato