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 |
|
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 |
|
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 |
|
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 |
|
Personalizado | 2 a 96 vCPUs, 3,75 GB a 624 GB |
otimizado para desempenho(somente Cloud SQL Enterprise Plus) |
|
otimizado para memória(somente Cloud SQL Enterprise Plus) |
|
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
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Verifique se você tem os papéis Administrador do Cloud SQL e Leitor do Compute na
sua conta de usuário.
Saiba mais sobre papéis e permissões
Criar uma instância do SQL Server
Console
-
No console do Google Cloud, acesse a página Instâncias do Cloud SQL.
- Clique em Criar instância.
- No painel Escolher o mecanismo do banco de dados na página Criar uma instância, clique em Escolher SQL Server.
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
ouEnterprise plus
.Para mais informações sobre as edições do Cloud SQL, consulte Introdução às edições do Cloud SQL.
- Selecione a predefinição de edição para sua instância. Para acessar as predefinições, clique no menu Predefinição da edição.
- 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.
- 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.
- No campo Senha, insira uma senha para o usuário.
- 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 eAny (different from primary)
para a zona secundária. - Se as zonas primária e secundária forem especificadas, elas precisarão ser zonas diferentes.
- A zona padrão é
- 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 Google A 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.- Expanda Mostrar opção de intervalo de IP alocado.
- Selecione um intervalo de IP no menu suspenso.
A instância pode ter um endereço IP público e um particular.
- Saiba mais sobre como usar o IP privado.
- Saiba mais sobre como alocar intervalos de endereços IP.
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 backups Selecione "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 armazenar O 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 IDENTIFICADOR Adicione uma chave e um valor para cada rótulo adicionado. Use rótulos para ajudar a organizar suas instâncias. - 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.
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.
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.
- Use o comando
gcloud sql instances create
para criar a 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.
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
Essa opção está na Visualização.--server-ca-mode
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.- As zonas precisam ser válidas.
- Se a zona secundária for especificada, a primária também precisará ser especificada.
- 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.
- Defina a senha do usuário:
gcloud sql users set-password sqlserver no-host --instance=[INSTANCE_NAME] \ --password=[PASSWORD]
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:
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
|
--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 ).
|
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 |
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:
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. |
Terraform
Para criar uma instância, use um recurso do Terraform.
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
- Inicie o Cloud Shell.
-
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.
-
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 demain.tf
.mkdir DIRECTORY && cd DIRECTORY && touch main.tf
-
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.
- Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
- Salve as alterações.
-
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
-
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.
-
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!".
- 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:
- Para desativar a proteção contra exclusão, no arquivo de configuração do Terraform, defina o argumento
deletion_protection
comofalse
.deletion_protection = "false"
- Para aplicar a configuração atualizada do Terraform, execute o comando a seguir e digite
yes
no prompt:terraform apply
-
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.
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
ouGOOGLE_MANAGED_CAS_CA
. Se você não especificarserverCaMode
, 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.
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
ouGOOGLE_MANAGED_CAS_CA
. Se você não especificarserverCaMode
, 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" }
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
- Crie um banco de dados do SQL Server na instância.
- Crie usuários do SQL Server na instância.
- Proteja e controle o acesso à instância.
- Conecte-se à instância com um cliente do SQL Server.
- Importar dados para o banco de dados.
- Saiba mais sobre as configurações de instância.