이 문서에서는 Spanner 데이터베이스에 사전 정의된 MySQL 함수 라이브러리를 설치하는 방법을 설명합니다. Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 이러한 함수를 데이터베이스에 추가할 수 있습니다.
이러한 MySQL 함수를 설치하면 Spanner의 기능이 확장되어 MySQL 환경에서 일반적인 작업을 Spanner 내에서 직접 실행할 수 있습니다.
Spanner에서 지원하는 MySQL 함수에 대한 자세한 내용은 MySQL 함수를 참고하세요.
필요한 역할
MySQL 함수를 설치하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Cloud Spanner 데이터베이스 관리자 (roles/spanner.databaseAdmin
) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
MySQL 사용자 정의 함수 설치
다음과 같은 방법으로 Spanner 데이터베이스에 MySQL 사용자 정의 함수를 설치할 수 있습니다.
Google Cloud 콘솔
Google Cloud 콘솔에서 Spanner 인스턴스 페이지로 이동합니다.
데이터베이스가 포함된 인스턴스를 클릭합니다.
데이터베이스를 클릭합니다.
DDL 작성 버튼을 클릭하여 Spanner Studio를 엽니다.
mysql_udfs.sql
파일에서 DDL 파일의 전체 콘텐츠를 복사합니다.SQL 편집기 탭에 DDL 파일에서 복사한 콘텐츠를 붙여넣습니다.
실행을 클릭합니다.
gcloud
gcloud spanner database ddl update
명령어를 사용하여 MySQL UDF를 설치할 수 있습니다.
아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.
- DATABASE_ID: MySQL UDF를 추가할 데이터베이스의 ID입니다.
- INSTANCE_ID: 데이터베이스가 있는 인스턴스의 ID입니다.
-
DDL_FILE_PATH: mysql_udfs.sql 파일에 있는 모든
CREATE OR REPLACE FUNCTION
문이 포함된 파일의 경로입니다.
다음 명령어를 실행합니다.
Linux, macOS 또는 Cloud Shell
gcloud spanner databases ddl update DATABASE_ID \ --instance=INSTANCE_ID \ --ddl-file=DDL_FILE_PATH
Windows(PowerShell)
gcloud spanner databases ddl update DATABASE_ID ` --instance=INSTANCE_ID ` --ddl-file=DDL_FILE_PATH
Windows(cmd.exe)
gcloud spanner databases ddl update DATABASE_ID ^ --instance=INSTANCE_ID ^ --ddl-file=DDL_FILE_PATH
다음 단계
- Spanner에서 지원하는 모든 MySQL 사용자 정의 함수에 대해 알아봅니다.