Partilhar via


Tipos de dados no Fabric Data Warehouse

Aplica-se a:✅ endpoint de análise SQL e Warehouse no Microsoft Fabric

As tabelas no Microsoft Fabric suportam os tipos de dados T-SQL mais usados.

Tipos de dados no Fabric Data Warehouse

O Warehouse suporta um subconjunto de tipos de dados T-SQL. Cada tipo de dados oferecido é baseado no tipo de dados SQL Server de mesmo nome. Para obter mais informações, consulte o artigo de referência para cada um na tabela a seguir.

Categoria Tipos de dados suportados
Números exatos
Números aproximados
Data e hora
Cadeias de caracteres de comprimento fixo
Cadeias de caracteres de comprimento variável
  • varchar - o limite de armazenamento em varchar(max) é atualmente de 16 MB no Fabric Data Warehouse.
Dados binários

* A precisão para datetime2 e hora é limitada a 6 dígitos de precisão em frações de segundos.

** O tipo de dados uniqueidentifier é um tipo de dados T-SQL que não possui tipo correspondente no Delta Parquet. Como resultado, ele é armazenado como um tipo binário. O Warehouse suporta o armazenamento e a leitura de colunas `uniqueidentifier`, mas não é possível ler esses valores no ponto de extremidade para análise SQL. A leitura de valores uniqueidentifier na casa do lago exibe uma representação em formato binário dos valores originais. Como resultado, funcionalidades como uniões cruzadas entre o Warehouse e o endpoint de análise SQL usando uma coluna uniqueidentifier não funcionam como esperado.

Para obter mais informações sobre os tipos de dados suportados, incluindo suas precisões, consulte Tipos de dados na referência CREATE TABLE.

Tipos de dados não suportados

Para tipos de dados T-SQL que não são suportados no momento, algumas alternativas estão disponíveis. Certifique-se de avaliar o uso desses tipos, pois a precisão e o comportamento da consulta variam:

Tipo de dados não suportado Alternativas disponíveis
dinheiro e dinheiro pequeno Use decimal, no entanto, note que ele não pode armazenar a unidade monetária.
datetime e smalldatetime Use datetime2.
datetimeoffset Use datetime2, no entanto, você pode usar datetimeoffset para converter dados com a função CAST na função AT TIME ZONE (Transact-SQL). Para obter um exemplo, consulte datetimeoffset.
Nchar e Nvarchar Use char e varchar respectivamente, pois não existe um tipo de dados unicode semelhante no formato Parquet. Os tipos char e varchar em um agrupamento UTF-8 podem usar mais armazenamento do que nchar e nvarchar para armazenar dados unicode. Para entender o impacto em seu ambiente, consulte Diferenças de armazenamento entre UTF-8 e UTF-16.
texto e ntext Usa varchar.
imagem Use varbinary.
tinyint Utilize smallint.
Geografia Armazene dados geográficos como um par de colunas (latitude, longitude) ou uma coluna varbinary com o conteúdo binário conhecido e converta-os em um valor geográfico. Como alternativa, use tipo varchar e armazene os dados como texto bem conhecido.
geometria Armazene dados de geometria como um par de colunas (latitude, longitude) ou uma coluna varbinary com o conteúdo binário conhecido, convertendo-o em um valor de geometria. Como alternativa, utilize o tipo varchar , armazenando os dados como texto bem conhecido.
Json Usa varchar.
XML Sem equivalente.
Tipo definido pelo usuário (CLR) Sem equivalente.

Tipos de dados sem suporte ainda podem ser usados no código T-SQL para variáveis, parâmetros ou saídas de funções e procedimentos armazenados, ou qualquer uso na memória na sessão. Não é permitido criar tabelas ou exibições que persistam dados no disco com qualquer um desses tipos.

Para obter um guia para criar uma tabela no Warehouse, consulte Criar tabelas.

Tipos de dados autogerados no endpoint de análise SQL

As tabelas no endpoint de análise SQL são criadas automaticamente sempre que uma tabela é criada no lakehouse associado. Os tipos de coluna nas tabelas de ponto de extremidade da análise SQL são derivados dos tipos Delta de origem.

Os tipos que não estão listados na tabela não são representados como as colunas da tabela no endpoint de análise SQL.

As regras para mapear os tipos originais do Delta para os tipos SQL no ponto final de análise SQL são mostradas na tabela a seguir:

Tipo de dados delta Tipo de dados SQL (mapeado)
LONG,BIGINT bigint
BOOLEANO, BOOL bit
INT, INTEIRO Int
TINYINT, BYTE, SMALLINT, SHORT smallint
DUPLO flutuar
FLUTUA, REAL real
DATA data
MARCA TEMPORAL datetime2
CHAR(n) varchar(n) com Latin1_General_100_BIN2_UTF8 ordenação
VARCHAR(n) em que n < 2000 varchar(4*n) com Latin1_General_100_BIN2_UTF8 ordenação
STRING, VARCHAR(n) onde n >= 2000 varchar(8000) no endpoint de análise SQL para Lakehouse, e varchar(max)* no endpoint de análise SQL para itens espelhados.
A coluna varchar tem Latin1_General_100_BIN2_UTF8 agrupamento.
BINÁRIO varbinary(n)
DECIMAL, DEC, NUMÉRICO decimal(p,s)

* O limite para armazenamento em varchar(max) é atualmente de 16 MB no endpoint de análise SQL e no Fabric Data Warehouse.