Criar instâncias

Esta página descreve como criar uma instância do Cloud SQL para o SQL Server.

Para saber mais sobre todas as configurações de instância, veja o artigo Configurações de instância.

Uma instância recém-criada tem um banco de dados sqlserver.

Depois de criar uma instância do Cloud SQL para SQL Server, adicione bancos de dados a ela criando ou importando.

O número máximo de instâncias que você pode ter em um único projeto depende da arquitetura de rede dessas instâncias:

  • Nova arquitetura de rede SQL: é possível ter até 1.000 instâncias por projeto.
  • Arquitetura de rede SQL antiga: é possível ter até 100 instâncias por projeto.
  • Usando as duas arquiteturas: seu limite será entre 100 e 1.000, dependendo da distribuição das instâncias entre as duas arquiteturas.

Registre um caso de suporte para solicitar um aumento. As réplicas de leitura são contadas como instâncias.

Escolher entre o Cloud SQL Enterprise Plus e o Cloud SQL Enterprise

Ao criar uma instância do Cloud SQL para SQL Server, você escolhe a configuração da máquina em várias famílias diferentes, dependendo da edição do Cloud SQL.

No Cloud SQL Enterprise Plus, você pode escolher entre duas famílias de máquinas:

  • Otimização de desempenho: oferece um preço-desempenho equilibrado para várias cargas de trabalho do SQL Server com uma proporção de memória para computação de 1 vCPU:8 GB de RAM.
  • Otimização de memória: oferece proporções de memória para computação altas para cargas de trabalho com uso intensivo de memória com 1 vCPU:32 GB de RAM. As máquinas com otimização de memória são adequadas para cargas de trabalho do SQL Server que exigem consultas complexas, análises e relatórios de business intelligence que se beneficiam do armazenamento de conjuntos de dados maiores na memória durante o processamento de dados.

Com a edição Enterprise do Cloud SQL, você tem várias configurações de máquina para escolher com base nos requisitos de vCPU e memória. As seções a seguir mostram a configuração de vCPU e memória para cada versão de banco de dados e tipo de máquina:

SQL Server 2017 Express, SQL Server 2019 Express e SQL Server 2022 Express

Tipo de máquina vCPU/memória
Não relevante
  • 1 vCPU, 3,75 GB
  • 2 vCPUs, 8 GB
  • 4 vCPUs, 16 GB
  • 8 vCPUs, 32 GB
Personalizado 1 a 8 vCPUs, 3,75 GB a 52 GB

SQL Server 2017 Web, SQL Server 2019 Web e SQL Server 2022 Web

Tipo de máquina vCPU/memória
Não relevante
  • 1 vCPU, 3,75 GB
  • 2 vCPUs, 8 GB
  • 4 vCPUs, 16 GB
  • 8 vCPUs, 32 GB
Personalizado 1 a 32 vCPUs, 3,75 GB a 208 GB

SQL Server 2017 Standard, SQL Server 2019 Standard e SQL Server 2022 Standard

Tipo de máquina vCPU/memória
Não relevante
  • 1 vCPU, 3,75 GB
  • 2 vCPUs, 8 GB
  • 4 vCPUs, 16 GB
  • 8 vCPUs, 32 GB
Personalizado 1 a 48 vCPUs, 3,75 GB a 312 GB

SQL Server 2017 Enterprise, SQL Server 2019 Enterprise e SQL Server 2022 Enterprise

Tipo de máquina vCPU/memória
Não relevante
  • 1 vCPU, 3,75 GB
  • 2 vCPUs, 8 GB
  • 4 vCPUs, 16 GB
  • 8 vCPUs, 32 GB
Personalizado 2 a 96 vCPUs, 3,75 GB a 624 GB

otimizado para desempenho(somente Cloud SQL Enterprise Plus)
  • 2 vCPUs, 16 GB
  • 4 vCPUs, 32 GB
  • 8 vCPUs, 64 GB
  • 16 vCPUs, 128 GB
  • 32 vCPUs, 256 GB
  • 48 vCPUs, 384 GB
  • 64 vCPUs, 512 GB
  • 80 vCPUs, 640 GB
  • 96 vCPUs, 768 GB
  • 128 vCPUs, 864 GB

otimizado para memória(somente Cloud SQL Enterprise Plus)
  • 4 vCPUs, 128 GB
  • 8 vCPUs, 256 GB
  • 16 vCPUs, 512 GB

Multissegmentação simultânea

Com a multissegmentação simultânea (SMT) no Cloud SQL para SQL Server, você executa duas CPUs virtuais (vCPUs) como linhas de execução independentes e separadas em um núcleo físico. A SMT está ativada por padrão. No entanto, é possível desativá-la, e isso pode reduzir os custos de licenciamento.

Desativar a SMT pode afetar o desempenho da instância. Para entender o impacto da desativação da SMT no desempenho da instância, recomendamos realizar um teste de carga na instância.

Antes de começar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Install the Google Cloud CLI.

  5. To initialize the gcloud CLI, run the following command: 

    gcloud init

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  7. Make sure that billing is enabled for your Google Cloud project.

  8. Install the Google Cloud CLI.

  9. To initialize the gcloud CLI, run the following command: 

    gcloud init
  10. Verifique se você tem os papéis Administrador do Cloud SQL e Leitor do Compute na sua conta de usuário.

    Acessar a página IAM

    Saiba mais sobre papéis e permissões

Criar uma instância do SQL Server

Console

  1. No console do Google Cloud, acesse a página Instâncias do Cloud SQL.

    Acesse Instâncias do Cloud SQL

  2. Clique em Criar instância.
  3. No painel Escolher o mecanismo do banco de dados na página Criar uma instância, clique em Escolher SQL Server.

  4. Na seção Escolher uma edição do Cloud SQL da página Criar uma instância do SQL Server, selecione a edição do Cloud SQL para sua instância: Enterprise ou Enterprise plus.

    Para mais informações sobre as edições do Cloud SQL, consulte Introdução às edições do Cloud SQL.

  5. Selecione a predefinição de edição para sua instância. Para acessar as predefinições, clique no menu Predefinição da edição.
  6. Na seção Informações da instância, selecione a versão do banco de dados para sua instância. Para conferir as versões disponíveis, clique no menu Versão do banco de dados.
  7. No campo Código da instância do painel Informações da instância, insira um ID para a instância.

    Não é necessário incluir o ID do projeto no nome da instância. Isso é feito automaticamente quando necessário, como nos arquivos de registros.

  8. No campo Senha, insira uma senha para o usuário.

    9. Para ver a senha em texto não criptografado, clique no ícone Mostrar senha.

    Insira a senha manualmente ou clique em Gerar para que o Cloud SQL crie uma senha automaticamente.

  9. Na seção Escolher região e disponibilidade por zona, selecione a região e a zona da instância. A disponibilidade da região pode ser diferente de acordo com a edição do Cloud SQL para SQL Server. Para mais informações, consulte Sobre as configurações de instância.

    Coloque a instância na mesma região que os recursos que a acessam. A região selecionada não poderá ser modificada no futuro. Na maioria dos casos, não é necessário especificar uma zona.

    Se você estiver configurando a instância para alta disponibilidade, selecione as zonas primária e secundária.

    As condições a seguir se aplicam quando a zona secundária é usada durante a criação da instância:

    • A zona padrão é Any para a zona principal e Any (different from primary) para a zona secundária.
    • Se as zonas primária e secundária forem especificadas, elas precisarão ser zonas diferentes.
  10. Na seção Personalizar a instância, atualize as configurações dela. Comece clicando em MOSTRAR OPÇÕES DE CONFIGURAÇÃO para exibir os grupos de configurações. Em seguida, expanda os grupos que você quer revisar e personalize as configurações. Um resumo de todas as opções selecionadas é mostrado à direita. A personalização dessas configurações de instância é opcional. Os padrões são atribuídos em todos os casos em que nenhuma personalização é feita.

    A tabela a seguir é uma referência rápida às configurações da instância. Para mais detalhes sobre cada configuração, consulte a página configurações da instância.

    Configuração Observações
    Tipo de máquina
    Tipo de máquina Selecione entre leve, padrão (mais comum) ou alta memória. Cada tipo de máquina é classificado pelo número de CPUs (núcleos) e pela quantidade de memória da instância.
    Núcleos Número de vCPUs da instância. Saiba mais.
    Memória A quantidade de memória da instância, em GB. Saiba mais.
    Personalizado Para o tipo de máquina com núcleo dedicado, em vez de selecionar uma configuração predefinida, selecione o botão Personalizado para criar uma instância com uma configuração personalizada. Quando você seleciona essa opção, precisa selecionar o número de núcleos e a quantidade de memória para a instância. Saiba mais.
    Armazenamento
    Tipo de armazenamento Determina se a instância usa armazenamento SSD ou HDD. Saiba mais.
    Capacidade de armazenamento A quantidade de armazenamento provisionada para a instância. Saiba mais.
    Ativar aumento automático de armazenamento Determina se o Cloud SQL fornece automaticamente mais armazenamento para sua instância quando há pouco espaço livre. Saiba mais.
    Criptografia
    Criptografia gerenciada pelo GoogleA opção padrão.
    Chave de criptografia gerenciada pelo cliente (CMEK, na sigla em inglês)Selecione para usar sua chave com o Google Cloud Key Management Service. Saiba mais.
    Conexões
    IP privado Adiciona um endereço IP privado à instância. Para ativar a conexão com a instância, é necessário ter configurações extras.
    Opcionalmente, é possível especificar um intervalo de IP alocado para as suas instâncias usarem em conexões.
    1. Expanda Mostrar opção de intervalo de IP alocado.
    2. Selecione um intervalo de IP no menu suspenso.

    A instância pode ter um endereço IP público e um particular.
    IP público Adiciona um endereço IP público à instância. Em seguida, é possível adicionar redes autorizadas para se conectar à instância.

    A instância pode ter um endereço IP público e um particular.

    Saiba mais sobre como usar o IP público.
    Redes autorizadas

    Adicione o nome da nova rede e o endereço dela. Saiba mais.
    Proteção de dados
    Backups automáticos A janela de tempo que você quer que os backups comecem.
    Escolha onde quer armazenar os backupsSelecione "Multirregional" para a maioria dos casos de uso. Se você precisar armazenar backups em uma região específica, por exemplo, se houver razões regulatórias, selecione a região e selecione sua região no menu suspenso "Local".
    Escolher quantos backups automatizados armazenarO número de backups automáticos que você quer manter (de 1 a 365 dias). Saiba mais.
    Ativar recuperação pontual Ativa a recuperação pontual e a geração de registros de transação. Saiba mais.
    Ativar proteção contra exclusão Determina se uma instância será protegida contra exclusão acidental. Saiba mais.
    Escolha quantos dias de registros serão retidos Configure a retenção de registros em tempo de gravação de um a sete dias. A configuração padrão é de sete dias. Saiba mais.
    Manutenção
    Janela preferida Determina uma janela de uma hora em que o Cloud SQL pode executar a manutenção disruptiva na instância. Se você não definir a janela, uma manutenção disruptiva poderá ser feita a qualquer momento. Saiba mais.
    Ordem de atualizações Horário de sua preferência para as atualizações de instâncias, em relação a outras instâncias no mesmo projeto. Saiba mais.
    Sinalizações
    ADICIONAR SINALIZAÇÃO Você pode usar sinalizações do banco de dados para controlar configurações e parâmetros na instância. Saiba mais.
    Marcadores
    ADICIONAR IDENTIFICADORAdicione uma chave e um valor para cada rótulo adicionado. Use rótulos para ajudar a organizar suas instâncias.
  11. Clique em Criar instância.

    Observação: pode levar alguns minutos para criar sua instância. No entanto, é possível acessar informações sobre a instância enquanto ela está sendo criada.

gcloud

Para informações sobre como instalar e começar a usar a CLI gcloud, consulte Como instalar a CLI gcloud. Para mais informações sobre como iniciar o Cloud Shell, consulte a documentação do Cloud Shell.

Use a versão 243.0.0 gcloud ou posterior.

  1. Use o comando gcloud sql instances create para criar a instância:

    2. Para instâncias do 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

    Para instâncias do 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

    Não é necessário incluir o ID do projeto no nome da instância. Isso é feito automaticamente quando necessário, como nos arquivos de registros.

    Os valores de vCPUs e tamanho de memória são limitados para a edição Enterprise do Cloud SQL. Para mais informações, consulte Escolher entre o Cloud SQL Enterprise Plus e o Cloud SQL Enterprise.

    Por exemplo, a string a seguir cria uma instância com duas vCPUs e 7.680 MB de memória:

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

    Para alguns valores de amostra, consulte Exemplos de tipos de máquinas.

    Para saber mais sobre os parâmetros das configurações de instância, consulte gcloud sql instances create.

    O valor padrão de REGION é us-central1.

    Não inclua informações confidenciais ou de identificação pessoal na instância. Elas são visíveis externamente.
    Não é necessário incluir a ID do projeto no nome da instância. Isso é feito automaticamente quando necessário, como nos arquivos de registros.

    Se você estiver criando uma instância para alta disponibilidade, especifique as zonas primária e secundária usando os parâmetros --zone e --secondary-zone. As condições a seguir se aplicam quando a zona secundária é usada durante a criação ou edição da instância:

    • As zonas precisam ser válidas.
    • Se a zona secundária for especificada, a primária também precisará ser especificada.
    • Se as zonas primária e secundária forem especificadas, elas precisarão ser zonas diferentes.
    • Se as zonas primária e secundária forem especificadas, elas precisarão pertencer à mesma região.

    Você pode adicionar mais parâmetros para determinar outras configurações da instância:

    Configuração Parâmetro Observações
    Parâmetros obrigatórios
    Versão do banco de dados --database-version A versão do banco de dados, que é baseada na edição do Cloud SQL.
    Região --region Consulte os valores válidos.
    Conectividade
    IP privado --network

    --no-assign-ip (opcional)

    --allocated-ip-range-name (opcional)

    --enable-google-private-path (opcional)

    		 --network: Especifica o nome da rede VPC que você quer usar para a instância. O acesso a serviços particulares já precisa estar configurado na rede. Disponível apenas para o comando Beta (gcloud beta sql instances create).

    --no-assign-ip: a instância terá apenas um endereço IP particular.

    --allocated-ip-range-name: se especificado, define um nome de intervalo para o qual um intervalo de IP é alocado. Por exemplo, google-managed-services-default. O nome do intervalo precisa obedecer a RFC-1035 e ter de 1 a 63 caracteres. (gcloud alpha sql instances create).
    IP público --authorized-networks Nas conexões de IP público, apenas as conexões de redes autorizadas podem se conectar à instância. Saiba mais.
    Modo de AC do servidor --server-ca-mode

    A flag --server-ca-mode configura o tipo de autoridade certificadora do servidor (CA) para uma instância. Você pode selecionar uma das seguintes opções:

    • GOOGLE_MANAGED_INTERNAL_CA: é o valor padrão. Com essa opção, uma AC interna dedicada a cada instância do Cloud SQL assina o certificado do servidor para essa instância.
    • GOOGLE_MANAGED_CAS_CA: com essa opção, é usada uma hierarquia de ACs que consiste em uma AC raiz e ACs de servidor subordinados gerenciadas pelo Cloud SQL e hospedadas no serviço de autoridade de certificação (AC Service) Google Cloud . As ACs de servidor subordinadas em uma região assinam os certificados do servidor e são compartilhadas entre as instâncias da região.

      A flag --server-ca-mode está na Visualização.

      Essa opção está na Visualização.
    • CUSTOMER_MANAGED_CAS_CA: com essa opção, você define a hierarquia da AC e gerencia a rotação dos certificados da AC. Você cria um pool de ACs no serviço de AC na mesma região da sua instância. Uma das ACs no pool é usada para assinar o certificado do servidor. Essa opção está na Visualização. Para mais informações, consulte Usar uma AC gerenciada pelo cliente.
    Tipo de máquina e armazenamento
    Tipo de máquina --tier
    Tipo de armazenamento --storage-type Determina se a instância usa armazenamento SSD ou HDD. Saiba mais.
    Capacidade de armazenamento --storage-size Quantidade de armazenamento provisionada para a instância em GB.Saiba mais.
    Aumento automático de armazenamento --storage-auto-increase Determina se o Cloud SQL fornece automaticamente mais armazenamento para sua instância quando há pouco espaço livre. Saiba mais.
    Limite de aumento automático de armazenamento --storage-auto-increase-limit Determina o quanto o Cloud SQL pode expandir o armazenamento automaticamente. Disponível apenas para o comando Beta (gcloud beta sql instances create). Saiba mais.
    Backups automáticos e alta disponibilidade
    Alta disponibilidade --availability-type Para uma instância altamente disponível, defina como REGIONAL. Saiba mais.
    Zona secundária --secondary-zone Se você estiver criando uma instância para alta disponibilidade, poderá especificar as zonas primária e secundária usando --zone e --secondary-zone parameters. As restrições a seguir se aplicam quando a zona secundária é usada durante a criação ou edição da instância:
    • As zonas precisam ser válidas.
    • Se a zona secundária for especificada, a primária também precisará ser especificada.

      • Se as zonas primária e secundária forem especificadas, elas precisarão ser zonas diferentes.

      Se as zonas primária e secundária forem especificadas, elas precisarão pertencer à mesma região.
    Backups automáticos --backup-start-time A janela de tempo que você quer que os backups comecem.
    Configurações de retenção para backups automáticos --retained-backups-count O número de backups automáticos a serem mantidos. Saiba mais.
    Configurações de retenção para registros de transações --retained-transaction-log-days O número de dias de retenção de registros de transações para recuperação pontual. Saiba mais.
    Recuperação pontual --enable-point-in-time recovery Ativa a recuperação pontual e os registros de transação. Saiba mais.
    Adicionar sinalizações do banco de dados
    Sinalizações do banco de dados --database-flags Você pode usar sinalizações do banco de dados para controlar configurações e parâmetros na instância. Saiba mais sobre as sinalizações do banco de dados.
    Cronograma de manutenção
    Janela de manutenção --maintenance-window-day,
    --maintenance-window-hour    		 Determina uma janela de uma hora em que o Cloud SQL pode executar a manutenção disruptiva na instância. Se você não definir a janela, uma manutenção disruptiva poderá ser feita a qualquer momento. Saiba mais.
    Dia/hora da manutenção --maintenance-release-channel Horário de sua preferência para as atualizações de instâncias, em relação a outras instâncias no mesmo projeto. Use preview para atualizações anteriores e production para atualizações posteriores. Saiba mais.
    SAN personalizada
    Adicionar um nome alternativo do assunto (SAN) personalizado --custom-subject-alternative-names=DNS_NAMES

    Se você quiser usar um nome DNS personalizado para se conectar a uma instância do Cloud SQL em vez de um endereço IP, configure a configuração personalizada do nome alternativo do assunto (SAN, na sigla em inglês) ao criar a instância. O nome DNS personalizado inserido na configuração SAN personalizada é adicionado ao campo SAN do certificado do servidor da instância. Isso permite que você use o nome DNS personalizado com a validação de nome de host de forma segura.

    Antes de usar o nome DNS personalizado nos clientes e aplicativos, é necessário configurar o mapeamento entre o nome DNS e o endereço IP. Isso é conhecido como resolução de DNS. É possível adicionar uma lista separada por vírgulas de até três nomes de DNS personalizados à configuração SAN personalizada.
  2. Observe o endereço IP atribuído automaticamente.

    Se não estiver usando o proxy do Cloud SQL Auth, você usará esse endereço como o endereço do host que os aplicativos ou as ferramentas usam para se conectar à instância.

  3. Defina a senha do usuário: 
          gcloud sql users set-password sqlserver no-host --instance=[INSTANCE_NAME] \
       --password=[PASSWORD]

Terraform

Para criar uma instância, use um recurso do 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
}

Aplique as alterações

Para aplicar a configuração do Terraform em um projeto do Google Cloud, conclua as etapas nas seções a seguir.

Preparar o Cloud Shell

  1. Inicie o Cloud Shell.

  2. Defina o projeto padrão do Google Cloud em que você quer aplicar as configurações do Terraform.

    Você só precisa executar esse comando uma vez por projeto, e ele pode ser executado em qualquer diretório.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    As variáveis de ambiente serão substituídas se você definir valores explícitos no arquivo de configuração do Terraform.

Preparar o diretório

Cada arquivo de configuração do Terraform precisa ter o próprio diretório, também chamado de módulo raiz.

  1. No Cloud Shell, crie um diretório e um novo arquivo dentro dele. O nome do arquivo precisa ter a extensão .tf, por exemplo, main.tf. Neste tutorial, o arquivo é chamado de main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Se você estiver seguindo um tutorial, poderá copiar o exemplo de código em cada seção ou etapa.

    Copie o exemplo de código no main.tf recém-criado.

    Se preferir, copie o código do GitHub. Isso é recomendado quando o snippet do Terraform faz parte de uma solução de ponta a ponta.

  3. Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
  4. Salve as alterações.
  5. Inicialize o Terraform. Você só precisa fazer isso uma vez por diretório. 
    terraform init

    Opcionalmente, para usar a versão mais recente do provedor do Google, inclua a opção -upgrade: 

    terraform init -upgrade

Aplique as alterações

  1. Revise a configuração e verifique se os recursos que o Terraform vai criar ou atualizar correspondem às suas expectativas: 
    terraform plan

    Faça as correções necessárias na configuração.

  2. Para aplicar a configuração do Terraform, execute o comando a seguir e digite yes no prompt: 
    terraform apply

    Aguarde até que o Terraform exiba a mensagem "Apply complete!".

  3. Abra seu projeto do Google Cloud para ver os resultados. No console do Google Cloud, navegue até seus recursos na IU para verificar se foram criados ou atualizados pelo Terraform.

Excluir as alterações

Para excluir as mudanças, faça o seguinte:

  1. Para desativar a proteção contra exclusão, no arquivo de configuração do Terraform, defina o argumento deletion_protection como false. 
    deletion_protection =  "false"
  2. Para aplicar a configuração atualizada do Terraform, execute o comando a seguir e digite yes no prompt: 
    terraform apply

  1. Remova os recursos aplicados anteriormente com a configuração do Terraform executando o seguinte comando e inserindo yes no prompt:

    terraform destroy

REST v1

1. Criar instância

Nem todos os campos possíveis são mostrados na seguinte chamada de API básica. Para o protótipo de uma solicitação JSON, consulte Configurações.

Consulte também a página Instances:insert. Para informações sobre configurações da instância, incluindo valores válidos para a região, consulte Configurações de instância. Para informações sobre tipos de máquina, consulte Configurações de instância personalizada.

Não inclua informações confidenciais ou de identificação pessoal em instance-id. O valor é visível externamente.

Não é necessário incluir o ID do projeto no nome da instância. Isso é feito automaticamente quando necessário, como nos arquivos de registros.

O campo collation (não mostrado na chamada de API básica a seguir) permite definir um valor padrão para o tipo de ordenação usado para os bancos de dados na sua instância. Esse padrão de compilação é permanente no nível da instância, mas não no nível do banco de dados. É possível alterar este padrão com uma ferramenta de administração de banco de dados, mas somente para um banco de dados específico que você esteja criando ou atualizando. Não é possível alterar o padrão de compilação de uma instância depois de criá-la, a menos que você recrie a instância. Para mais informações sobre ordenações no SQL Server, consulte Suporte para compilação e Unicode. Para o protótipo de uma solicitação JSON, consulte Configurações. É possível especificar a string de exemplo a seguir para o parâmetro collation: SQL_Latin1_General_CP1_CI_AS.

O campo timeZone (não mostrado na chamada de API básica a seguir) permite definir um fuso horário para uma instância. Depois de criar uma instância, é possível mudar o fuso horário dela. Para mais informações e uma lista de strings aceitas, consulte Configurações. Você pode especificar a seguinte string de exemplo para o campo timeZone: "Pacific Standard Time". Ver mais.

Para criar uma instância integrada ao Microsoft AD gerenciado, especifique um domínio, como subdomain.mydomain.com, para o campo domain. Para mais informações, consulte Como criar uma instância com autenticação do Windows. Além disso, observe os procedimentos e restrições para integração com um domínio do Microsoft AD gerenciado em um projeto diferente.

Para informações sobre como definir o valor de machine-type no corpo da solicitação, consulte Configurações de instância personalizadas.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto.
  • INSTANCE_ID: o ID da instância
  • REGION: o nome da região
  • DATABASE_VERSION: string de tipo enumerado da versão do banco de dados. Por exemplo, SQLSERVER_2017_STANDARD.
  • PASSWORD: a senha do usuário root.
  • MACHINE_TYPE: string de tipo enumerado para o tipo de máquina (camada). Examplo:
    db-perf-optimized-N-4.
  • EDITION_TYPE: sua edição do Cloud SQL O valor padrão é ENTERPRISE.
  • DATA_CACHE_ENABLED: (opcional) para ativar o cache de dados na instância, defina o valor desse parâmetro como true.
  • PRIVATE_NETWORK: especifique o nome da rede de nuvem privada virtual (VPC) que você quer usar para essa instância. O acesso a serviços particulares já precisa estar configurado na rede.
  • AUTHORIZED_NETWORKS: para conexões de IP público, especifique as conexões de redes autorizadas que podem se conectar à instância.
  • CA_MODE: especifique uma hierarquia de autoridades certificadoras para a instância, GOOGLE_MANAGED_INTERNAL_CA ou GOOGLE_MANAGED_CAS_CA. Se você não especificar serverCaMode, a configuração padrão será GOOGLE_MANAGED_INTERNAL_CA. Esse recurso está em pré-lançamento.
  • DNS_NAMES: adicione uma lista separada por vírgulas de até três nomes de DNS ao certificado do servidor da sua instância do Cloud SQL. É possível proteger vários nomes de DNS com um único certificado. Esse recurso está disponível na visualização e apenas para instâncias do CUSTOMER_MANAGED_CAS_CA.

Método HTTP e URL: 

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

Corpo JSON da solicitação:

{
  "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
    },
    "ipConfiguration": {
      "privateNetwork": "PRIVATE_NETWORK",
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      "ipv4Enabled": false,
      "serverCaMode": "CA_MODE",
      "customSubjectAlternativeNames": "DNS_NAMES"
    }
  }
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "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"
}

Depois que a instância é criada, é possível configurar a conta de usuário padrão.

2. Recuperar o endereço IPv4 da instância

Opcionalmente, você pode recuperar o endereço IPv4 atribuído automaticamente. Na resposta, esse endereço está no campo ipAddress.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: ID do projeto
  • INSTANCE_ID: o ID da instância, criado na etapa anterior

Método HTTP e URL: 

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

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "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. Criar instância

Nem todos os campos possíveis são mostrados na seguinte chamada de API básica. Para o protótipo de uma solicitação JSON, consulte Configurações.

Consulte também a página Instances:insert. Para informações sobre configurações de instância, incluindo valores válidos para regiões, consulte Configurações de instância. Para informações sobre tipos de máquina, consulte Configurações de instância personalizada.

Não inclua informações confidenciais ou de identificação pessoal em instance-id. O valor é visível externamente.

Não é necessário incluir o ID do projeto no nome da instância. Isso é feito automaticamente quando necessário, como nos arquivos de registros.

O campo collation (não mostrado na chamada de API básica a seguir) permite definir um valor padrão para o tipo de compilação usado para os bancos de dados na sua instância. Este padrão de ordenação é permanente no nível da instância, mas não no nível do banco de dados. É possível alterar este padrão com uma ferramenta de administração de banco de dados, mas somente para um banco de dados específico que você esteja criando ou atualizando. Não é possível mudar o padrão de ordenação de uma instância após a criação dela, a menos que você a recrie. Para mais informações sobre ordenações no SQL Server, consulte Suporte para ordenações e Unicode. Para o protótipo de uma solicitação JSON, consulte Configurações. É possível especificar a string de exemplo a seguir para o parâmetro collation: SQL_Latin1_General_CP1_CI_AS.

O campo timeZone (não mostrado na chamada de API básica a seguir) permite definir um fuso horário para uma instância. Depois de criar uma instância, é possível mudar o fuso horário dela. Para mais informações e uma lista de strings aceitas, consulte Configurações. Você pode especificar a seguinte string de exemplo para o campo timeZone: "Pacific Standard Time". Ver mais.

Para criar uma instância integrada ao Microsoft AD gerenciado, especifique um domínio, como subdomain.mydomain.com, para o campo domain. Para mais informações, consulte Como criar uma instância com a Autenticação do Windows. Além disso, observe os procedimentos e restrições para a integração com um domínio do Microsoft AD gerenciado em um projeto diferente.

Para informações sobre como definir o valor de machine-type no corpo da solicitação, consulte Configurações de instância personalizadas.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto.
  • INSTANCE_ID: o ID da instância
  • REGION: o nome da região
  • DATABASE_VERSION: string de tipo enumerado da versão do banco de dados.
  • MACHINE_TYPE: string de tipo enumerado para o tipo de máquina (camada). Examplo:
    db-perf-optimized-N-4.
  • PASSWORD: a senha do usuário root.
  • MACHINE_TYPE: uma string de tipo enumerado para o tipo de máquina (camada), como: db-custom-[CPUS]-[MEMORY_MBS].
  • EDITION_TYPE: sua edição do Cloud SQL O valor padrão é ENTERPRISE.
  • DATA_CACHE_ENABLED: (opcional) para ativar o cache de dados na instância, defina o valor desse parâmetro como true.
  • PRIVATE_NETWORK: especifique o nome da rede de nuvem privada virtual (VPC) que você quer usar para essa instância. O acesso a serviços particulares já precisa estar configurado na rede.
  • AUTHORIZED_NETWORKS: para conexões de IP público, especifique as conexões de redes autorizadas que podem se conectar à instância.
  • CA_MODE: especifique uma hierarquia de autoridade certificadora para a instância, GOOGLE_MANAGED_INTERNAL_CA ou GOOGLE_MANAGED_CAS_CA. Se você não especificar serverCaMode, a configuração padrão será GOOGLE_MANAGED_INTERNAL_CA. Esse recurso está em pré-lançamento.
  • DNS_NAMES: adicione uma lista separada por vírgulas de até três nomes de DNS ao certificado do servidor da sua instância do Cloud SQL. É possível proteger vários nomes de DNS com um único certificado. Esse recurso está disponível na visualização e apenas para instâncias do CUSTOMER_MANAGED_CAS_CA.

Método HTTP e URL: 

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

Corpo JSON da solicitação:

{
  "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
    },
    "ipConfiguration": {
      "privateNetwork": "PRIVATE_NETWORK",
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      "ipv4Enabled": false,
      "serverCaMode": "CA_MODE",
      "customSubjectAlternativeNames": "DNS_NAMES"
    }
  }
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "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"
}

Depois que a instância é criada, é possível configurar a conta de usuário padrão.

2. Recuperar o endereço IPv4 da instância

Opcionalmente, você pode recuperar o endereço IPv4 atribuído automaticamente. Na resposta, esse endereço está no campo ipAddress.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: ID do projeto
  • INSTANCE_ID: o ID da instância, criado na etapa anterior

Método HTTP e URL: 

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

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "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"
}
Para ver como a solicitação da API REST de base é criada nesta tarefa, consulte a página APIs Explorer em "instances:insert".

Gerar o endpoint de gravação

Se você planeja criar uma instância do Cloud SQL edição Enterprise Plus e quer que o Cloud SQL gere um endpoint de gravação automaticamente para ela, ative a API Cloud DNS no seu projeto do Google Cloud.

Se você já tiver uma instância do Cloud SQL edição Enterprise Plus e quiser que o Cloud SQL gere um endpoint de gravação automaticamente, crie uma réplica ativada para recuperação avançada de desastres.

Um endpoint de gravação é um nome de serviço de nome de domínio (DNS) global que se refere ao endereço IP da instância principal atual de forma automática. Esse endpoint redireciona as conexões de entrada para a nova instância principal automaticamente no caso de uma operação de failover ou alternância da réplica. É possível usar o endpoint de gravação em uma string de conexão SQL em vez de um endereço IP. Ao usar um endpoint de gravação, você evita ter que fazer mudanças na conexão do aplicativo quando ocorre uma interrupção regional.

Para mais informações sobre como acessar o endpoint de gravação da instância, consulte Acessar informações da instância. Para mais informações sobre como usar o endpoint de gravação para se conectar à instância, consulte Conectar usando um endpoint de gravação.

Configurações de instâncias personalizadas

Com as configurações de instância flexíveis, você seleciona a quantidade de memória e CPUs necessárias para a instância. Essa flexibilidade permite escolher o formato de VM adequado para a carga de trabalho. A disponibilidade do tipo de máquina é determinada pela edição do Cloud SQL para SQL Server.

Para cargas de trabalho que exigem processamento em tempo real, verifique se a instância tem memória suficiente para conter todo o conjunto de trabalho. No entanto, há outros fatores que podem afetar os requisitos de memória, como o número de conexões ativas e os processos de sobrecarga interna. Realize o teste de carga para evitar problemas de desempenho no seu ambiente de produção.

Ao configurar a instância, selecione memória e vCPUs suficientes para processar a carga de trabalho e faça o upgrade à medida que a carga de trabalho aumenta. Uma configuração de máquina com vCPUs insuficientes pode perder a cobertura do SLA. Para mais informações, consulte as diretrizes operacionais.

Tipos de máquina para instâncias do Cloud SQL Enterprise

Para instâncias do Cloud SQL Enterprise, também é possível criar configurações de instância personalizadas usando o comando gcloud sql instances create.

Os nomes dos tipos de máquina usam o seguinte formato: db-custom-NUMBER_OF_vCPUs-MEMORY

Substitua NUMBER_OF_vCPUs pelo número de CPUs na máquina e MEMORY pela quantidade de memória na máquina.

Por exemplo, se o nome da máquina for db-custom e tiver 1 CPU e 3.840 MB de RAM, o formato será db-custom-1-3840.

Ao selecionar o número de CPUs e a quantidade de memória, há algumas restrições à configuração escolhida:

  • O número de vCPUs que podem ser configuradas para a instância é baseado na versão do servidor SQL.
  • O número de vCPUs precisa ser 1 ou um número par entre 2 e 96.
  • O tamanho da memória precisa ser:
    • ter 0,9 a 6,5 GB por vCPU;
    • ser um múltiplo de 256 MB;
    • ter pelo menos 3,75 GB (3840 MB).

Tipos de máquina para instâncias do Cloud SQL Enterprise Plus

Para instâncias da edição Enterprise Plus do Cloud SQL, os tipos de máquina são predefinidos, conforme descrito nas seções a seguir.

Família de máquinas com desempenho otimizado

Esta família de máquinas oferece um custo-benefício equilibrado para uma ampla variedade de cargas de trabalho do SQL Server com uma proporção de memória para computação de 1 vCPU:8 GB de RAM. A família de máquinas com otimização de desempenho oferece os seguintes tipos de máquinas:

Tipo de máquina da edição Enterprise Plus vCPUs Memória (GB)
db-perf-optimized-N-2 2 16
db-perf-optimized-N-4 4 32
db-perf-optimized-N-8 8 64
db-perf-optimized-N-16 16 128
db-perf-optimized-N-32 32 256
db-perf-optimized-N-48 48 384
db-perf-optimized-N-64 64 512
db-perf-optimized-N-80 80 640
db-perf-optimized-N-96 96 768
db-perf-optimized-N-128 128 864

Família de máquinas com otimização de memória

Essa família de máquinas oferece altas proporções de memória para computação para cargas de trabalho com uso intensivo de memória com uma vCPU por 32 GB de RAM. As máquinas com otimização de memória são adequadas para cargas de trabalho do SQL Server que exigem consultas complexas, análises e relatórios de business intelligence que se beneficiam do armazenamento de conjuntos de dados maiores na memória durante o processamento de dados. A família de máquinas com otimização de memória oferece os seguintes tipos de máquina para escolher:

Tipo de máquina vCPUs Memória (GB)
db-memory-optimized-N-4 4 128
db-memory-optimized-N-8 8 256
db-memory-optimized-N-16 16 512

Limitações

  • Não é possível usar um SAN personalizado para adicionar mais de três nomes de DNS ao certificado do servidor de uma instância do Cloud SQL.
  • O comprimento máximo de um nome DNS que pode ser adicionado ao certificado de uma instância usando um SAN personalizado é de 253 caracteres.
  • Os nomes de DNS adicionados ao certificado da instância não podem ter caracteres curinga (*) ou pontos finais (por exemplo, test.example.com.).
  • Os nomes DNS precisam ser válidos, conforme especificado pela RFC 1034.
  • É possível usar um SAN personalizado apenas para instâncias CUSTOMER_MANAGED_CAS_CA.

Resolver problemas

Problema Solução de problemas
Mensagem de erro: Failed to create subnetwork. Router status is temporarily unavailable. Please try again later. Help Token: [token-ID] Tente criar a instância do Cloud SQL novamente.

A seguir

  1. Crie um banco de dados do SQL Server na instância.
  2. Crie usuários do SQL Server na instância.
  3. Proteja e controle o acesso à instância.
  4. Conecte-se à instância com um cliente do SQL Server.
  5. Importar dados para o banco de dados.
  6. Saiba mais sobre as configurações de instância.