Criar um banco de dados KQL

No Real-Time Intelligence, você interage com seus dados no contexto de casas de eventos, bancos de dados e tabelas. Um único espaço de trabalho pode conter várias Eventhouses, uma casa de eventos pode conter vários bancos de dados e cada banco de dados pode conter várias tabelas.

Neste artigo, você aprenderá a criar um novo banco de dados KQL. Uma vez que seu banco de dados KQL tenha dados, você pode continuar a consultar seus dados usando Kusto Query Language em um conjunto de consultas KQL.

Pré-requisitos

Criar um novo banco de dados KQL

  1. Para criar um novo banco de dados KQL, no explorador do Eventhouse:

    • Selecione Eventhouse e, em seguida, Novo banco de dados +

    • Em Bases de Dados KQL, selecione +

      Captura de tela mostrando a seção Bancos de dados KQL da casa de eventos.

  2. Insira o nome do banco de dados, selecione o tipo de banco de dados, Novo banco de dados (padrão) ou Novo banco de dados de atalho (seguidor) e selecione Criar. Para obter informações sobre bancos de dados de seguidores, consulte Criar um atalho de banco de dados.

    Nota

    O nome do banco de dados pode conter caracteres alfanuméricos, sublinhados, pontos e hífenes. Não há suporte para caracteres especiais.

    Captura de tela da janela Novo banco de dados KQL mostrando o nome do banco de dados. O botão Criar é realçado.

O banco de dados KQL é criado dentro do contexto da casa de eventos selecionada.

Explore a sua base de dados KQL

Quando você cria um novo banco de dados KQL, um ambiente anexado é criado automaticamente para explorar e gerenciar o banco de dados KQL usando consultas KQL. Para obter mais informações, consulte Visão geral do KQL.

  1. Para acessar o ambiente de consulta, selecione KQLdatabasename_queryset na árvore de objetos do banco de dados KQL.

    Captura de tela do novo conjunto de consultas KQL anexado a um banco de dados KQL.

  2. Para renomear o ambiente de consulta, selecione o ícone de lápis ao lado de seu nome e insira um novo nome.

    Captura de tela da janela Renomear conjunto de consultas mostrando o nome do conjunto de consultas e o ícone Lápis.

Detalhes da base de dados

A página principal do seu banco de dados KQL mostra uma visão geral do conteúdo do seu banco de dados. As tabelas a seguir listam as informações disponíveis nos painéis de informações central e direito.

Captura de tela da página principal do banco de dados KQL mostrando os cartões de detalhes do banco de dados.

Detalhes do painel direito do banco de dados

O painel de informações correto exibe os detalhes do banco de dados selecionado.

Card Item Description
Tamanho
Comprimidos Tamanho total dos dados comprimidos.
Tamanho original Tamanho total dos dados não comprimidos.
OneLago
Disponibilidade Defina a disponibilidade do OneLake como Ativado ou Desativado. Quando a disponibilidade do OneLake está ativada, as tabelas não podem ser renomeadas.
Latência O tempo máximo até que os dados estejam disponíveis em todas as tabelas no OneLake.
Número da tabela O número de tabelas disponíveis no OneLake.
Pasta OneLake Caminho da pasta OneLake que pode ser usado para criar atalhos.
Descrição geral
Criado por O nome de usuário da pessoa que criou o banco de dados, se disponível, e a data de criação do banco de dados.
País/Região Mostra a região onde sua capacidade está hospedada. Para obter mais informações, consulte Disponibilidade da região de malha.
URI de consulta O URI usado para executar consultas ou comandos de gerenciamento.
URI de ingestão A data da última ingestão de dados e o URI que pode ser usado para obter dados.
Política de Colocação em Cache O período de tempo durante o qual os dados são armazenados em cache e mantidos no armazenamento SSD local. Para obter mais informações, consulte Política de cache.
Política de Retenção O período de tempo após o qual os dados são removidos automaticamente de tabelas ou exibições materializadas. Para obter mais informações, consulte Política de retenção de dados.

Painel de informações do centro de banco de dados

O painel de informações do banco de dados central representa um histograma dos dados de ingestão, informações de tabela e um meio de visualizar as informações de ingestão do banco de dados.

Card Item Description
Histograma
Número de linhas O número de linhas carregadas no banco de dados no intervalo de tempo selecionado.
Última execução A hora em que o histograma foi gerado pela última vez.
Intervalo Defina o intervalo da exibição do histograma. Estabeleça intervalos de uma hora, seis horas, um dia, três dias, sete dias e 30 dias.
Atualizar Atualize o histograma.
Histograma O histograma de ingestão exibe os dados pelo intervalo escolhido. O intervalo é calculado por um dia de tempo universal coordenado completo (UTC), mas é exibido de acordo com a hora local.
Tabelas
Procurar tabela Procure uma tabela de banco de dados.
Nova tabela Criar uma nova tabela
Exibição de tabelas Veja as informações da tabela por Cartões ou por Vista de Lista .

Os cartões e a exibição de lista exibem o nome da tabela, o tamanho compactado, a Última ingestão e a disponibilidade ou latência do OneLake.

Os cartões exibem exclusivamente um histograma da ingestão do banco de dados nos últimos sete dias, o número de linhas ingeridas na última ingestão e o perfil do criador da tabela.

A exibição do modo de exibição de lista também mostra a contagem total de linhas, o cache e a retenção.
Pré-visualização de dados
Pré-visualização de dados Mostra uma visualização dos últimos 100 registros ingeridos para cada tabela. Exibe o tempo de ingestão, TableName e Record. Selecione Colunas para selecionar colunas e valores para uma vista dinâmica.

Detalhes da tabela

Selecione uma tabela em seu banco de dados KQL para ver uma visão geral da tabela. As tabelas a seguir listam as informações disponíveis nos painéis de informações central e direito.

Detalhes do painel direito da tabela

O painel de informações correto exibe os detalhes da tabela selecionada.

Card Item Description
Tamanho
Comprimidos Tamanho total dos dados comprimidos.
Tamanho original Tamanho total dos dados não comprimidos.
OneLago
Disponibilidade Defina a disponibilidade do OneLake como Ativado ou Desativado. Quando a disponibilidade do OneLake está ativada, as tabelas não podem ser renomeadas.
Latência O tempo máximo até que os dados da tabela estejam disponíveis no OneLake.
Uma vez que A hora de início a partir de quando a disponibilidade é registrada.
Pasta OneLake Caminho da pasta OneLake que pode ser usado para criar atalhos.
Descrição geral
Contagem de linhas O número de linhas na tabela.
Linhas ingeridas últimas 24 h O número de linhas ingeridas nas últimas 24 horas.
Esquema alterado pela última vez por Quando o esquema foi alterado pela última vez e por quem.
URI de ingestão A data da última ingestão de dados e o URI que pode ser usado para obter dados.
Política de Colocação em Cache O período de tempo durante o qual os dados são armazenados em cache e mantidos no armazenamento SSD local. Para obter mais informações, consulte Política de cache.
Política de Retenção O período de tempo após o qual os dados são removidos automaticamente de tabelas ou exibições materializadas. Para obter mais informações, consulte Política de retenção de dados.

Painel de informações do centro de tabela

O painel de informações do banco de dados central representa um histograma dos dados de ingestão, informações de tabela e um meio de visualizar as informações de ingestão do banco de dados.

Card Item Description
Histograma
Número de linhas O número de linhas ingeridas no banco de dados.
Última execução A hora em que o histograma foi gerado pela última vez.
Intervalo Defina o intervalo da exibição do histograma. Defina intervalos de uma hora, seis horas, um dia, três dias, sete dias e intervalos de 30 dias. O intervalo é calculado por um dia de tempo universal coordenado completo (UTC), mas é exibido de acordo com a hora local.
Atualizar Atualize o histograma.
Histograma O histograma de ingestão exibe os dados pelo intervalo escolhido.
Pré-visualização de dados
Consulta rápida Mostra uma pré-visualização dos resultados da ingestão da tabela. Exibe o tempo de ingestão, TableName e Record. Selecione Colunas para selecionar colunas e valores para uma vista dinâmica.
Insights do esquema
Colunas Para cada coluna de uma tabela, mostra informações sobre valores de coluna, como intervalos de datas, valores mínimos e máximos ou o número de valores exclusivos.
Top 10 Selecione uma coluna listada na seção Colunas para exibir os 10 principais valores dessa coluna.

Captura de ecrã da página da tabela KQL a mostrar os cartões de detalhes da tabela.