Habilita e inhabilita PolyBase

<meta <="" content="En esta página, se describe cómo habilitar y, luego, inhabilitar 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 conexión, consulta Configura fuentes de datos externas para usarlas con PolyBase.

Antes de comenzar

  1. Accede a tu cuenta de Google Cloud . 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 de 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 todos los recursos Google Cloud compatibles 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 subyacente de Compute Engine y obtener su dirección IP. Dado que esta VM subyacente no se expone a los usuarios, debes comunicarte con el Google Cloud equipo de asistencia para recuperar su dirección IP. 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 privilegio mínimo 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 almacenamiento existentes de tu instancia.

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

    • DWConfiguration
    • DWQueue
    • DWDiagnostics

    Antes de habilitar la funció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 Google Cloud equipo de asistencia 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 las bases de datos de DW:
      • Crear
      • Borrar
      • Lista
      • Importar
      Sin embargo, puedes usar el comando de exportación para crear una copia de seguridad de estas bases de datos.
    • No puedes acceder a las bases de datos de DW con SQL Server Management Studio (SSMS).
    • Si la instancia se replica, las bases de datos de DW no se copian en el recurso nuevo.
    • Si la instancia se restablece con la PITR, las bases de datos de DW no se copian en el recurso nuevo.
    • Las bases de datos de DW se conservan incluso después de inhabilitar PolyBase.

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

Habilitación de PolyBase con marcas de bases de datos

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

  • La marca de base de datos polybase es obligatoria para todas las fuentes de datos externas.
  • Si usas Cloud Storage, también debes aplicar la marca de seguimiento de Microsoft SQL Server, 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 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"

Reemplaza lo siguiente:

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

  • DATABASE_FLAG: Es el valor de la marca de la 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 bases 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: Es la versión de la base de datos que deseas usar.
  • LOCATION: Es la ubicación de la instancia de Cloud SQL.
  • PASSWORD: La contraseña de la instancia de Cloud SQL.
  • EDITION: Es la edición de la base de datos que deseas usar.
  • NUMBER_OF_CPUs: Es la cantidad de CPU que deseas usar.
  • MEMORY_SIZE: Es la cantidad de memoria que deseas usar.

  • DATABASE_FLAG_CLOUD_STORAGE: Son los valores de la marca de la base de datos necesarios 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 bases de datos.

Habilita PolyBase en una instancia existente

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

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: Es el valor de la marca de la 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 solo tiene fines ilustrativos. Si ejecutas una operación patch con un parámetro de configuración específico de la marca de base de datos, se reemplazarán las marcas de base de datos existentes. Asegúrate de incluir las marcas de bases de datos existentes que quieras 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 bases 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: Es el valor de la marca de la 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 solo tiene fines ilustrativos. Si ejecutas una operación patch con un parámetro de configuración específico de la marca de base de datos, se reemplazarán las marcas de base de datos existentes. Asegúrate de incluir las marcas de bases de datos existentes que quieras 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 bases de datos.

Verifica la configuración de la instancia

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

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 comando de gcloud:

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 PolyBase está inhabilitado, no se borran los siguientes recursos de PolyBase:

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

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

¿Qué sigue?