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á duas maneiras de usar notebooks do Fabric com dados do banco de dados KQL:
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
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.
Navegue até um notebook existente ou crie um novo.
Em uma célula de código, comece a digitar kusto.
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()
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 base de dados O nome do banco de dados KQL. Acessar um banco de dados KQL existente dados Os dados a serem gravados na tabela. 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.
Navegue até o banco de dados KQL.
Selecione Novo item relacionado>Notebook.
Um notebook é criado com os detalhes de KustoUri e do banco de dados pré-preenchidos.
Insira a consulta KQL a ser avaliada no campo kustoQuery.
Executar a célula de código.