Usar notebooks do Fabric com dados de um banco de dados KQL

Os notebooks são documentos legíveis que contêm descrições de análise de dados e resultados e documentos executáveis que podem ser executados para executar a análise de dados. Neste artigo, você aprenderá a usar um notebook do Fabric para se conectar a dados em um Banco de dados KQL e executar consultas usando KQL (Linguagem de Consulta Kusto) nativa. Para obter mais informações sobre notebooks, consulte Como usar notebooks do Microsoft Fabric.

Há algumas maneiras de usar Fabric notebooks com dados do banco de dados KQL:

• Carregar dados do banco de dados KQL do catálogo do OneLake
• Usar trechos de código Kusto em um notebook
• Criar um notebook a partir de um banco de dados KQL
• Analisar dados em um Banco de Dados KQL com um notebook novo ou existente.

Pré-requisitos

• Um workspace com uma capacidade habilitada para o Microsoft Fabric
• Um banco de dados KQL com pelo menos permissões de exibição

Carregar dados do banco de dados KQL do catálogo do OneLake

Os bancos de dados KQL no catálogo do OneLake estão disponíveis como fontes de dados no ambiente do notebook. Você pode adicionar um banco de dados KQL como uma fonte de dados ao seu notebook e, em seguida, referenciá-lo em suas células de código para executar consultas KQL nele.

1. Em seu Workspace, navegue até um bloco de anotações existente ou crie um novo.

2. No painel Explorador do Bloco de Anotações, selecione Adicionar itens de dados e, em seguida, selecione Do catálogo do OneLake.

   

3. No catálogo do OneLake, navegue até o banco de dados KQL. Você pode encontrá-lo no Eventhouse ao qual ele pertence, você pode filtrar a lista por tipo e selecionar o tipo de Banco de Dados KQL ou pesquisá-la por nome.

   

4. O banco de dados KQL é adicionado ao OneLake no painel Explorador do notebook.

   1. Expanda o banco de dados para ver as tabelas dentro dele.

   2. Passe o mouse sobre uma tabela, selecione o menu mais ... e selecione Carregar dados.

      

5. Os dados da tabela são carregados em uma nova célula de código no notebook e uma conexão com o banco de dados KQL é estabelecida automaticamente. Em seguida, você pode executar a célula de código para consultar os dados e retornar resultados em seu notebook.

   

Para obter mais informações sobre a experiência do notebook com dados KQL e as opções de análise de dados, consulte xxxxxxxx.

Usar trechos de código Kusto em um notebook

Os notebooks do Fabric fornecem trechos de código que ajudam você a escrever facilmente padrões de código usados com frequência. Você pode usar trechos de código para gravar ou ler dados em um banco de dados KQL usando KQL.

1. Navegue até um notebook existente ou crie um novo.

2. Em uma célula de código, comece a digitar kusto.

   

3. Selecione o snippet de código que corresponde à operação que você deseja executar: Gravar dados em um banco de dados KQL ou Ler dados de um banco de dados KQL.

   O snippet de código a seguir mostra a operação de leitura de dados de exemplo:

   # Example of query for reading data from Kusto. Replace T with your <tablename>.
   kustoQuery = "['T'] | take 10"
   # The query URI for reading the data e.g. https://<>.kusto.data.microsoft.com.
   kustoUri = "https://<yourKQLdatabaseURI>.z0.kusto.data.microsoft.com"
   # The database with data to be read.
   database = "DocsDatabase"
   # The access credentials.
   accessToken = mssparkutils.credentials.getToken('kusto')
   kustoDf  = spark.read\
       .format("com.microsoft.kusto.spark.synapse.datasource")\
       .option("accessToken", accessToken)\
       .option("kustoCluster", kustoUri)\
       .option("kustoDatabase", database)\
       .option("kustoQuery", kustoQuery).load()
   
   # Example that uses the result data frame.
   kustoDf.show()
   

   O trecho de código a seguir mostra a operação de gravação de dados como exemplo:

   # The Kusto cluster uri to write the data. The query Uri is of the form https://<>.kusto.data.microsoft.com 
   kustoUri = ""
   # The database to write the data
   database = ""
   # The table to write the data 
   table    = ""
   # The access credentials for the write
   accessToken = mssparkutils.credentials.getToken('kusto')
   
   # Generate a range of 5 rows with Id's 5 to 9
   data = spark.range(5,10) 
   
   # Write data to a Kusto table
   data.write.\
   format("com.microsoft.kusto.spark.synapse.datasource").\
   option("kustoCluster",kustoUri).\
   option("kustoDatabase",database).\
   option("kustoTable", table).\
   option("accessToken", accessToken ).\
   option("tableCreateOptions", "CreateIfNotExist").mode("Append").save()
   

4. Insira as informações necessárias nas aspas de cada campo na célula de dados:

   Campo	Descrição	Links relacionados
   kustoQuery	A consulta KQL a ser avaliada.	Visão geral de KQL
   KustoUri	O URI de consulta do banco de dados KQL.	Copiar o URI do banco de dados KQL
   banco de dados	O nome do banco de dados KQL.	Acessar um banco de dados KQL existente
   dados	Os dados a serem gravados na tabela.

5. Execute a célula de código.

Criar um notebook a partir de um banco de dados KQL

Quando você cria um notebook como um item relacionado em um banco de dados KQL, o notebook recebe o mesmo nome do banco de dados KQL e é pré-preenchido com informações de conexão.

1. Navegue até o banco de dados KQL.

2. Selecione Novo item relacionado>Notebook.

   

   Um notebook é criado com os detalhes de KustoUri e do banco de dados pré-preenchidos.

3. Insira a consulta KQL a ser avaliada no campo kustoQuery.

   

4. Execute a célula de código.

Conteúdo relacionado

• Visão geral de KQL
• Como usar os cadernos do Microsoft Fabric
• Analisar dados em um banco de dados KQL