이 페이지에서는 PowerShell용 Cloud Tools를 사용하여 새로운 Cloud SQL 인스턴스를 설정하는 방법을 설명합니다. cmdlet에 대한 자세한 내용은 PowerShell용 Cloud Tools cmdlet 참조를 읽어보세요.
대부분의 cmdlet에 프로젝트 ID를 지정할 수 있지만 이를 생략할 경우 PowerShell의 기본값은 활성 gcloud CLI 구성에 지정된 값입니다.
새 인스턴스 설정
Cloud SQL 인스턴스는 클라우드에서 실행되는 MySQL 데이터베이스입니다. Cloud SQL 인스턴스를 사용하여 MySQL 데이터베이스를 저장, 복제, 보호할 수 있습니다. 데이터가 언제 어디에서 복제되는지, 또는 데이터 유지관리를 언제 수행할 수 있는지와 같은 인스턴스의 동작을 구성할 수 있습니다.
Cloud SQL 데이터베이스를 만들고 시작하려면 먼저 구성 및 설정을 지정해야 합니다. PowerShell용 Cloud Tools를 사용하여 이를 수행하려면 New-GcSqlSettingConfig 및 New-GcSqlInstanceConfig cmdlet을 사용합니다.
로깅, 유지보수 기간 등의 SQL 설정은 New-GcSqlSettingConfig cmdlet의 매개변수입니다. 데이터베이스 머신의 하드웨어 특성과 같은 인스턴스 수준 설정은 SqlInstanceConfig 객체 또는 New-GcSqlInstanceConfig cmdlet의 플래그를 통해 설정됩니다.
매개변수를 지정하지 않으면 'db-n1-standard-1' 계층을 사용하여 가장 기본적인 Cloud SQL 인스턴스가 만들어집니다.
$setting = New-GcSqlSettingConfig
$instance = New-GcSqlInstanceConfig `
"mynewinstance" -SettingConfig $setting
계층 및 가격 책정에 대한 자세한 내용은 Cloud SQL 가격 책정 항목을 참조하세요.
구성 옵션에 대한 자세한 내용은 Get-Help New-GcSqlSettingConfig를 사용하거나 DatabaseInstance 객체 문서를 참조하세요.
새 인스턴스 만들기
이전 섹션에서 설명한 구성과 설정을 수행했으면 이제 Add-GcSqlInstance cmdlet을 사용하여 Cloud SQL 데이터베이스를 만들 수 있습니다.
Add-GcSqlInstance $instance
새 인스턴스를 만드는 데 1분 이상이 걸릴 수 있습니다. 프로세스가 완료되면 cmdlet은 방금 생성된 인스턴스를 설명하는 DatabaseInstance 객체를 반환합니다. Google Cloud 콘솔로 이동하여 인스턴스를 확인할 수 있습니다.
이제부터 Cloud SQL 문서에 설명된 대로 데이터베이스를 관리할 수 있습니다.
읽기 복제본 인스턴스 만들기
읽기 복제본 인스턴스는 마스터 인스턴스의 데이터에 대한 복제 기능을 제공합니다. 이 인스턴스는 생성 후에 장애 조치로 또는 자체 독립형 인스턴스로 만들 수 있습니다. 읽기 복제본 인스턴스에서 데이터를 읽을 수 있지만 일부 동기 복제에 따라 이러한 데이터가 최신이 아닐 수 있습니다. 읽기 복제본 인스턴스를 통해 데이터를 여러 지역에 백업하면 장애가 발생해도 계속 데이터를 읽을 수 있습니다.
다음 코드 스니펫은 이미 존재하는 마스터 인스턴스 mynewreplica의 읽기 복제본 mynewreplica를 만듭니다. 스니펫은 cmdlet New-GcSqlInstanceReplicaConfig를 사용합니다. 이는 읽기 복제본 인스턴스의 설정(예: 데이터를 복제하는 속도, 외부 인스턴스에서 복제하는지 여부)을 구성합니다.
$setting = New-GcSqlSettingConfig "db-n1-standard-1"
$replicaConfig = New-GcSqlInstanceReplicaConfig
$instance = New-GcSqlInstanceConfig "mynewreplica" `
-SettingConfig $setting `
-ReplicaConfig $replicaConfig `
-MasterInstanceName "gootoso"
Add-GcSqlInstance $instance읽기 복제본 인스턴스에 대한 자세한 내용은 복제 구성에 관한 요구사항 및 도움말을 참조하세요.
읽기 복제본을 장애 조치 또는 독립형 인스턴스로 승급하는 방법의 설명은 인스턴스 복제 관리를 참조하세요.
장애 조치 복제본 인스턴스 만들기
Cloud SQL은 장애 조치 복제본을 사용하여 인스턴스의 고가용성 구성을 제공합니다. 장애 조치 복제본은 마스터 인스턴스에 있는 데이터의 모든 변경사항을 복제하기 위해 일부 동기 복제를 사용합니다. 마스터 인스턴스의 영역에 장애가 발생하면 장애 조치 복제본이 활성화되어 제어를 시작합니다. 이러한 이유로 복제본은 마스터와 다른 영역에 있어야 합니다.
다음 코드 스니펫은 마스터 인스턴스 gootoso에 대한 새 장애 조치 복제본 myfailover를 만듭니다. 이 복제본 인스턴스는 config cmdlet를 사용하여 위와 동일한 방식으로 만들어집니다. 하지만 -FailoverTarget 플래그가 추가됩니다.
$setting = New-GcSqlSettingConfig "db-n1-standard-1"
$replicaConfig = New-GcSqlInstanceReplicaConfig -FailoverTarget
$instance = New-GcSqlInstanceConfig "myfailover" `
-SettingConfig $setting `
-ReplicaConfig $replicaConfig `
-MasterInstanceName "gootoso"
Add-GcSqlInstance $instance복제본 인스턴스는 일반적인 인스턴스와 동일한 방식으로 청구에 영향을 미칩니다.