Activer et désactiver PolyBase

<meta <="" content="Cette page explique comment activer et désactiver PolyBase avec vos instances Cloud SQL pour SQL Server." name="description" />

Cette page vous explique comment activer et désactiver PolyBase pour vos instances Cloud SQL pour SQL Server.

Pour obtenir des informations générales sur PolyBase, consultez Compatibilité de Cloud SQL pour SQL Server avec PolyBase.

Pour savoir comment configurer les sources de données externes, consultez Configurer des sources de données externes à utiliser avec PolyBase.

Avant de commencer

  1. Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.

  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. Configurez votre réseau pour autoriser le trafic entre Cloud SQL pour SQL Server et votre source de données externe.
    • Si SQL Server ne parvient pas à établir une connexion, la commande T-SQL permettant de configurer ou d'interroger la source de données externe échoue.

    • Que vous utilisiez une adresse IP publique ou privée, assurez-vous que votre instance Cloud SQL et toutes les ressources Google Cloud associées ont accès à votre source de données externe dans le pare-feu de la source de données.

      Si vous utilisez l'adresse IP publique de l'instance Cloud SQL, vous devez également obtenir l'accès à la VM Compute Engine sous-jacente et récupérer son adresse IP. Étant donné que cette VM sous-jacente n'est pas externalisée pour les utilisateurs, vous devez contacter l'assistanceGoogle Cloud pour récupérer son adresse IP. Cette adresse IP peut changer si l'instance est recréée.

  11. Pour activer ou désactiver PolyBase, vous devez disposer des autorisations suivantes :
    • cloudsql.instances.get
    • cloudsql.instances.update
    Les rôles suivants fournissent les autorisations précédentes :
    • roles/cloudsql.editor
    • roles/cloudsql.admin

    Nous vous recommandons d'utiliser le principe du moindre privilège lorsque vous accordez l'accès.

    Vous pouvez également attribuer ces autorisations à un rôle personnalisé.

  12. Examinez les noms de bases de données d'entrepôt existants de votre instance.

    Lorsque PolyBase est activé, trois nouvelles bases de données d'entrepôt de données PolyBase sont créées :

    • DWConfiguration
    • DWQueue
    • DWDiagnostics

    Avant d'activer la fonctionnalité, utilisez un outil tel que SQL Server Management Studio (SSMS) pour vérifier si des bases de données portant ces noms existent déjà. Si c'est le cas, contactez l'assistanceGoogle Cloud pour obtenir de l'aide avant de continuer.

    Certaines restrictions s'appliquent à ces bases de données système :

    • Vous ne pouvez pas utiliser la console Google Cloud , l'API Cloud SQL Admin ni gcloud CLI pour effectuer certaines opérations sur les bases de données DW :
      • Créer
      • Supprimer
      • Liste
      • Importer
      Vous pouvez toutefois utiliser la commande d'exportation pour effectuer une sauvegarde de ces bases de données.
    • Vous ne pouvez pas accéder aux bases de données DW à l'aide de SQL Server Management Studio (SSMS).
    • Si l'instance est répliquée, les bases de données DW ne sont pas copiées dans la nouvelle ressource.
    • Si l'instance est restaurée à l'aide de la récupération à un moment précis, les bases de données DW ne sont pas copiées dans la nouvelle ressource.
    • Les bases de données DW sont conservées même après la désactivation de PolyBase.

    Pour en savoir plus, consultez les ressources suivantes :

Activation de PolyBase à l'aide d'options de base de données

Vous pouvez activer PolyBase avec votre instance Cloud SQL pour SQL Server à l'aide d'options de base de données. Les indicateurs requis varient en fonction du type de source de données externe que vous souhaitez utiliser :

  • L'indicateur de base de données polybase est requis pour toutes les sources de données externes.
  • Si vous utilisez Cloud Storage, vous devez également appliquer l'indicateur de trace Microsoft SQL Server 13702. L'activation de cet indicateur active également d'autres indicateurs de trace requis pour la prise en charge de PolyBase.

Les sections suivantes vous expliquent comment activer PolyBase sur les instances nouvelles et existantes.

Créer une instance avec PolyBase activé

Pour créer une instance avec PolyBase activé, exécutez la commande gcloud suivante :

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"

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de l'instance Cloud SQL.
  • VERSION : version de la base de données que vous souhaitez utiliser.
  • LOCATION : emplacement de l'instance Cloud SQL.
  • PASSWORD : mot de passe de l'instance Cloud SQL.
  • EDITION : édition de la base de données que vous souhaitez utiliser.
  • NUMBER_OF_CPUs : nombre de processeurs que vous souhaitez utiliser.
  • MEMORY_SIZE : quantité de mémoire que vous souhaitez utiliser.

  • DATABASE_FLAG : valeur de l'indicateur de base de données requise pour activer PolyBase, quel que soit le type de source de données externe.

    Vous devez saisir cloud sql enable polybase=on.

    Pour en savoir plus, consultez Options de base de données.

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"

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de l'instance Cloud SQL.
  • VERSION : version de la base de données que vous souhaitez utiliser.
  • LOCATION : emplacement de l'instance Cloud SQL.
  • PASSWORD : mot de passe de l'instance Cloud SQL.
  • EDITION : édition de la base de données que vous souhaitez utiliser.
  • NUMBER_OF_CPUs : nombre de processeurs que vous souhaitez utiliser.
  • MEMORY_SIZE : quantité de mémoire que vous souhaitez utiliser.

  • DATABASE_FLAG_CLOUD_STORAGE : valeurs des indicateurs de base de données requis pour activer PolyBase. Si votre source de données externe est Cloud Storage, vous devez saisir cloud sql enable polybase=on,13702=on.

    Pour en savoir plus, consultez Options de base de données.

Activer PolyBase sur une instance existante

Pour activer PolyBase sur une instance existante, exécutez la commande gcloud suivante :

Oracle 

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

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de l'instance Cloud SQL.
  • DATABASE_FLAG : valeur de l'indicateur de base de données requise pour activer PolyBase, quel que soit le type de source de données externe.

Vous devez saisir cloud sql enable polybase=on.

Cet exemple n'est fourni qu'à titre indicatif. L'exécution d'une opération patch avec un paramètre d'option de base de données spécifique remplace toutes les options de base de données existantes. Veillez à inclure les indicateurs de base de données existants que vous souhaitez conserver. Si vous omettez un indicateur de base de données précédemment défini, il est rétabli à sa valeur par défaut.

Pour en savoir plus, consultez Options de base de données.

Cloud Storage

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

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de l'instance Cloud SQL.
  • DATABASE_FLAG_CLOUD_STORAGE : valeur de l'indicateur de base de données requise pour activer PolyBase, quel que soit le type de source de données externe.

Vous devez saisir cloud sql enable polybase=on,13702=on.

Cet exemple n'est fourni qu'à titre indicatif. L'exécution d'une opération patch avec un paramètre d'option de base de données spécifique remplace toutes les options de base de données existantes. Veillez à inclure les indicateurs de base de données existants que vous souhaitez conserver. Si vous omettez un indicateur de base de données précédemment défini, il est rétabli à sa valeur par défaut.

Pour en savoir plus, consultez Options de base de données.

Vérifier la configuration d'une instance

Pour vérifier si PolyBase est activé sur une instance existante, exécutez la commande gcloud suivante :

gcloud 

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

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de l'instance Cloud SQL.

Désactiver PolyBase

Pour désactiver PolyBase sur une instance, exécutez la commande gcloud suivante :

gcloud 

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

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de l'instance Cloud SQL.

Lorsque PolyBase est désactivé, les ressources PolyBase suivantes ne sont pas supprimées :

  • Bases de données du système DW
  • Clé principale de la base de données (DMK)
  • Sources de données
  • Identifiants limités aux données
  • Tables externes

Ces ressources sont conservées au cas où vous souhaiteriez réactiver la fonctionnalité à l'avenir.

Étapes suivantes