Uma cópia lógica

É possível criar uma cópia lógica dos dados do Banco de Dados KQL ao ativar a disponibilidade do OneLake. Ativar a disponibilidade do OneLake significa que você pode realizar consulta dos dados no Banco de Dados KQL no formato Delta Lake por meio de outros mecanismos do Fabric, como o modo Direct Lake no Power BI, Warehouse, Lakehouse, Notebooks e muito mais.

O Delta Lake é um formato unificado de tabela data lake que obtém acesso contínuo a dados em todos os mecanismos de computação no Microsoft Fabric. Para obter mais informações sobre o Delta Lake, confira O que é Delta Lake?.

Neste artigo, você aprende como ativar a disponibilidade de dados do Banco de Dados KQL no OneLake.

Como ele funciona

A tabela apresentada a seguir descreve o comportamento do Banco de Dados KQL e das tabelas quando você ativa ou desativa a disponibilidade do OneLake.

	Ativada	Desativada
Banco de dados KQL	- As tabelas existentes não são afetadas. Novas tabelas estão disponíveis no OneLake. - A política de retenção de dados do banco de dados KQL também é aplicada aos dados no OneLake. Os dados removidos do banco de dados KQL no final do período de retenção também são removidos do OneLake.	- As tabelas existentes não são afetadas. Novas tabelas não estarão disponíveis no OneLake.
Uma tabela no banco de dados KQL	- Novos dados estão disponíveis no OneLake. - Os dados existentes não são provisionados. - Os dados não podem ser excluídos, truncados ou limpos. O esquema de tabela não pode ser alterado e a tabela não pode ser renomeada.	- Novos dados não estão disponíveis no OneLake. - Os dados podem ser excluídos, truncados ou limpos. - O esquema de tabela pode ser alterado e a tabela pode ser renomeada. - Os dados são excluídos temporariamente do OneLake.

Importante

Não há custo de armazenamento adicional para ativar a disponibilidade do OneLake. Para obter mais informações, confira consumo de recursos.

Pré-requisitos

• Um espaço de trabalho com uma capacidade habilitada para o Microsoft Fabric
• Um banco de dados KQL com permissões de edição e dados

Ativar a disponibilidade do OneLake

É possível ativar a disponibilidade do OneLake em um banco de dados KQL ou em nível de tabela.

1. Para ativar a disponibilidade do OneLake, navegue até a página de detalhes do banco de dados KQL ou da tabela.

2. Ao lado de Disponibilidade do OneLake no painel Detalhes do banco de dados, selecione o ícone Editar (lápis).

   

3. Ative o recurso ao alternar o botão para Ativa e, em seguida, selecione Concluído. O banco de dados é atualizado automaticamente.

   

Você ativou a disponibilidade do OneLake em seu banco de dados KQL. Agora você pode acessar todos os novos dados adicionados ao banco de dados no caminho do OneLake fornecido no formato Delta Lake. Você também pode optar por criar um atalho do OneLake em um Lakehouse, Data warehouse ou consultar os dados diretamente no modo do Direct Lake do Power BI.

Exibir arquivos

Quando você ativa a disponibilidade do OneLake em uma tabela, uma pasta de logs delta é criada em conjunto com arquivos JSON e Parquet correspondentes. É possível realizar a exibição dos arquivos que foram disponibilizados no OneLake e de suas propriedades enquanto permanece na Inteligência em Tempo Real.

Importante

Pode levar até algumas horas para os arquivos aparecerem depois de ativar a disponibilidade do OneLake.

• Para realizar a exibição dos arquivos, passe o mouse sobre uma tabela no painel Explorer e, em seguida, selecione o menu Mais [...]>Exibir arquivos.

  

• Para realizar a exibição das propriedades da pasta de logs delta ou dos arquivos individuais, passe o mouse sobre a pasta ou sobre o arquivo e, em seguida, selecione o menu Mais [...]>Propriedades.

• Como realizar a exibição dos arquivos na pasta de logs delta:

  1. Selecione a pasta _delta_log.
  2. Selecione um arquivo para exibir os metadados e o esquema da tabela. O editor que é aberto está no formato somente leitura.

Mapeamento de tipos de dados

Mapeamento de tipos de dados do Event house o Delta Parquet

Tipos de dados do Event house são mapeados para tipos de dados Delta Parquet usando as regras a seguir. Para obter mais informações sobre tipos de dados do Event house, consulte Tipos de dados escalares.

Tipo de dados do Event house	Tipo de dados Delta
bool	boolean
datetime	timestamp OR date (for date-bound partition definitions)
dynamic	string
guid	string
int	integer
long	long
real	double
string	string
timespan	long
decimal	decimal(38,18)

Conteúdo relacionado

• Para expor os dados no OneLake, confira Criar um atalho no OneLake
• Para criar um atalho do OneLake no Lakehouse, confira O que são atalhos na lakehouse?
• Para consultar dados referenciados do OneLake em seu banco de dados ou tabela KQL, consulte Criar um atalho do OneLake no Banco de dados KQL