Compartilhar via

Ordenação do Data Warehouse

Aplica-se a:✅ Warehouse no Microsoft Fabric

O Fabric Data Warehouse dá suporte a ordenações que diferenciam maiúsculas de minúsculas e maiúsculas de minúsculas. As ordenações de warehouse com suporte são:

  • Latin1_General_100_BIN2_UTF8 (padrão) (diferencia maiúsculas de minúsculas)
  • Latin1_General_100_CI_AS_KS_WS_SC_UTF8 (não diferencia maiúsculas de minúsculas)

Novos armazéns e todos os pontos de extremidade de análise de SQL são configurados com base na configuração de ordenação padrão do Data Warehouse do workspace, que por padrão é a ordenação que diferencia maiúsculas Latin1_General_100_BIN2_UTF8de minúsculas.

Alterar a ordenação no nível do workspace não afeta os armazéns existentes nem os pontos de extremidade de análise de SQL. Consultas entre armazéns podem encontrar erros ou resultados inesperados de consulta entre itens com ordenações diferentes.

Para criar um warehouse com uma ordenação que não diferencia maiúsculas de minúsculas:

Importante

Depois que um ponto de extremidade de análise de SQL ou warehouse é criado, a ordenação não pode ser alterada.

Modificar a ordenação padrão do workspace para o Fabric Data Warehouse

Esta seção explica como configurar a ordenação padrão para armazéns no nível do workspace, uma configuração afeta todos os itens de ponto de extremidade de análise de SQL e do warehouse.

Permissions

  • Membros das funções de workspace do Fabric Administrador, Membro, Colaborador: podem alterar a ordenação do workspace do painel de configurações do workspace.
  • Visualizadores: pode exibir as configurações de ordenação, mas não pode modificá-las.

Alterar a ordenação padrão do workspace para o Fabric Data Warehouse no portal do Fabric

  1. Vá para o workspace do Microsoft Fabric.
  2. Abra as Configurações do workspace.
  3. Na janela configurações do Workspace , selecione a guia Data Warehouse .
  4. Selecione a página Ordenações .
  5. Em Diferenciação de maiúsculas de minúsculas, escolha Diferenciar maiúsculas de minúsculas (Latin1_General_100_BIN2_UTF8) (padrão) ou Diferenciar maiúsculas de minúsculas (Latin1_General_100_CI_AS_KS_WS_SC_UTF8). Todos os novos itens de ponto de extremidade de análise de SQL e warehouse criados neste workspace serão criados com a ordenação de workspace escolhida.
  6. Depois de criar um warehouse, use a seguinte instrução T-SQL no editor de Consultas do Fabric para confirmar a ordenação do seu warehouse: 
    SELECT name, collation_name FROM sys.databases;

Observação

O novo item de ponto de extremidade de análise de SQL para um novo banco de dados do SQL Server espelhado, banco de dados da Instância Gerenciada de SQL espelhado, Banco de Dados SQL do Azure espelhado ou banco de dados SQL no Fabric usa a ordenação do workspace fabric, não a ordenação do item pai.

Criar um warehouse com uma ordenação não padrão com a API REST

Esta seção explica como usar o Visual Studio Code para criar um warehouse com uma ordenação não padrão usando a extensão rest client.

Ponto de extremidade de API

Para criar um armazém com a API REST, use o endpoint da API: POST https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/items

Aqui está um corpo de solicitação JSON de exemplo para criar um warehouse, incluindo a ordenação de warehouse no defaultCollation parâmetro:

{ 
  "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 uma ordenação não padrão usando o Visual Studio Code e a extensão rest client. Siga estas etapas:

  1. Se ainda não estiver, baixe e instale o Visual Studio Code para baixar e instalar o aplicativo.

  2. Instalar o REST Client - Visual Studio Marketplace.

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

  4. Insira os detalhes da solicitação no corpo do arquivo. 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" 
   } 
 }

  5. Substitua os valores de espaço reservado:

    • <workspaceID>: Encontre o GUID do workspace na URL após a seção /groups/ ou executando SELECT @@SERVERNAME em um warehouse existente.
    • <bearer token>: obtenha o token de portador seguindo estas etapas:
      1. Abra seu workspace do Microsoft Fabric em um navegador (Microsoft Edge).
      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 powerBIAccessToken e pressione Enter. Clique com o botão direito do mouse na cadeia de caracteres exclusiva grande retornada no console e selecione Copiar conteúdo da cadeia de caracteres.
      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.

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

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

  8. Acesse o armazém recém-criado no portal Fabric.

  9. 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:

    SELECT name, collation_name FROM sys.databases;

Conteúdo relacionado

  • Last updated on