Usar blocos de anotações de malha com dados de um banco de dados KQL

Os blocos de notas são documentos legíveis que contêm descrições e resultados da análise de dados 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 a linguagem nativa KQL (Kusto Query Language) . Para obter mais informações sobre blocos de anotações, consulte Como usar blocos de anotações do Microsoft Fabric.

Existem algumas formas de usar notebooks Fabric com dados da tua base de dados KQL:

Pré-requisitos

Carregar dados da base de dados KQL a partir do catálogo OneLake

As bases de dados KQL no catálogo do OneLake estão disponíveis como fontes de dados no ambiente de notebooks. Podes adicionar uma base de dados KQL como fonte de dados ao teu caderno e depois consultá-la nas células de código para executar consultas KQL contra ela.

  1. No seu Espaço de Trabalho, navegue até um caderno existente ou crie um novo.

  2. No painel Explorador do Notebook, selecione Adicionar itens de dados e, em seguida, selecione Do catálogo do OneLake.

    Captura de ecrã de um bloco de notas com o painel Explorador aberto no separador Itens de dados. O botão Adicionar itens de dados está expandido e a opção para selecionar a partir do catálogo OneLake está destacada.

  3. No catálogo OneLake, navegue até à sua base de dados KQL. Pode encontrá-lo na Event House a que pertence, pode filtrar a lista por tipo e selecionar o tipo de base de dados KQL, ou procurá-lo pelo nome.

    Captura de ecrã do filtro do catálogo OneLake, com um filtro da base de dados KQL destacado.

  4. A base de dados KQL é adicionada sob o OneLake no painel do explorador do bloco de notas.

    1. Expanda a base de dados para ver as tabelas dentro dela.

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

      Captura de ecrã de uma base de dados KQL expandida para mostrar as respetivas tabelas. O menu Mais de uma tabela é expandido para mostrar a opção Carregar dados.

  5. Os dados da tabela são carregados numa nova célula de código no caderno, e uma ligação à base de dados KQL é automaticamente estabelecida. Pode então executar a célula de código para consultar os dados e devolver resultados dentro do seu caderno.

    Captura de ecrã do Notebook depois de os dados da base de dados KQL terem sido carregados. O excerto do código está destacado.

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

Usar trechos do Kusto em um bloco de anotações

Os notebooks de Fabric fornecem trechos de código que ajudam a escrever facilmente padrões de código comum. Você pode usar trechos para escrever ou ler dados em um banco de dados KQL usando o KQL.

  1. Navegue até um bloco de anotações existente ou crie um novo.

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

    Captura de tela do uso de um trecho de Kusto para usar o KQL em um notebook Fabric.

  3. Selecione o trecho 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 trecho 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 o exemplo de operação de gravação de dados:

    # 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 entre aspas de cada campo na célula de dados:

    Campo Descrição Ligações úteis
    kustoQuery A consulta KQL a ser avaliada. Visão geral do KQL
    KustoUri O URI de consulta do seu banco de dados KQL. Copiar um URI de banco de dados KQL
    base de dados O nome do seu 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 bloco de notas a partir de uma base de dados KQL

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

  1. Navegue até a sua base de dados KQL.

  2. Selecione Novo item relacionado>Bloco de Anotações.

    Captura de ecrã da criação de um bloco de anotações como um item relacionado em um banco de dados KQL.

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

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

    Captura de ecrã de um notebook criado a partir de uma base de dados do KQL.

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

Conteúdo relacionado

  • Last updated on