Condividi tramite

Procedura: Creare un magazzino con confronto insensibile alle maiuscole/minuscole

  • Articolo

Si applica a:✅ Warehouse in Microsoft Fabric

Tutti i depositi di Fabric, per impostazione predefinita, sono configurati con regole di confronto case-sensitive (CS) Latin1_General_100_BIN2_UTF8. È anche possibile creare magazzini con collazione 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 la creazione di un magazzino, l'impostazione di collation non può essere modificata. 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. 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. Sostituisci i valori segnaposto.

    • <workspaceID>: Trova il GUID dell'area di lavoro nell'URL dopo la sezione /groups/, o eseguendo SELECT @@SERVERNAME in un magazzino esistente. Se l'URL /groups/ è seguito da /me/, si usa l'area di lavoro predefinita e attualmente questa funzionalità non è supportata nell'area di lavoro predefinita.

    • <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 "non definita", il token di autenticazione verrà copiato negli Appunti.
      5. Incollarlo al posto di <bearer token>.

      Nota

      In alcuni scenari, copy(powerBIAccessToken) può non riuscire con l'errore uncaught TypeError: copy is not a function se nella pagina è presente un elemento con ID chiamato "copy". In questi casi, rimuovere manualmente l'ID elemento usando il comando seguente prima di usare la funzione "copy": document.querySelector('#copy').remove().

    • <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. Accedi al magazzino appena creato nel portale Fabric.

  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