Compartilhar via


Visão geral das associações do Banco de Dados do Azure para MySQL para o Azure Functions

Este conjunto de artigos explica como trabalhar com associações do Banco de Dados do Azure para MySQL no Azure Functions. O Azure Functions dá suporte a associações de entrada, associações de saída e associações de gatilho em disponibilidade geral para o Banco de Dados do Azure para MySQL

Ação Tipo
Ler dados de um banco de dados Associação de entrada
Salvar dados em um banco de dados Associação de saída
Disparar uma função quando uma alteração é detectada em uma tabela MySQL Associação de gatilho

Instalar a extensão

O pacote NuGet de extensão que você instala depende do modo C# que você está usando em seu aplicativo de funções:

As funções são executadas em um processo de trabalho C# isolado. Para saber mais, consulte Guia para executar funções do Azure em C# em um processo de trabalho isolado.

Adicione a extensão ao seu projeto instalando este pacote do NuGet.

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.MySql --version 1.0.129

Instalar o pacote

A extensão das associações do Banco de Dados do Azure para MySQL faz parte do pacote de extensão v4. Esse pacote é especificado em seu arquivo de projeto host.json.

Pacote v4.x

Você pode usar o pacote de extensão adicionando ou substituindo o seguinte código no arquivo host.json:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}

Instalar o pacote

A extensão das associações do Banco de Dados do Azure para MySQL faz parte do pacote de extensão v4. Esse pacote é especificado em seu arquivo de projeto host.json.

Pacote v4.x

Você pode usar o pacote de extensão adicionando ou substituindo o seguinte código no arquivo host.json:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}

Instalar o pacote

A extensão das associações do Banco de Dados do Azure para MySQL faz parte do pacote de extensão v4. Esse pacote é especificado em seu arquivo de projeto host.json.

Pacote v4.x

Você pode usar o pacote de extensão adicionando ou substituindo o seguinte código no arquivo host.json:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}

Atualizar pacotes

Você pode usar o pacote de extensão com uma atualização para o arquivo pom.xml em seu projeto do Java Azure Functions, conforme mostrado no seguinte snippet de código:

<dependency>
<groupId>com.microsoft.azure.functions</groupId>
<artifactId>azure-functions-java-library-mysql</artifactId>
<version>1.0.2</version>
</dependency>

Cadeia de conexão de MySQL

As associações do Banco de Dados do Azure para MySQL para o Azure Functions têm uma propriedade necessária para a cadeia de conexão. Essas associações passam a cadeia de conexão para a biblioteca MySql.Data.MySqlClient e fornecem suporte conforme definido na documentação do MySqlClient ConnectionString. Palavras-chave notáveis incluem:

  • server: o host no qual a instância do servidor está em execução. O valor pode ser um nome de host, endereço IPv4 ou endereço IPv6.
  • uid: a conta de usuário do MySQL a ser fornecida para o processo de autenticação.
  • pwd: a senha a ser usada para o processo de autenticação.
  • database: o banco de dados padrão para a conexão. Se nenhum banco de dados for especificado, a conexão não terá nenhum banco de dados padrão.

Considerações

  • As associações do Banco de Dados do Azure para MySQL dão suporte à versão 4.x e posterior do runtime do Azure Functions.
  • Você pode encontrar o código-fonte para as associações do Banco de Dados do Azure para MySQL neste repositório GitHub.
  • Essas associações exigem conectividade com o Banco de Dados do Azure para MySQL.
  • Associações de saída em tabelas com colunas de tipos GEOMETRYPOINTde dados espaciais e POLYGON sem suporte. Falha nos upserts de dados.

Amostras

Além dos exemplos de C#, Java, JavaScript, PowerShell e Python disponíveis no repositório GitHub para associações do Banco de Dados do Azure para MySQL, mais estão disponíveis em Exemplos do Azure.