Compartilhar via

Como: Criar um warehouse com agrupamento sem diferenciação de maiúsculas e minúsculas (CI)

  • Artigo

Aplica-se a:✅Depósito no Microsoft Fabric

Todos os armazéns do Fabric são configurados por padrão com ordenação com diferenciação entre maiúsculas e minúsculas (CS) Latin1_General_100_BIN2_UTF8. Você também pode criar armazéns com agrupamento sem distinção entre maiúsculas e minúsculas (CI) - Latin1_General_100_CI_AS_KS_WS_SC_UTF8.

Atualmente, o único método disponível para criar um data warehouse que não diferencia maiúsculas de minúsculas é via API REST. Esse artigo fornece um guia passo a passo sobre como criar um warehouse com agrupamento que não diferencia maiúsculas de minúsculas por meio da API REST. Ele também explica como usar o Visual Studio Code com a extensão REST Client para facilitar o processo.

Importante

Depois que um warehouse é criado, a configuração de agrupamento não pode ser alterada. Considere cuidadosamente suas necessidades antes de iniciar o processo de criação.

Pré-requisitos

Ponto de extremidade de API

Para criar um warehouse com API REST, use o ponto de Extremidade de API: POST https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/items

Aqui está um exemplo de corpo de solicitação JSON para criar um warehouse:

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

Use o Visual Studio Code para invocar a API REST

Você pode criar facilmente um novo warehouse com ordenação que não diferencia maiúsculas de minúsculas usando o Visual Studio Code (VS Code) e a extensão REST Client. Siga estas etapas:

  1. Crie um novo arquivo de texto no VS Code com a extensão .http.

  2. Insira os detalhes da solicitação no corpo do arquivo. Observe que deve haver um espaço em branco entre o cabeçalho e o corpo, colocado após a linha "Autorização".

      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. Substitua os valores de espaço reservado:

    • <workspaceID>: Encontre o GUID do espaço de trabalho na URL após a seção /groups/ ou executando SELECT @@SERVERNAME em um warehouse existente.
    • <bearer token>: Obtenha isso seguindo esses passos:
      1. Abra seu espaço de trabalho do Microsoft Fabric em um navegador (Microsoft Edge ou Google Chrome).
      2. Pressione F12 para abrir as Ferramentas para Desenvolvedores.
      3. Selecione a guia Console. Se necessário, selecione Expandir visualização rápida para revelar o prompt do console >.
      4. Digite o comando copy(powerBIAccessToken) e pressione Enter. Enquanto o console responde indefinido, o token do portador será copiado para sua área de transferência.
      5. Cole-o no lugar de <bearer token>.
    • <Warehouse name here>: Digite o nome do depósito desejado.
    • <Warehouse description here>: Insira a descrição do depósito desejada.

  4. Selecione o link Enviar solicitação exibido sobre o comando POST no editor do VS Code.

  5. Você deve receber uma resposta com o código de status 202 Aceito, juntamente com detalhes adicionais sobre sua solicitação POST.

  6. Acesse o warehouse recém-criado no portal Fabric.

  7. Execute a seguinte instrução T-SQL no editor de consultas para confirmar se a ordenação do seu warehouse está alinhada com o que você especificou no JSON acima:

    SELECT name, collation_name FROM sys.databases;

Conteúdo relacionado