Partilhar via


Intercalação do Data Warehouse

Aplica-se para:✅ Armazém no Microsoft Fabric

O Fabric Data Warehouse suporta agrupamentos que diferenciam maiúsculas de minúsculas e agrupamentos que não fazem distinção entre elas. Os agrupamentos de armazém suportados são:

  • Latin1_General_100_BIN2_UTF8 (padrão) (sensível a maiúsculas e minúsculas)
  • Latin1_General_100_CI_AS_KS_WS_SC_UTF8 (não sensível a maiúsculas e minúsculas)

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

A alteração da ordenação ao nível do espaço de trabalho não afeta os armazéns existentes ou os endpoints de análise SQL. As consultas entre armazéns podem encontrar erros ou resultados de consulta inesperados em itens com agrupamentos diferentes.

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

Importante

Depois que um ponto de extremidade de análise SQL ou de depósito é criado, o agrupamento não pode ser alterado.

Modificar o agrupamento padrão do espaço de trabalho para o Fabric Data Warehouse

Esta seção explica como configurar o agrupamento padrão para armazéns no nível do espaço de trabalho, uma configuração que afeta todos os itens de ponto de extremidade do armazém e de análise SQL.

Permissions

  • Membros das funções do espaço de trabalho Fabric Admin, Membro, Colaborador podem alterar o agrupamento do espaço de trabalho a partir do painel de configurações.
  • Visualizadores: podem visualizar as configurações de agrupamento, mas não podem modificá-las.

Alterar o agrupamento padrão do espaço de trabalho para o Fabric Data Warehouse no portal do Fabric

  1. Vá para o espaço de trabalho Microsoft Fabric.
  2. Abra as Configurações do espaço de trabalho.
  3. Na janela Configurações do espaço de trabalho , selecione a guia Data Warehouse .
  4. Selecione a página Agrupamentos .
  5. Em Sensibilidade a maiúsculas e minúsculas, escolha Case sensitive (Latin1_General_100_BIN2_UTF8) (padrão) ou Case insensitive (Latin1_General_100_CI_AS_KS_WS_SC_UTF8). Qualquer novo armazém e endpoints de análise SQL criados neste espaço de trabalho serão criados com o agrupamento de espaço de trabalho escolhido.
  6. Depois de criar um armazém, use a seguinte instrução T-SQL no editor de consultas do Fabric para confirmar o agrupamento do seu armazém.
    SELECT name, collation_name FROM sys.databases;
    

Observação

O novo item de ponto de extremidade de análise SQL para um novo banco de dados SQL espelhado do SQL Server, banco de dados SQL espelhado da Instância Gerenciada, banco de dados SQL espelhado do Azure, ou banco de dados SQL no Fabric, usa o agrupamento do espaço de trabalho Fabric, não o agrupamento do item pai.

Criar um armazém com um cotejamento não padrão com a API REST

Esta seção explica como usar o Visual Studio Code para criar um depósito com um agrupamento não padrão usando a extensão REST Client.

Ponto final de API

Para criar um armazém com a API REST, use o ponto de extremidade 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 depósito, incluindo o defaultCollation agrupamento de depósito no parâmetro:

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

Usar o Visual Studio Code para invocar a API REST

Você pode criar facilmente um novo armazém com um agrupamento não padrão usando o Visual Studio Code e a extensão REST Client. Siga estes passos:

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

  2. Instale o cliente REST - Visual Studio Marketplace.

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

  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 do espaço reservado.

    • <workspaceID>: Encontre o GUID do espaço de trabalho no URL após a /groups/ secção ou executando SELECT @@SERVERNAME em um armazém existente.
    • <bearer token>: Obtenha o token de autenticação seguindo os passos a seguir.
      1. Abra o espaço de trabalho do Microsoft Fabric em um navegador (Microsoft Edge).
      2. Pressione F12 para abrir as Ferramentas de Desenvolvimento.
      3. Selecione a guia Console. Se necessário, selecione Visualização Rápida Expandida 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>: Insira o nome do armazém desejado.
    • <Warehouse description here>: Insira a descrição do armazém desejado.
  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. Vá para o armazém recém-criado no portal do Fabric.

  9. Execute a seguinte instrução T-SQL no editor de consultas para confirmar se o agrupamento do seu armazém está alinhado com o que você especificou no JSON:

    SELECT name, collation_name FROM sys.databases;