이 문서 집합에서는 Azure Functions에서 Azure Database for MySQL 바인딩을 사용하는 방법을 설명합니다. Azure Functions는 일반 공급에서 입력 바인딩 및 출력 바인딩을 지원합니다. 미리 보기의 경우 Azure Functions는 Azure Database for MySQL에 대한 트리거 바인딩을 지원합니다.
| 작업 | 유형 |
|---|---|
| 데이터베이스에서 데이터 읽기 | 입력 바인딩 |
| 데이터베이스에 데이터 저장 | 출력 바인딩 |
| MySQL 테이블에서 변경 내용이 검색되면 함수 트리거(미리 보기) | 트리거 바인딩 |
익스텐션 설치
설치하는 확장 NuGet 패키지는 함수 앱에서 사용하는 C# 모드에 따라 달라집니다.
Functions는 격리된 C# 작업자 프로세스에서 실행됩니다. 자세한 내용은 격리된 작업자 프로세스에서 C# Azure 함수를 실행하기 위한 가이드를 참조하세요.
이 NuGet 패키지를 설치하여 프로젝트에 확장을 추가합니다.
dotnet add package Microsoft.Azure.Functions.Worker.Extensions.MySql --version 1.0.3-preview
번들 설치
Azure Database for MySQL 바인딩에 대한 확장은 v4 확장 번들의 일부입니다. 이 번들은 host.json 프로젝트 파일에 지정됩니다.
미리 보기 번들 v4.x
host.json 파일에서 다음 코드를 추가하거나 바꿔 미리 보기 확장 번들을 사용할 수 있습니다.
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
"version": "[4.*, 5.0.0)"
}
}
번들 설치
Azure Database for MySQL 바인딩에 대한 확장은 v4 확장 번들의 일부입니다. 이 번들은 host.json 프로젝트 파일에 지정됩니다.
미리 보기 번들 v4.x
host.json 파일에서 다음 코드를 추가하거나 바꿔 미리 보기 확장 번들을 사용할 수 있습니다.
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
"version": "[4.*, 5.0.0)"
}
}
번들 설치
Azure Database for MySQL 바인딩에 대한 확장은 v4 확장 번들의 일부입니다. 이 번들은 host.json 프로젝트 파일에 지정됩니다.
미리 보기 번들 v4.x
host.json 파일에서 다음 코드를 추가하거나 바꿔 미리 보기 확장 번들을 사용할 수 있습니다.
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
"version": "[4.*, 5.0.0)"
}
}
패키지 업데이트
다음 코드 조각과 같이 Java Azure Functions 프로젝트의 pom.xml 파일에 대한 업데이트와 함께 미리 보기 확장 번들을 사용할 수 있습니다.
<dependency>
<groupId>com.microsoft.azure.functions</groupId>
<artifactId>azure-functions-java-library-mysql</artifactId>
<version>1.0.1-preview</version>
</dependency>
MySQL 연결 문자열
Azure Functions용 Azure Database for MySQL 바인딩에는 연결 문자열에 필요한 속성이 있습니다. 이러한 바인딩은 연결 문자열을 MySql.Data.MySqlClient 라이브러리에 전달하고 MySqlClient ConnectionString 설명서에 정의된 대로 지원을 제공합니다. 주목할 만한 키워드는 다음과 같습니다.
-
server: 서버 인스턴스가 실행 중인 호스트입니다. 값은 호스트 이름, IPv4 주소 또는 IPv6 주소일 수 있습니다. -
uid: 인증 프로세스를 위해 제공할 MySQL 사용자 계정입니다. -
pwd: 인증 프로세스에 사용할 암호입니다. -
database: 연결의 기본 데이터베이스입니다. 데이터베이스를 지정하지 않으면 연결에 기본 데이터베이스가 없습니다.
고려 사항
- Azure Database for MySQL 바인딩은 Azure Functions 런타임 버전 4.x 이상을 지원합니다.
- 이 GitHub 리포지토리에서 Azure Database for MySQL 바인딩에 대한 소스 코드를 찾을 수 있습니다.
- 이러한 바인딩을 사용하려면 Azure Database for MySQL에 연결해야 합니다.
- 공간 데이터 형식
GEOMETRYPOINT의 열이 있는 테이블에 대한 출력 바인딩은POLYGON지원되지 않습니다. 데이터 업서트가 실패합니다.
샘플
Azure Database for MySQL 바인딩용 GitHub 리포지토리에서 사용할 수 있는 C#, Java, JavaScript, PowerShell 및 Python에 대한 샘플 외에도 Azure 샘플에서 더 많이 사용할 수 있습니다.