Crie instâncias

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

Para obter informações detalhadas sobre todas as definições de instâncias, consulte o artigo Definições de instâncias.

Uma instância recém-criada tem uma base de dados sqlserver.

Depois de criar uma instância do Cloud SQL para SQL Server, adicione-lhe bases de dados criando-as ou importando-as.

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

  • Nova arquitetura de rede SQL: pode ter até 1000 instâncias por projeto.
  • Arquitetura de rede SQL antiga: pode ter até 100 instâncias por projeto.
  • Usar ambas as arquiteturas: o seu limite vai estar entre 100 e 1000, consoante a distribuição das suas instâncias pelas duas arquiteturas.

Apresente um registo de apoio ao cliente para pedir um aumento. As réplicas de leitura são contabilizadas como instâncias.

Escolha entre a edição Cloud SQL Enterprise Plus e a edição Cloud SQL Enterprise

Quando cria uma instância do Cloud SQL para SQL Server, escolhe a configuração da máquina entre várias famílias de máquinas diferentes, consoante a edição do Cloud SQL.

Com a edição Enterprise Plus do Cloud SQL, pode escolher entre duas famílias de máquinas:

  • Otimizado para o desempenho: oferece um desempenho de preço equilibrado para várias cargas de trabalho do SQL Server com uma relação memória/computação de 1 vCPU:8 GB de RAM.
  • Otimizadas para memória: oferece rácios de memória para computação elevados para cargas de trabalho com utilização intensiva de memória com 1 vCPU:32 GB de RAM. As máquinas otimizadas para memória são adequadas para cargas de trabalho do SQL Server que requerem consultas complexas, estatísticas e relatórios de inteligência empresarial que beneficiam do armazenamento de conjuntos de dados maiores na memória durante o processamento de dados.

Com a edição Enterprise do Cloud SQL, tem várias configurações de máquinas à sua escolha, com base nos seus requisitos de vCPU e memória. As secções seguintes mostram a configuração de vCPU e memória para cada versão da base 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 aplicável
  • 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 aplicável
  • 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 aplicável
  • 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 aplicável
  • 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 o desempenho
(apenas no 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
Otimizada para memória
(apenas no Cloud SQL Enterprise Plus)
  • 4 vCPUs, 128 GB
  • 8 vCPUs, 256 GB
  • 16 vCPUs, 512 GB

Multithreading simultâneo

A multithreading simultânea (SMT) no Cloud SQL para SQL Server permite-lhe executar duas CPUs virtuais (vCPUs) como threads independentes e separadas num núcleo físico. A SMT está ativada por predefinição. No entanto, pode desativá-la, o que pode reduzir os seus custos de licenciamento.

A desativação da SMT pode afetar o desempenho da instância. Para compreender o impacto da desativação da SMT no desempenho da sua instância, recomendamos que faça testes de carga na sua 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.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Install the gcloud CLI.

  5. Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

  6. Para inicializar a CLI gcloud, execute o seguinte comando: 

    gcloud init

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  8. Verify that billing is enabled for your Google Cloud project.

  9. Install the gcloud CLI.

  10. Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

  11. Para inicializar a CLI gcloud, execute o seguinte comando: 

    gcloud init
  12. Certifique-se de que tem as funções de administrador do Cloud SQL e leitor do Compute na sua conta de utilizador.

    Aceda à página IAM

    Saiba mais acerca das funções e autorizações.

    13. Crie uma instância do SQL Server

    Consola

    1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

      Aceda a Instâncias do Cloud SQL

    2. Clique em Criar instância.
    3. No painel Escolha o motor de base de dados da página Criar uma instância, clique em Escolher SQL Server.

    4. Na secção Escolha uma edição do Cloud SQL da página Crie uma instância do SQL Server, selecione a edição do Cloud SQL para a sua instância: Enterprise ou Enterprise Plus.

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

    5. Selecione a predefinição da edição para a sua instância. Para ver as predefinições disponíveis, clique no menu Predefinição de edição.
    6. Na secção Informações da instância, selecione a versão da base de dados da sua instância. Para ver as versões disponíveis, clique no menu Versão da base de dados.
    7. No campo ID da instância do painel Informações da instância, introduza um ID para a sua instância.

      Não tem de incluir o ID do projeto no nome da instância. Isto é feito automaticamente sempre que apropriado (por exemplo, nos ficheiros de registo).

    8. No campo Palavra-passe, introduza uma palavra-passe para o utilizador.

      9. Para ver a palavra-passe em texto não cifrado, clique no ícone Mostrar palavra-passe.

      Pode introduzir a palavra-passe manualmente ou clicar em Gerar para que o Cloud SQL crie uma palavra-passe automaticamente.

    9. Na secção Escolha a região e a disponibilidade por zona, selecione a região e a zona para a sua instância. A disponibilidade de regiões pode ser diferente com base na sua edição do Cloud SQL para SQL Server. Para mais informações, consulte o artigo Acerca das definições de instâncias.

      Coloque a instância na mesma região que os recursos que acedem à mesma. Não é possível modificar a região selecionada no futuro. Na maioria dos casos, não tem de especificar uma zona.

      Se estiver a configurar a sua instância para alta disponibilidade, pode selecionar uma zona principal e uma secundária.

      Aplicam-se as seguintes condições quando a zona secundária é usada durante a criação de instâncias:

      • As zonas são predefinidas como Any para a zona principal e Any (different from primary) para a zona secundária.
      • Se forem especificadas as zonas principal e secundária, têm de ser zonas distintas.
    10. Na secção Personalize a sua instância, atualize as definições da sua instância. Comece por clicar em MOSTRAR OPÇÕES DE CONFIGURAÇÃO para apresentar os grupos de definições. Em seguida, expanda os grupos que quer rever e personalizar as definições. É apresentado um Resumo de todas as opções que selecionar à direita. A personalização destas definições de instância é opcional. As predefinições são atribuídas em todos os casos em que não são feitas personalizações.

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

      Definição Notas
      Tipo de máquina
      Tipo de máquina Selecione entre Leve, Padrão (mais comum) ou Memória elevada. Cada tipo de máquina é classificado pelo número de CPUs (núcleos) e pela quantidade de memória da sua instância.
      Núcleos O número de vCPUs para a sua instância. Saiba mais.
      Memória A quantidade de memória para a sua instância, em GB. Saiba mais.
      Personalizado Para o tipo de máquina de 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 seleciona esta opção, tem de selecionar o número de núcleos e a quantidade de memória para a sua instância. Saiba mais.
      Cache de dados
      Ative a cache de dados Por predefinição, a opção para ativar a cache de dados é selecionada automaticamente para instâncias da edição Enterprise Plus do Cloud SQL para SQL Server. Se não quiser ativar a cache de dados, desmarque a caixa de verificação Ativar cache de dados. Para mais informações sobre a cache de dados, consulte cache de dados.
      Armazenamento
      Tipo de armazenamento Determina se a sua instância usa armazenamento SSD ou HDD. Saiba mais.
      Capacidade de armazenamento A quantidade de armazenamento aprovisionada para a instância. Saiba mais.
      Ative os aumentos automáticos de armazenamento Determina se o Cloud SQL fornece automaticamente mais armazenamento para a sua instância quando o espaço livre é reduzido. Saiba mais.
      Encriptação
      Encriptação gerida pela GoogleA opção predefinida.
      Chave de encriptação gerida pelo cliente (CMEK)Selecione para usar a sua chave com o Google Cloud Key Management Service. Saiba mais.
      Ligações
      IP privado Adiciona um endereço IP privado para a sua instância. Para ativar a ligação à instância, é necessária uma configuração adicional.
      Opcionalmente, pode especificar um intervalo de IPs atribuído para as suas instâncias usarem para ligações.
      1. Expanda a opção Mostrar intervalo de IPs atribuídos.
      2. Selecione um intervalo de IPs no menu pendente.

      A sua instância pode ter um endereço IP público e privado.
      IP público Adiciona um endereço IP público para a sua instância. Em seguida, pode adicionar redes autorizadas para estabelecer ligação à instância.

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

      Saiba mais sobre a utilização do IP público.
      Redes autorizadas

      Adicione o nome da nova rede e o endereço de rede. Saiba mais.
      Segurança
      Modo de autoridade de certificação do servidor

      Escolha o tipo de autoridade de certificação (AC) que assina o certificado do servidor para esta instância do Cloud SQL. Saiba mais.

      Por predefinição, quando cria uma instância na Google Cloud consola, a instância usa a autoridade de certificação interna gerida pela Google (GOOGLE_MANAGED_INTERNAL_CA), que é a opção de CA por instância.
      Proteção de dados
      Automatize as cópias de segurança O período durante o qual quer que os backups sejam iniciados.
      Escolha onde armazenar as suas cópias de segurançaSelecione Multirregional para a maioria dos exemplos de utilização. Se precisar de armazenar cópias de segurança numa região específica, por exemplo, se existirem motivos regulamentares para o fazer, selecione Região e selecione a sua região no menu pendente Localização.
      Escolha quantas cópias de segurança automáticas quer armazenarO número de cópias de segurança automáticas que quer reter (de 1 a 365 dias). Saiba mais.
      Ative a recuperação pontual Permite a recuperação num determinado momento e o registo de transações. Saiba mais.
      Ative a proteção contra eliminação Determina se uma instância deve ser protegida contra eliminação acidental. Saiba mais.
      Ative as cópias de segurança retidas após a eliminação da instância Determina se as cópias de segurança automáticas e a pedido são mantidas após a eliminação de uma instância. Saiba mais.
      Escolha o número de dias de registos a reter Configure a retenção do registo de gravação antecipada de 1 a 7 dias. A predefinição é de 7 dias. Saiba mais.
      Manutenção
      Janela preferida Determina um período de uma hora durante o qual o Cloud SQL pode realizar manutenção destrutiva na sua instância. Se não definir o período, a manutenção disruptiva pode ser feita em qualquer altura. Saiba mais.
      Ordem das atualizações O seu momento preferido para atualizações de instâncias, relativamente a outras instâncias no mesmo projeto. Saiba mais.
      Flags
      ADICIONAR FLAG Pode usar flags da base de dados para controlar as definições e os parâmetros da sua instância. Saiba mais.
      Marcadores
      ADICIONAR ETIQUETAAdicione uma chave e um valor para cada etiqueta que adicionar. Usa etiquetas para ajudar a organizar as suas instâncias.
    11. Clique em Criar instância.

      Nota: a criação da instância pode demorar alguns minutos. No entanto, pode ver informações sobre a instância enquanto está a ser criada.

    gcloud

    Para obter informações sobre a instalação e o início da CLI gcloud, consulte o artigo Instalar a CLI gcloud. Para obter informações sobre como iniciar o Cloud Shell, consulte a documentação do Cloud Shell.

    Tem de usar a versão 243.0.0 ou posterior do gcloud.

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

      2. Para instâncias da edição 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 da edição Enterprise do Cloud SQL:

            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 tem de incluir o ID do projeto no nome da instância. Isto é feito automaticamente sempre que apropriado (por exemplo, nos ficheiros de registo).

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

      Por exemplo, a seguinte string cria uma instância com 2 vCPUs e 7680 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 ver alguns valores de exemplo, consulte a secção Tipos de máquinas de exemplo.

      Para saber mais acerca dos parâmetros das definições de instâncias, consulte o artigo gcloud sql instances create.

      O valor predefinido de REGION é us-central1.

      Não inclua informações confidenciais nem de identificação pessoal no nome da instância, uma vez que é visível externamente.
      Não tem de incluir o ID do projeto no nome da instância. Isto é feito automaticamente sempre que apropriado (por exemplo, nos ficheiros de registo).

      Se estiver a criar uma instância para alta disponibilidade, pode especificar as zonas principal e secundária através dos parâmetros --zone e --secondary-zone. Aplicam-se as seguintes condições quando a zona secundária é usada durante a criação ou a edição da instância:

      • As zonas têm de ser zonas válidas.
      • Se a zona secundária for especificada, a principal também tem de ser especificada.
      • Se as zonas principal e secundária forem especificadas, têm de ser zonas distintas.
      • Se as zonas principal e secundária forem especificadas, têm de pertencer à mesma região.

      Pode adicionar mais parâmetros para determinar outras definições da instância:

      Definição Parâmetro Notas
      Parâmetros obrigatórios
      Versão da base de dados --database-version A versão da base de dados, que se baseia na sua edição do Cloud SQL.
      Região --region Veja os valores válidos.
      Conetividade
      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 quer usar para esta instância. O acesso a serviços privados já tem de estar configurado para a rede. Disponível apenas para o comando beta (gcloud beta sql instances create).

      --no-assign-ip: a instância só tem um endereço IP privado.

      --allocated-ip-range-name: se especificado, define um nome de intervalo para o qual é alocado um intervalo de IPs. Por exemplo, google-managed-services-default. O nome do intervalo deve estar em conformidade com RFC-1035 e ter entre 1 e 63 carateres. (gcloud alpha sql instances create).
      IP público --authorized-networks Para ligações de IP público, apenas as ligações de redes autorizadas podem estabelecer ligação à sua instância. Saiba mais.
      Modo de AC do servidor --server-ca-mode

      A flag --server-ca-mode configura o tipo de autoridade de certificação (CA) do certificado do servidor para uma instância. Pode selecionar uma das seguintes opções:

      • GOOGLE_MANAGED_INTERNAL_CA: este é o valor predefinido. Com esta opção, uma AC interna dedicada a cada instância do Cloud SQL assina o certificado do servidor dessa instância.
      • GOOGLE_MANAGED_CAS_CA: com esta opção, é usada uma hierarquia de ACs que consiste numa AC de raiz e em ACs de servidor subordinadas geridas pelo Cloud SQL e alojadas no Google Cloud Certificate Authority Service (CA Service). As ACs (autoridades de certificação) do servidor subordinadas numa região assinam os certificados do servidor e são partilhadas entre instâncias na região.
      • CUSTOMER_MANAGED_CAS_CA: com esta opção, define a hierarquia da AC e gere a rotação dos certificados da AC. Cria um conjunto de ACs no serviço de ACs na mesma região da sua instância. Uma das ACs no conjunto é usada para assinar o certificado do servidor. Para mais informações, consulte o artigo Use uma AC gerida pelo cliente.
      Arquitetura de rede --enforce-new-network-architecture Aplique a utilização da nova arquitetura de rede para a instância no momento da criação. A utilização desta flag quando cria uma instância antes de esse projeto ter sido totalmente atualizado para a nova arquitetura de rede pode levar ao consumo excessivo de endereços IP ou à falha na criação de instâncias se não existirem endereços IP suficientes no intervalo de IP alocado. Para mais informações, consulte os artigos Atualize uma instância para a nova arquitetura de rede e Atribua um intervalo de endereços IP.
      Tipo de máquina e armazenamento
      Tipo de máquina --tier
      Tipo de armazenamento --storage-type Determina se a sua instância usa armazenamento SSD ou HDD. Saiba mais.
      Capacidade de armazenamento --storage-size A quantidade de armazenamento aprovisionado para a instância, em GB. Saiba mais.
      Aumento automático do armazenamento --storage-auto-increase Determina se o Cloud SQL fornece automaticamente mais armazenamento para a sua instância quando o espaço livre é reduzido. Saiba mais.
      Limite de aumento automático do armazenamento --storage-auto-increase-limit Determina o tamanho que o Cloud SQL pode aumentar automaticamente o armazenamento. Disponível apenas para o comando beta (gcloud beta sql instances create). Saiba mais.
      Cópias de segurança automáticas e alta disponibilidade
      Alta disponibilidade --availability-type Para uma instância de alta disponibilidade, defina como REGIONAL. Saiba mais.
      Zona secundária --secondary-zone Se estiver a criar uma instância para alta disponibilidade, pode especificar as zonas principal e secundária através dos parâmetros --zone e --secondary-zone parameters. Aplicam-se as seguintes restrições quando a zona secundária é usada durante a criação ou a edição da instância:
      • As zonas têm de ser zonas válidas.
      • Se a zona secundária for especificada, a principal também tem de ser especificada.

        • Se as zonas principal e secundária forem especificadas, têm de ser zonas distintas.

        Se as zonas principal e secundária forem especificadas, têm de pertencer à mesma região.
      Cópias de segurança automáticas --backup-start-time O período durante o qual quer que os backups sejam iniciados.
      Definições de retenção para cópias de segurança automáticas --retained-backups-count O número de cópias de segurança automáticas a reter. Saiba mais.
      Definições de retenção para registos de transações --retained-transaction-log-days O número de dias para reter registos de transações para a recuperação num determinado momento. Saiba mais.
      Recuperação pontual --enable-point-in-time-recovery Ativa a recuperação num determinado momento e os registos de transações. Saiba mais.
      Adicione flags de base de dados
      Sinalizações de bases de dados --database-flags Pode usar flags da base de dados para controlar as definições e os parâmetros da sua instância. Saiba mais acerca das sinalizações da base de dados.
      Agendamento da manutenção
      Período de manutenção --maintenance-window-day,
      --maintenance-window-hour      		 Determina um período de uma hora em que o Cloud SQL pode realizar manutenção disruptiva na sua instância. Se não definir o período, a manutenção disruptiva pode ser feita em qualquer altura. Saiba mais.
      Tempo de manutenção --maintenance-release-channel O seu momento preferido para atualizações de instâncias, relativamente a outras instâncias no mesmo projeto. Use preview para atualizações anteriores e production para atualizações posteriores. Saiba mais.
      SAN personalizado
      Adicione um nome alternativo personalizado de requerente (SAN) --custom-subject-alternative-names=DNS_NAMES

      Se quiser usar um nome DNS personalizado para se ligar a uma instância do Cloud SQL em vez de usar um endereço IP, configure a definição de nome alternativo do assunto (SAN) personalizado enquanto cria a instância. O nome DNS personalizado que inserir na definição SAN personalizada é adicionado ao campo SAN do certificado do servidor da instância. Isto permite-lhe usar o nome DNS personalizado com a validação do nome de anfitrião de forma segura.

      Antes de poder usar o nome DNS personalizado nos seus clientes e aplicações, tem de configurar o mapeamento entre o nome DNS e o endereço IP. Isto é conhecido como resolução de DNS. Pode adicionar uma lista separada por vírgulas de até três nomes DNS personalizados à definição SAN personalizada.
    2. Tome nota do endereço IP atribuído automaticamente.

      Se não estiver a usar o proxy Auth do Cloud SQL, vai usar este endereço como o endereço do anfitrião que as suas aplicações ou ferramentas usam para estabelecer ligação à instância.

    3. Defina a palavra-passe do utilizador: 
            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 num Google Cloud projeto, conclua os passos nas secções seguintes.

    Prepare o Cloud Shell

    1. Inicie o Cloud Shell.

    2. Defina o Google Cloud projeto predefinido onde quer aplicar as suas configurações do Terraform.

      Só tem de executar este comando uma vez por projeto e pode executá-lo em qualquer diretório.

      export GOOGLE_CLOUD_PROJECT=PROJECT_ID

      As variáveis de ambiente são substituídas se definir valores explícitos no ficheiro de configuração do Terraform.

    Prepare o diretório

    Cada ficheiro de configuração do Terraform tem de ter o seu próprio diretório (também denominado módulo raiz).

    1. No Cloud Shell, crie um diretório e um novo ficheiro nesse diretório. O nome do ficheiro tem de ter a extensão .tf, por exemplo, main.tf. Neste tutorial, o ficheiro é denominado main.tf. 
      mkdir DIRECTORY && cd DIRECTORY && touch main.tf

    2. Se estiver a seguir um tutorial, pode copiar o código de exemplo em cada secção ou passo.

      Copie o exemplo de código para o ficheiro main.tf criado recentemente.

      Opcionalmente, copie o código do GitHub. Isto é recomendado quando o fragmento do Terraform faz parte de uma solução completa.

    3. Reveja e modifique os parâmetros de exemplo para aplicar ao seu ambiente.
    4. Guarde as alterações.
    5. Inicialize o Terraform. Só tem de fazer isto uma vez por diretório. 
      terraform init

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

      terraform init -upgrade

    Aplique as alterações

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

      Faça correções à configuração conforme necessário.

    2. Aplique a configuração do Terraform executando o seguinte comando e introduzindo yes no comando: 
      terraform apply

      Aguarde até que o Terraform apresente a mensagem "Apply complete!" (Aplicação concluída!).

    3. Abra o seu Google Cloud projeto para ver os resultados. Na Google Cloud consola, navegue para os seus recursos na IU para se certificar de que o Terraform os criou ou atualizou.

    Eliminar as alterações

    Para eliminar as alterações, faça o seguinte:

    1. Para desativar a proteção contra eliminação, no ficheiro de configuração do Terraform, defina o argumento deletion_protection como false. 
      deletion_protection =  "false"
    2. Aplique a configuração do Terraform atualizada executando o seguinte comando e introduzindo yes no comando: 
      terraform apply

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

      terraform destroy

    REST v1

    1. Crie a instância

    Nem todos os campos possíveis são apresentados na seguinte chamada básica da API. Para ver um protótipo de um pedido JSON, consulte o artigo Definições.

    Consulte também a página Instances:insert. Para informações sobre as definições de instâncias, incluindo valores válidos para regiões, consulte Definições de instâncias. Para obter informações sobre os tipos de máquinas, consulte o artigo Configurações de instâncias personalizadas.

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

    Não tem de incluir o ID do projeto no nome da instância. Isto é feito automaticamente sempre que apropriado (por exemplo, nos ficheiros de registo).

    O campo collation (não apresentado na seguinte chamada básica da API) permite-lhe definir um valor predefinido para o tipo de ordenação usado para as bases de dados na sua instância. Esta predefinição de ordenação é permanente ao nível da instância, mas não ao nível da base de dados. Pode alterar esta predefinição com uma ferramenta de administração de bases de dados, mas apenas para uma base de dados específica que esteja a criar ou atualizar. Não é possível alterar a predefinição de ordenação de uma instância depois de a criar (a menos que recrie a instância). Para mais informações sobre as regras de ordenação no SQL Server, consulte Regras de ordenação e compatibilidade com Unicode. Para um protótipo de um pedido JSON, consulte Settings. Pode especificar a seguinte string de exemplo para o parâmetro collation: SQL_Latin1_General_CP1_CI_AS.

    O campo timeZone (não apresentado na seguinte chamada básica da API) permite-lhe definir um fuso horário para uma instância. Depois de criar uma instância, pode alterar o fuso horário de uma instância. Para mais informações e uma lista de strings aceites, consulte Definições. Pode especificar a seguinte string de exemplo para o campo timeZone: "Pacific Standard Time". Veja mais.

    Para criar uma instância integrada com o Managed Microsoft AD, especifique um domínio, como subdomain.mydomain.com, para o campo domain. Para mais informações, consulte o artigo Criar uma instância com a autenticação do Windows. Além disso, tenha em atenção os procedimentos e restrições para a integração com um domínio do Microsoft AD gerido num projeto diferente.

    Para obter informações sobre como definir o valor de machine-type no corpo do pedido, consulte o artigo Configurações de instâncias personalizadas.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID do seu projeto.
    • INSTANCE_ID: o ID da instância.
    • REGION: o nome da região.
    • DATABASE_VERSION: uma string enum da versão da base de dados. Por exemplo: SQLSERVER_2017_STANDARD.
    • PASSWORD: a palavra-passe do utilizador root.
    • MACHINE_TYPE: uma string enum do tipo de máquina (nível). Por exemplo:
      db-perf-optimized-N-4.
    • EDITION_TYPE: a sua edição do Cloud SQL. O valor predefinido é ENTERPRISE.
    • DATA_CACHE_ENABLED: (opcional) para ativar a cache de dados para a sua instância, defina o valor deste parâmetro como true.
    • PRIVATE_NETWORK: especifique o nome da rede da nuvem virtual privada (VPC) que quer usar para esta instância. O acesso a serviços privados já tem de estar configurado para a rede.
    • AUTHORIZED_NETWORKS: para ligações de IP público, especifique as ligações de redes autorizadas que podem estabelecer ligação à sua instância.
    • CA_MODE: especifique uma hierarquia da autoridade de certificação para a instância, GOOGLE_MANAGED_INTERNAL_CA ou GOOGLE_MANAGED_CAS_CA. Se não especificar serverCaMode, a configuração predefinida é GOOGLE_MANAGED_INTERNAL_CA. Esta funcionalidade está em pré-visualização.
    • DNS_NAMES: adicione uma lista separada por vírgulas de até três nomes DNS ao certificado do servidor da sua instância do Cloud SQL. Pode proteger vários nomes de DNS com um único certificado. Esta funcionalidade está disponível na pré-visualização e apenas para instâncias CUSTOMER_MANAGED_CAS_CA.

    Pode usar o campo sqlNetworkArchitecture para aplicar a utilização da nova arquitetura de rede à instância no momento da criação, mesmo que o projeto não esteja totalmente atualizado. Para mais detalhes sobre a nova arquitetura de rede e as respetivas implicações, consulte os artigos Atualize uma instância para a nova arquitetura de rede e Atribua um intervalo de endereços IP.

    Método HTTP e URL: 

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

    Corpo JSON do pedido: 

    {
  "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"
    }
  },
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

    {
  "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 de criar a instância, pode configurar ainda mais a conta de utilizador predefinida.

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

    Opcionalmente, pode obter o endereço IPv4 atribuído automaticamente. Na resposta, esse endereço encontra-se no campo ipAddress.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID do seu projeto
    • INSTANCE_ID: o ID da instância, criado no passo anterior

    Método HTTP e URL: 

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

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

    {
  "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.",
  "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. Crie a instância

    Nem todos os campos possíveis são apresentados na seguinte chamada básica da API. Para ver um protótipo de um pedido JSON, consulte Definições.

    Consulte também a página Instances:insert. Para informações sobre as definições de instâncias, incluindo valores válidos para regiões, consulte Definições de instâncias. Para informações sobre os tipos de máquinas, consulte Configurações de instâncias personalizadas.

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

    Não tem de incluir o ID do projeto no nome da instância. Isto é feito automaticamente sempre que apropriado (por exemplo, nos ficheiros de registo).

    O campo collation (não apresentado na seguinte chamada API básica) permite-lhe definir um valor predefinido para o tipo de ordenação usado para as bases de dados na sua instância. Esta predefinição de ordenação é permanente ao nível da instância, mas não ao nível da base de dados. Pode alterar esta predefinição com uma ferramenta de administração de bases de dados, mas apenas para uma base de dados específica que esteja a criar ou atualizar. Não pode alterar a predefinição de ordenação de uma instância após a criação da instância (a menos que recrie a instância). Para informações sobre as intercalações no SQL Server, consulte Compatibilidade com intercalações e Unicode. Para um protótipo de um pedido JSON, consulte Definições. Pode especificar a seguinte string de exemplo para o parâmetro collation: SQL_Latin1_General_CP1_CI_AS.

    O campo timeZone (não apresentado na seguinte chamada básica da API) permite-lhe definir um fuso horário para uma instância. Depois de criar uma instância, pode alterar o fuso horário de uma instância. Para mais informações e uma lista de strings aceites, consulte Definições. Pode especificar a seguinte string de exemplo para o campo timeZone: "Pacific Standard Time". Veja mais.

    Para criar uma instância integrada com o Managed Microsoft AD, especifique um domínio, como subdomain.mydomain.com, para o campo domain. Para mais informações, consulte o artigo Criar uma instância com a autenticação do Windows. Além disso, tenha em atenção os procedimentos e restrições para a integração com um domínio do Microsoft AD gerido num projeto diferente.

    Para ver informações sobre como definir o valor de machine-type no corpo do pedido, consulte o artigo Configurações de instâncias personalizadas.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID do seu projeto.
    • INSTANCE_ID: o ID da instância.
    • REGION: o nome da região.
    • DATABASE_VERSION: uma string enum da versão da base de dados.
    • MACHINE_TYPE: uma string enum do tipo de máquina (nível). Por exemplo:
      db-perf-optimized-N-4.
    • PASSWORD: a palavra-passe do utilizador root.
    • MACHINE_TYPE: uma string enum do tipo de máquina (nível), como: db-custom-[CPUS]-[MEMORY_MBS].
    • EDITION_TYPE: a sua edição do Cloud SQL. O valor predefinido é ENTERPRISE.
    • DATA_CACHE_ENABLED: (opcional) para ativar a cache de dados para a sua instância, defina o valor deste parâmetro como true.
    • PRIVATE_NETWORK: especifique o nome da rede da nuvem virtual privada (VPC) que quer usar para esta instância. O acesso a serviços privados já tem de estar configurado para a rede.
    • AUTHORIZED_NETWORKS: para ligações de IP público, especifique as ligações de redes autorizadas que podem estabelecer ligação à sua instância.
    • CA_MODE: especifique uma hierarquia da autoridade de certificação para a instância, GOOGLE_MANAGED_INTERNAL_CA ou GOOGLE_MANAGED_CAS_CA. Se não especificar serverCaMode, a configuração predefinida é GOOGLE_MANAGED_INTERNAL_CA. Esta funcionalidade está em pré-visualização.
    • DNS_NAMES: adicione uma lista separada por vírgulas de até três nomes DNS ao certificado do servidor da sua instância do Cloud SQL. Pode proteger vários nomes de DNS com um único certificado. Esta funcionalidade está disponível na pré-visualização e apenas para instâncias CUSTOMER_MANAGED_CAS_CA.

    Pode usar o campo sqlNetworkArchitecture para aplicar a utilização da nova arquitetura de rede à instância no momento da criação, mesmo que o projeto não esteja totalmente atualizado. Para mais detalhes sobre a nova arquitetura de rede e as respetivas implicações, consulte os artigos Atualize uma instância para a nova arquitetura de rede e Atribua um intervalo de endereços IP.

    Método HTTP e URL: 

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

    Corpo JSON do pedido: 

    {
  "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"
    }
  },
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

    {
  "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 de criar a instância, pode configurar ainda mais a conta de utilizador predefinida.

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

    Opcionalmente, pode obter o endereço IPv4 atribuído automaticamente. Na resposta, esse endereço encontra-se no campo ipAddress.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID do seu projeto
    • INSTANCE_ID: o ID da instância, criado no passo anterior

    Método HTTP e URL: 

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

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

    {
  "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.",
  "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 o pedido da API REST subjacente é construído para esta tarefa, consulte o Explorador de APIs na página instances:insert.

    Gere o ponto final de escrita

    Um ponto final de gravação é um nome de serviço de nomes de domínio (DNS) global que é resolvido automaticamente para o endereço IP da instância principal atual. Este ponto final redireciona as ligações recebidas para a nova instância principal automaticamente em caso de uma operação de comutação por falha ou comutação de uma réplica. Pode usar o ponto final de gravação numa string de ligação SQL em vez de um endereço IP. Ao usar um ponto final de gravação, pode evitar ter de fazer alterações à ligação da aplicação quando ocorre uma indisponibilidade da região.

    Para mais informações sobre como usar um ponto final de escrita para se ligar a uma instância, consulte o artigo Ligue-se a uma instância através de um ponto final de escrita.

    Configurações de instâncias personalizadas

    As configurações de instâncias personalizadas permitem-lhe selecionar a quantidade de memória e CPUs de que a sua instância precisa. Esta flexibilidade permite-lhe escolher o formato de VM adequado para a sua carga de trabalho. A disponibilidade do tipo de máquina é determinada pela sua edição do Cloud SQL para SQL Server.

    Para cargas de trabalho que requerem processamento em tempo real, certifique-se de que a sua instância tem memória suficiente para conter o conjunto de trabalho completo. No entanto, existem outros fatores que podem afetar os requisitos de memória, como o número de ligações ativas e os processos internos gerais. Deve realizar testes de carga para evitar problemas de desempenho no seu ambiente de produção.

    Quando configurar a instância, selecione memória e vCPUs suficientes para processar a sua carga de trabalho e atualize à medida que a carga de trabalho aumenta. Uma configuração de máquina com um número insuficiente de vCPUs pode perder a respetiva cobertura do SLA. Para mais informações, consulte as diretrizes operacionais.

    Tipos de máquinas para instâncias da edição Cloud SQL Enterprise

    Para instâncias da edição Enterprise do Cloud SQL, também pode criar configurações de instâncias personalizadas através do comando gcloud sql instances create.

    Os nomes dos tipos de máquinas 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 do computador for db-custom e o computador tiver 1 CPU e 3840 MB de RAM, o formato do computador é db-custom-1-3840.

    Quando seleciona o número de CPUs e a quantidade de memória, existem algumas restrições na configuração que escolher:

    • O número de CPUs virtuais que pode configurar para a sua instância baseia-se na versão do servidor SQL.
    • O número de vCPUs tem de ser 1 ou um número par entre 2 e 96.
    • O tamanho da memória tem de ser:
      • 0,9 a 6,5 GB por vCPU
      • Um múltiplo de 256 MB
      • Pelo menos 3,75 GB (3840 MB)

    Tipos de máquinas para instâncias da edição Cloud SQL Enterprise Plus

    Para instâncias da edição Cloud SQL Enterprise Plus, os tipos de máquinas estão predefinidos, conforme descrito nas secções seguintes.

    Família de máquinas otimizadas para desempenho

    Esta família de máquinas oferece um equilíbrio entre preço e desempenho para uma grande variedade de cargas de trabalho do SQL Server com uma relação entre memória e computação de 1 vCPU:8 GB de RAM. A família de máquinas otimizadas para desempenho oferece os seguintes tipos de máquinas à sua escolha:

    Tipo de máquina 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 otimizadas para memória

    Esta família de máquinas oferece rácios de memória/computação elevados para cargas de trabalho com utilização intensiva de memória com 1 vCPU por 32 GB de RAM. As máquinas otimizadas para memória são adequadas para cargas de trabalho do SQL Server que requerem consultas complexas, estatísticas e relatórios de inteligência empresarial que beneficiam do armazenamento de conjuntos de dados maiores na memória durante o processamento de dados. A família de máquinas com megamemória oferece os seguintes tipos de máquinas à sua escolha:

    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

    Resolver problemas

    Problema Resoluçã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 novamente a instância do Cloud SQL.

    O que se segue?

    1. Crie uma base de dados do SQL Server na instância.
    2. Crie utilizadores do SQL Server na instância.
    3. Proteja e controle o acesso à instância.
    4. Estabeleça ligação à instância com um cliente do SQL Server.
    5. Importe dados para a base de dados.
    6. Saiba mais sobre as definições de instância.