Habilita e inhabilita PolyBase

<meta <="" content="En esta página, se describe cómo habilitar y deshabilitar PolyBase con tus instancias de Cloud SQL para SQL Server." name="description" />

En esta página, se muestra cómo habilitar y deshabilitar PolyBase para tus instancias de Cloud SQL para SQL Server.

Para obtener información general sobre PolyBase, consulta Compatibilidad de Cloud SQL para SQL Server con PolyBase.

Para obtener información sobre cómo configurar la configuración, consulta Configura fuentes de datos externas para usarlas con PolyBase.

Antes de comenzar

  1. Accede a tu Google Cloud cuenta de. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

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

    Go to project selector

  3. 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.

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

  5. 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

  6. 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.

    Go to project selector

  7. 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.

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

  9. 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

    10.
  10. Configura tu red para permitir el tráfico entre Cloud SQL para SQL Server y tu fuente de datos externa.
    • Si SQL Server no puede establecer una conexión exitosa, falla el comando T-SQL para configurar o consultar la fuente de datos externa.

    • Ya sea que uses una dirección IP pública o privada, asegúrate de que tu instancia de Cloud SQL, y cualquier recurso de asistencia Google Cloud tengan acceso a tu fuente de datos externa dentro del firewall de la fuente de datos.

      Si usas la dirección IP pública de la instancia de Cloud SQL, también debes obtener acceso a la VM de Compute Engine subyacente y obtener su dirección IP address. Como esta VM subyacente no se externaliza a los usuarios, debes comunicarte con el equipo de asistencia para recuperar su dirección IP.Google Cloud Esta dirección IP puede cambiar si se vuelve a crear la instancia.

  11. Para habilitar o inhabilitar PolyBase, necesitas los siguientes permisos:
    • cloudsql.instances.get
    • cloudsql.instances.update
    Cualquiera de los siguientes roles proporciona los permisos anteriores:
    • roles/cloudsql.editor
    • roles/cloudsql.admin

    Recomendamos usar el principio de privilegios mínimos cuando otorgues acceso.

    Como alternativa, también puedes asignar estos permisos a un rol personalizado.

  12. Revisa los nombres de las bases de datos de almacén existentes de tu instancia.

    Cuando se habilita PolyBase, se crean tres bases de datos de almacén de datos de PolyBase nuevas:

    • DWConfiguration
    • DWQueue
    • DWDiagnostics

    Antes de la habilitación, usa una herramienta como SQL Server Management Studio (SSMS) para verificar si ya existen bases de datos con estos nombres. Si es así, comunícate con el equipo de asistencia Google Cloud para obtener ayuda antes de continuar.

    Se aplican ciertas restricciones a estas bases de datos del sistema:

    • No puedes usar la Google Cloud consola, la API de Cloud SQL Admin ni la gcloud CLI para realizar ciertas operaciones en bases de datos DW:
      • Crear
      • Borrar
      • Lista
      • Importar
      Sin embargo, puedes usar el comando export para realizar una copia de seguridad de estas bases de datos.
    • No puedes acceder a las bases de datos DW con SQL Server Management Studio (SSMS).
    • Si se replica la instancia, las bases de datos DW no se copian en el recurso nuevo.
    • Si la instancia se restablece con PITR, las bases de datos DW no se copian en el recurso nuevo.
    • Las bases de datos DW se conservan incluso después de que se inhabilita PolyBase.

    Para obtener más información, consulta los siguientes recursos:

Habilitación de PolyBase con marcas de base de datos

Puedes habilitar PolyBase con tu instancia de Cloud SQL para SQL Server con marcas de base de datos. Las marcas requeridas varían según el tipo de fuente de datos externa que deseas usar:

  • Se requiere la marca de base de datos polybase para todas las fuentes de datos externas.
  • Si usas Cloud Storage, también debes aplicar la marca de seguimiento de Microsoft SQL Server trace flag, 13702. Habilitar esta marca también habilita otras marcas de seguimiento necesarias para la compatibilidad con PolyBase.

En las siguientes secciones, se muestra cómo habilitar PolyBase en instancias nuevas y existentes.

Crea una instancia nueva con PolyBase habilitado

Para crear una instancia nueva con PolyBase habilitado, ejecuta el siguiente gcloud comando:

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"

Reemplaza lo siguiente:

  • INSTANCE_NAME: el nombre de la instancia de Cloud SQL.
  • VERSION: la versión de la base de datos que deseas usar.
  • LOCATION: la ubicación de la instancia de Cloud SQL.
  • PASSWORD: la contraseña de la instancia de Cloud SQL.
  • EDITION: la edición de la base de datos que deseas usar.
  • NUMBER_OF_CPUs: la cantidad de CPU que deseas usar.
  • MEMORY_SIZE: la cantidad de memoria que deseas usar.

  • DATABASE_FLAG: el valor de la marca de base de datos que se requiere para habilitar PolyBase, independientemente del tipo de fuente de datos externa.

    Debes ingresar cloud sql enable polybase=on.

    Para obtener más información, consulta Marcas de base de datos.

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"

Reemplaza lo siguiente:

  • INSTANCE_NAME: el nombre de la instancia de Cloud SQL.
  • VERSION: la versión de la base de datos que deseas usar.
  • LOCATION: la ubicación de la instancia de Cloud SQL.
  • PASSWORD: la contraseña de la instancia de Cloud SQL.
  • EDITION: la edición de la base de datos que deseas usar.
  • NUMBER_OF_CPUs: la cantidad de CPU que deseas usar.
  • MEMORY_SIZE: la cantidad de memoria que deseas usar.

  • DATABASE_FLAG_CLOUD_STORAGE: los valores de la marca de base de datos que se requieren para habilitar PolyBase. Si tu fuente de datos externa es Cloud Storage, debes ingresar cloud sql enable polybase=on,13702=on.

    Para obtener más información, consulta Marcas de base de datos.

Habilita PolyBase en una instancia existente

Para habilitar PolyBase en una instancia existente, ejecuta el siguiente gcloud comando:

Oracle 

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

Reemplaza lo siguiente:

  • INSTANCE_NAME: el nombre de la instancia de Cloud SQL.
  • DATABASE_FLAG: el valor de la marca de base de datos que se requiere para habilitar PolyBase, independientemente del tipo de fuente de datos externa.

Debes ingresar cloud sql enable polybase=on.

Este ejemplo es solo para fines ilustrativos. Ejecutar una operación patch con una configuración de marca de base de datos específica reemplaza cualquier marca de base de datos existente. Asegúrate de incluir las marcas de base de datos existentes que deseas conservar. Si omites una marca de base de datos establecida anteriormente, la marca omitida se revierte a su valor predeterminado.

Para obtener más información, consulta Marcas de base de datos.

Cloud Storage 

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

Reemplaza lo siguiente:

  • INSTANCE_NAME: el nombre de la instancia de Cloud SQL.
  • DATABASE_FLAG_CLOUD_STORAGE: el valor de la marca de base de datos que se requiere para habilitar PolyBase, independientemente del tipo de fuente de datos externa.

Debes ingresar cloud sql enable polybase=on,13702=on.

Este ejemplo es solo para fines ilustrativos. Ejecutar una operación patch con una configuración de marca de base de datos específica reemplaza cualquier marca de base de datos existente. Asegúrate de incluir las marcas de base de datos existentes que deseas conservar. Si omites una marca de base de datos establecida anteriormente, la marca omitida se revierte a su valor predeterminado.

Para obtener más información, consulta Marcas de base de datos.

Verifica la configuración de la instancia

Para verificar si PolyBase está habilitado en una instancia existente, ejecuta el siguiente gcloud comando:

gcloud 

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

Reemplaza lo siguiente:

  • INSTANCE_NAME: el nombre de la instancia de Cloud SQL.

Inhabilita PolyBase

Para inhabilitar PolyBase en una instancia, ejecuta el siguiente gcloud comando:

gcloud 

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

Reemplaza lo siguiente:

  • INSTANCE_NAME: el nombre de la instancia de Cloud SQL.

Cuando se inhabilita PolyBase, no se borran los siguientes recursos de PolyBase:

  • Bases de datos del sistema DW
  • Clave principal de la base de datos (DMK)
  • Fuentes de datos
  • Credenciales con alcance de datos
  • Tablas externas

Estos recursos se conservan en caso de que desees volver a habilitar la función en el futuro.

¿Qué sigue?