Ativar e desativar o PolyBase

<meta <="" content="Esta página descreve como ativar e desativar o PolyBase com suas instâncias do Cloud SQL para SQL Server." name="description" />

MySQL   |  PostgreSQL   |  SQL Server

Nesta página, mostramos como ativar e desativar o PolyBase para suas instâncias do Cloud SQL para SQL Server.

Para informações gerais sobre o PolyBase, consulte Suporte do Cloud SQL para SQL Server ao PolyBase.

Para informações sobre como configurar, consulte Configurar fontes de dados externas para uso com o PolyBase.

Antes de começar

Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud SQL, Cloud SQL Admin, and Compute Engine APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud SQL, Cloud SQL Admin, and Compute Engine APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

1. Configure sua rede para permitir o tráfego entre o Cloud SQL para SQL Server e sua fonte de dados externa.
   • Se o SQL Server não conseguir estabelecer uma conexão bem-sucedida, o comando T-SQL para configurar ou consultar a fonte de dados externa vai falhar.

   • Ao usar um endereço IP público ou privado, verifique se a instância do Cloud SQL e todos os recursos Google Cloud de suporte têm acesso à fonte de dados externa no firewall dela.

     Se você estiver usando o endereço IP público da instância do Cloud SQL, também precisará acessar a VM do Compute Engine e obter o endereço IP dela. Como essa VM subjacente não é externalizada para os usuários, entre em contato com o suporte doGoogle Cloud para recuperar o endereço IP dela. Esse endereço IP pode mudar se a instância for recriada.

2. Para ativar ou desativar o PolyBase, você precisa das seguintes permissões:
   • cloudsql.instances.get
   • cloudsql.instances.update
   Qualquer uma das seguintes funções fornece as permissões anteriores:
   • roles/cloudsql.editor
   • roles/cloudsql.admin

   Recomendamos usar o princípio de privilégio mínimo ao conceder acesso.

   Outra opção é atribuir essas permissões a uma função personalizada.

3. Revise os nomes dos bancos de dados do data warehouse da sua instância.

   Quando o PolyBase está ativado, três novos bancos de dados de data warehouse do PolyBase são criados:

   • DWConfiguration
   • DWQueue
   • DWDiagnostics
   Se você ativar o PolyBase em uma instância que já contém bancos de dados do usuário com esses nomes restritos de DW, o SQL Server vai excluir e recriar esses bancos.

   Antes de ativar, use uma ferramenta como o SQL Server Management Studio (SSMS) para verificar se já existem bancos de dados com esses nomes. Se for o caso, entre em contato com o Google Cloud suporte para receber ajuda antes de continuar.

   Algumas restrições se aplicam a esses bancos de dados do sistema:

   • Não é possível usar o console Google Cloud , a API Cloud SQL Admin e a CLI gcloud para realizar determinadas operações em bancos de dados do DW:
     • Criar
     • Excluir
     • Lista
     • Importar
     No entanto, é possível usar o comando de exportação para fazer um backup desses bancos de dados.
   • Não é possível acessar bancos de dados do DW usando o SQL Server Management Studio (SSMS).
   • Se a instância for replicada, os bancos de dados do DW não serão copiados para o novo recurso.
   • Se a instância for restaurada usando a PITR, os bancos de dados do DW não serão copiados para o novo recurso.
   • Os bancos de dados do DW são mantidos mesmo depois que o PolyBase é desativado.

   Para saber mais, acesse os recursos a seguir:

   • Instalar o PolyBase no Linux
   • Resumo do recurso PolyBase

Ativação do PolyBase usando flags de banco de dados

É possível ativar o PolyBase com sua instância do Cloud SQL para SQL Server usando flags de banco de dados. As flags necessárias variam de acordo com o tipo de fonte de dados externa que você quer usar:

• A flag de banco de dados polybase é obrigatória para todas as fontes de dados externas.
• Se você estiver usando o Cloud Storage, também precisará aplicar a flag de rastreamento do Microsoft SQL Server, 13702. Ao ativar essa flag, você também ativa outras flags de rastreamento necessárias para a compatibilidade com o PolyBase.

As seções a seguir mostram como ativar o PolyBase em instâncias novas e atuais.

Criar uma instância com o PolyBase ativado

Para criar uma instância com o PolyBase ativado, execute o seguinte comando gcloud:

Oracle

gcloud sql instances create INSTANCE_NAME \
  --database-version=VERSION --region=LOCATION \
  --root-password=PASSWORD --edition=EDITION \
  --cpu=NUMBER_OF_CPUs --memory=MEMORY_SIZE \
  --database-flags="DATABASE_FLAG"

Substitua:

• INSTANCE_NAME: o nome da instância do Cloud SQL.
• VERSION: a versão do banco de dados que você quer usar.
• LOCATION: o local da instância do Cloud SQL.
• PASSWORD: a senha da instância do Cloud SQL.
• EDITION: a edição do banco de dados que você quer usar.
• NUMBER_OF_CPUs: o número de CPUs que você quer usar.
• MEMORY_SIZE: a quantidade de memória que você quer usar.

• DATABASE_FLAG: o valor da flag do banco de dados necessário para ativar o PolyBase, independente do tipo de fonte de dados externa.

  Você precisa inserir cloud sql enable polybase=on.

  Para mais informações, consulte Flags de banco de dados.

Cloud Storage

gcloud sql instances create INSTANCE_NAME \
  --database-version=VERSION --region=LOCATION \
  --root-password=PASSWORD --edition=EDITION \
  --cpu=NUMBER_OF_CPUs --memory=MEMORY_SIZE \
  --database-flags="DATABASE_FLAG_CLOUD_STORAGE"

Substitua:

• INSTANCE_NAME: o nome da instância do Cloud SQL.
• VERSION: a versão do banco de dados que você quer usar.
• LOCATION: o local da instância do Cloud SQL.
• PASSWORD: a senha da instância do Cloud SQL.
• EDITION: a edição do banco de dados que você quer usar.
• NUMBER_OF_CPUs: o número de CPUs que você quer usar.
• MEMORY_SIZE: a quantidade de memória que você quer usar.

• DATABASE_FLAG_CLOUD_STORAGE: os valores de flags do banco de dados necessários para ativar o PolyBase. Se a fonte de dados externa for o Cloud Storage, insira cloud sql enable polybase=on,13702=on.

  Para mais informações, consulte Flags de banco de dados.

Ativar o PolyBase em uma instância atual

Para ativar o PolyBase em uma instância atual, execute o seguinte comando gcloud:

Oracle

gcloud sql instances patch INSTANCE_NAME \
--database-flags="DATABASE_FLAG"

Substitua:

• INSTANCE_NAME: o nome da instância do Cloud SQL.
• DATABASE_FLAG: o valor da flag do banco de dados necessário para ativar o PolyBase, independente do tipo de fonte de dados externa.

Você precisa inserir cloud sql enable polybase=on.

Este exemplo é apenas para fins ilustrativos. Executar uma operação patch com uma configuração específica de sinalização do banco de dados substitui todas as sinalizações atuais. Inclua as flags de banco de dados que você quer manter. Se você omitir uma flag de banco de dados definida anteriormente, ela será revertida para o valor padrão.

Para mais informações, consulte Flags de banco de dados.

Cloud Storage

gcloud sql instances patch INSTANCE_NAME \
--database-flags="DATABASE_FLAG_CLOUD_STORAGE"

Substitua:

• INSTANCE_NAME: o nome da instância do Cloud SQL.
• DATABASE_FLAG_CLOUD_STORAGE: o valor da flag do banco de dados necessário para ativar o PolyBase, independente do tipo de fonte de dados externa.

Você precisa inserir cloud sql enable polybase=on,13702=on.

Este exemplo é apenas para fins ilustrativos. Executar uma operação patch com uma configuração específica de sinalização do banco de dados substitui todas as sinalizações atuais. Inclua as flags de banco de dados que você quer manter. Se você omitir uma flag de banco de dados definida anteriormente, ela será revertida para o valor padrão.

Para mais informações, consulte Flags de banco de dados.

Verificar a configuração da instância

Para verificar se o PolyBase está ativado em uma instância, execute o seguinte comando gcloud:

gcloud

gcloud sql instances describe INSTANCE_NAME \
  --format="value(settings.databaseFlags)"

Substitua:

• INSTANCE_NAME: o nome da instância do Cloud SQL.

Desativar o PolyBase

Para desativar o PolyBase em uma instância, execute o seguinte comando gcloud:

gcloud

gcloud sql instances patch INSTANCE_NAME \
--database-flags="cloud sql enable polybase=off"

Substitua:

• INSTANCE_NAME: o nome da instância do Cloud SQL.

Quando o PolyBase está desativado, os seguintes recursos não são excluídos:

• Bancos de dados do sistema de DW
• Chave mestra do banco de dados (DMK)
• Fontes de dados
• Credenciais com escopo de dados
• Tabelas externas

Esses recursos são mantidos caso você queira reativar o recurso no futuro.

A seguir

• Suporte do Cloud SQL para SQL Server ao PolyBase
• Configurar fontes de dados externas para uso com o PolyBase