인스턴스 만들기

콘솔

1. Google Cloud 콘솔의 Cloud SQL 인스턴스 페이지로 이동합니다.

   Cloud SQL 인스턴스로 이동

2. 인스턴스 만들기를 클릭합니다.
3. 인스턴스 만들기 페이지의 데이터베이스 엔진 선택 패널에서 SQL Server 선택을 클릭합니다.

4. SQL Server 인스턴스 만들기 페이지의 Cloud SQL 버전 선택 섹션에서 인스턴스의 Cloud SQL 버전(Enterprise 또는 Enterprise plus)을 선택합니다.

   Cloud SQL 버전에 대한 자세한 내용은 SQL 서버용 Cloud SQL 버전 소개를 참고하세요.

5. 인스턴스의 버전 사전 설정을 선택합니다. 사용 가능한 사전 설정을 보려면 버전 사전 설정 메뉴를 클릭합니다.
6. 인스턴스 정보 섹션에서 인스턴스의 데이터베이스 버전을 선택합니다. 사용 가능한 버전을 보려면 데이터베이스 버전 메뉴를 클릭합니다.
7. 인스턴스 ID 필드에 인스턴스 ID를 입력합니다.

   인스턴스 이름에 프로젝트 ID를 포함하지 않아도 됩니다. 필요한 경우 자동으로 포함됩니다(예: 로그 파일에서).

8. 비밀번호 필드에 사용자의 비밀번호를 입력합니다.
9. 리전 및 영역 가용성 선택 섹션에서 인스턴스의 리전 및 영역을 선택합니다.

   인스턴스를 인스턴스에 액세스하는 리소스와 같은 리전에 배치합니다. 선택한 리전은 나중에 수정할 수 없습니다. 대부분의 경우 영역을 지정할 필요가 없습니다.

10. 인스턴스 맞춤설정 섹션에서 인스턴스의 설정을 업데이트합니다. 예를 들어 실수로 인한 인스턴스 삭제를 방지할 수 있습니다.
11. 인스턴스 만들기를 클릭합니다.
12. 인스턴스의 초기화 프로세스가 완료되면 인스턴스 이름을 클릭하여 엽니다.

gcloud

gcloud CLI 설치 및 시작에 대한 자세한 내용은 gcloud CLI 설치를 참조하세요. Cloud Shell 시작에 대한 자세한 내용은 Cloud Shell 문서를 참조하세요.

gcloud 버전 243.0.0 이상을 사용해야 합니다.

실수로 인한 인스턴스 삭제를 보호하는 방법은 인스턴스 삭제 방지를 참조하세요.

1. 인스턴스를 만듭니다.
   Cloud SQL Enterprise Plus 버전 인스턴스의 경우:

   gcloud sql instances create INSTANCE_NAME \
   --database-version=DATABASE_VERSION \
   --region=REGION \
   --tier=TIER \
   --root-password=ROOT_PASSWORD \
   --edition=ENTERPRISE_PLUS

   Cloud SQL Enterprise 버전 인스턴스의 경우:

   gcloud sql instances create INSTANCE_NAME \
   --database-version=DATABASE_VERSION \
   --region=REGION \
   --cpu=NUMBER_OF_vCPUs \
   --memory=MEMORY_SIZE \
   --root-password=ROOT_PASSWORD \
   --edition=ENTERPRISE

   인스턴스 이름에 프로젝트 ID를 포함하지 않아도 됩니다. 필요한 경우 자동으로 포함됩니다(예: 로그 파일에서).

   페이지 앞부분에서 설명한 것처럼 Cloud SQL Enterprise 버전의 경우 vCPU 및 메모리 크기 값이 제한됩니다. Cloud SQL Enterprise Plus 버전과 Cloud SQL Enterprise 버전 중에서 선택하기를 참고하세요.

   예를 들어 다음 문자열은 vCPU가 2개 있고 메모리가 7,680MB인 인스턴스를 만듭니다.

   gcloud sql instances create myinstance \
   --database-version=SQLSERVER_2017_STANDARD \
   --region=us-central1 \
   --cpu=2 \
   --memory=7680MB \
   --root-password=EXAMPLE_PASSWORD \
   --edition=ENTERPRISE

   샘플 값을 보려면 샘플 머신 유형을 참조하세요.

   인스턴스 설정의 매개변수에 관한 자세한 내용은 gcloud sql instances create를 참고하세요.

2. 자동 할당된 IP 주소를 기록합니다.

   Cloud SQL 인증 프록시를 사용하지 않는 경우 이 주소를 호스트 주소로 사용하여 애플리케이션 또는 도구에서 인스턴스로 연결합니다.

3. 사용자의 비밀번호를 설정합니다.

   gcloud sql users set-password sqlserver no-host --instance=[INSTANCE_NAME] \
          --password=[PASSWORD]

Terraform

인스턴스를 만들려면 Terraform 리소스를 사용합니다.

resource "google_sql_database_instance" "instance" {
  name             = "sqlserver-instance"
  region           = "us-central1"
  database_version = "SQLSERVER_2019_STANDARD"
  root_password    = "INSERT-PASSWORD-HERE"
  settings {
    tier = "db-custom-2-7680"
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

REST v1

1. 인스턴스 만들기

가능한 모든 필드가 아래의 기본 API 호출에 표시되지는 않습니다. JSON 요청의 프로토타입은 설정을 참조하세요.

Instances:insert 페이지도 참조하세요. 리전에 따른 유효값을 포함한 인스턴스 설정은 인스턴스 설정을 참조하세요. 머신 유형에 대한 자세한 내용은 커스텀 인스턴스 구성을 참조하세요.

instance-id는 외부에 공개되므로 민감한 정보나 개인 식별 정보를 포함하지 마세요.

인스턴스 이름에 프로젝트 ID를 포함하지 않아도 됩니다. 필요한 경우 자동으로 포함됩니다(예: 로그 파일에서).

collation 필드(아래 기본 API 호출에는 표시되지 않음)를 사용하면 인스턴스의 데이터베이스에 사용되는 콜레이션 유형의 기본값을 설정할 수 있습니다. 이 콜레이션 기본값은 인스턴스 수준에서는 영구적이지만 데이터베이스 수준에서는 그렇지 않습니다. 데이터베이스 관리 도구를 사용하여 이 기본값을 변경할 수 있지만 생성 또는 업데이트 중인 특정 데이터베이스의 경우에만 변경할 수 있습니다. 인스턴스를 다시 만들지 않는 한 인스턴스를 만든 후에는 인스턴스의 기본 콜레이션 값을 변경할 수 없습니다. SQL Server의 콜레이션에 대한 자세한 내용은 콜레이션 및 유니코드 지원을 참조하세요. JSON 요청의 프로토타입은 설정을 참조하세요. collation 매개변수에 지정할 수 있는 문자열의 예시에는 SQL_Latin1_General_CP1_CI_AS이 있습니다.

timeZone 필드(아래 기본 API 호출에는 표시되지 않음)를 사용하면 인스턴스의 시간대를 설정할 수 있습니다. 인스턴스를 만든 후에 인스턴스의 시간대를 변경할 수 있습니다. 자세한 내용과 허용되는 문자열 목록은 설정을 참조하세요. timeZone 필드에 지정할 수 있는 문자열의 예시에는 "Pacific Standard Time"이 있습니다. 더보기

관리형 Microsoft AD와 통합되는 인스턴스를 만들려면 domain 필드에 subdomain.mydomain.com과 같은 도메인을 지정합니다. 자세한 내용은 Windows 인증을 사용하여 인스턴스 만들기를 참조하세요. 또한 다른 프로젝트에서 관리형 AD 도메인과 통합하기 위한 절차 및 제약조건을 참조하세요.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: 프로젝트 ID입니다.
• INSTANCE_ID: 인스턴스 ID입니다.
• REGION: 리전 이름
• DATABASE_VERSION: 데이터베이스 버전의 enum 문자열. 예를 들면 SQLSERVER_2017_STANDARD입니다.
• PASSWORD: root 사용자의 비밀번호
• MACHINE_TYPE: 머신 (등급) 유형의 enum 문자열. 예를 들면 다음과 같습니다.
  db-perf-optimized-N-4
• EDITION_TYPE: Cloud SQL 버전. 기본값은 ENTERPRISE입니다.
• DATA_CACHE_ENABLED: (선택사항) 인스턴스에 데이터 캐시를 사용 설정하려면 이 파라미터의 값을 true로 설정합니다.

HTTP 메서드 및 URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

JSON 요청 본문:

{
  "name": "INSTANCE_ID",
  "region": "REGION",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "backupConfiguration": {
      "enabled": true
    },
    "dataCacheConfig" = {
      "dataCacheEnabled": DATA_CACHE_ENABLED
    },
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-01T19:13:21.834Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

인스턴스가 생성되면 기본 사용자 계정을 구성할 수 있습니다.

2. 인스턴스의 IPv4 주소 검색

필요한 경우 자동으로 할당된 IPv4 주소를 검색할 수 있습니다. 이 주소는 응답의 ipAddress 필드에 있습니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: 프로젝트 ID입니다.
• INSTANCE_ID: 이전 단계에서 생성한 인스턴스 ID

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "DATABASE_VERSION",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "MACHINE_TYPE",
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "ipv4Enabled": true
    },
    "locationPreference": {
      "zone": "ZONE",
      "kind": "sql#locationPreference"
    },
    "dataDiskType": "PD_SSD",
    "backupConfiguration": {
      "startTime": "19:00",
      "kind": "sql#backupConfiguration",
      "enabled": true
    },
    "settingsVersion": "1",
    "dataDiskSizeGb": "10"
  },
  "etag": "--redacted--",
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "10.0.0.1"
    }
  ],
  "serverCaCert": {
    ...
  },
  "instanceType": "CLOUD_SQL_INSTANCE",
  "project": "PROJECT_ID",
  "serviceAccountEmailAddress": "redacted@gcp-sa-cloud-sql.iam.gserviceaccount.com",
  "backendType": "BACKEND_TYPE",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "connectionName": "PROJECT_ID:REGION:INSTANCE_ID",
  "name": "INSTANCE_ID",
  "region": "REGION",
  "gceZone": "ZONE"
}

REST v1beta4

1. 인스턴스 만들기

가능한 모든 필드가 아래의 기본 API 호출에 표시되지는 않습니다. JSON 요청의 프로토타입은 설정을 참조하세요.

Instances:insert 페이지도 참조하세요. 리전에 따른 유효값을 포함한 인스턴스 설정은 인스턴스 설정을 참조하세요. 머신 유형에 대한 자세한 내용은 커스텀 인스턴스 구성을 참조하세요.

instance-id는 외부에 공개되므로 민감한 정보나 개인 식별 정보를 포함하지 마세요.

인스턴스 이름에 프로젝트 ID를 포함하지 않아도 됩니다. 필요한 경우 자동으로 포함됩니다(예: 로그 파일에서).

collation 필드(아래 기본 API 호출에는 표시되지 않음)를 사용하면 인스턴스의 데이터베이스에 사용되는 콜레이션 유형의 기본값을 설정할 수 있습니다. 이 콜레이션 기본값은 인스턴스 수준에서는 영구적이지만 데이터베이스 수준에서는 그렇지 않습니다. 데이터베이스 관리 도구를 사용하여 이 기본값을 변경할 수 있지만 생성 또는 업데이트 중인 특정 데이터베이스의 경우에만 변경할 수 있습니다. 인스턴스를 다시 만들지 않는 한 인스턴스를 만든 후에는 인스턴스의 기본 콜레이션 값을 변경할 수 없습니다. SQL Server의 콜레이션에 대한 자세한 내용은 콜레이션 및 유니코드 지원을 참조하세요. JSON 요청의 프로토타입은 설정을 참조하세요. collation 매개변수에 지정할 수 있는 문자열의 예시에는 SQL_Latin1_General_CP1_CI_AS이 있습니다.

timeZone 필드(아래 기본 API 호출에는 표시되지 않음)를 사용하면 인스턴스의 시간대를 설정할 수 있습니다. 인스턴스를 만든 후에 인스턴스의 시간대를 변경할 수 있습니다. 자세한 내용과 허용되는 문자열 목록은 설정을 참조하세요. timeZone 필드에 지정할 수 있는 문자열의 예시에는 "Pacific Standard Time"이 있습니다. 더보기

관리형 Microsoft AD와 통합되는 인스턴스를 만들려면 domain 필드에 subdomain.mydomain.com과 같은 도메인을 지정합니다. 자세한 내용은 Windows 인증을 사용하여 인스턴스 만들기를 참조하세요. 또한 다른 프로젝트에서 관리형 AD 도메인과 통합하기 위한 절차 및 제약조건을 참조하세요.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: 프로젝트 ID입니다.
• INSTANCE_ID: 인스턴스 ID입니다.
• REGION: 리전 이름
• DATABASE_VERSION: 데이터베이스 버전의 enum 문자열.
• MACHINE_TYPE: 머신 (등급) 유형의 enum 문자열. 예를 들면 다음과 같습니다.
  db-perf-optimized-N-4
• PASSWORD: root 사용자의 비밀번호
• MACHINE_TYPE : db-custom-[CPUS]-[MEMORY_MBS]와 같은 머신 (등급) 유형의 enum 문자열.
• EDITION_TYPE: Cloud SQL 버전. 기본값은 ENTERPRISE입니다.
• DATA_CACHE_ENABLED: (선택사항) 인스턴스에 데이터 캐시를 사용 설정하려면 이 파라미터의 값을 true로 설정합니다.

HTTP 메서드 및 URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances

JSON 요청 본문:

{
  "name": "INSTANCE_ID",
  "region": "REGION",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "backupConfiguration": {
      "enabled": true
    },
    "dataCacheConfig" = {
      "dataCacheEnabled": DATA_CACHE_ENABLED
    },
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-01T19:13:21.834Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

인스턴스가 생성되면 기본 사용자 계정을 구성할 수 있습니다.

2. 인스턴스의 IPv4 주소 검색

필요한 경우 자동으로 할당된 IPv4 주소를 검색할 수 있습니다. 이 주소는 응답의 ipAddress 필드에 있습니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: 프로젝트 ID입니다.
• INSTANCE_ID: 이전 단계에서 생성한 인스턴스 ID

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "DATABASE_VERSION",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "MACHINE_TYPE",
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "ipv4Enabled": true
    },
    "locationPreference": {
      "zone": "ZONE",
      "kind": "sql#locationPreference"
    },
    "dataDiskType": "PD_SSD",
    "backupConfiguration": {
      "startTime": "19:00",
      "kind": "sql#backupConfiguration",
      "enabled": true
    },
    "settingsVersion": "1",
    "dataDiskSizeGb": "10"
  },
  "etag": "--redacted--",
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "10.0.0.1"
    }
  ],
  "serverCaCert": {
    ...
  },
  "instanceType": "CLOUD_SQL_INSTANCE",
  "project": "PROJECT_ID",
  "serviceAccountEmailAddress": "redacted@gcp-sa-cloud-sql.iam.gserviceaccount.com",
  "backendType": "BACKEND_TYPE",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "connectionName": "PROJECT_ID:REGION:INSTANCE_ID",
  "name": "INSTANCE_ID",
  "region": "REGION",
  "gceZone": "ZONE"
}