Mode de mise à jour du schéma

Le mode de schéma définit si un registre de schémas ou un sujet spécifique autorise les modifications, telles que l'écriture ou la modification de schémas.

  • Les valeurs acceptées pour le mode de schéma sont Readonly et Readwrite.

  • Le mode de schéma est géré en tant qu'objet JSON contenant des paires clé/valeur. Voici un exemple :

    {
  "mode": "READWRITE"
}

  • S'il n'est pas défini explicitement au niveau du registre de schémas, le mode de schéma est défini par défaut sur Readwrite.

  • Si un mode de schéma n'est pas spécifié explicitement au niveau du sujet, il hérite de la valeur du registre de schémas.

  • Les configurations définies au niveau du sujet remplacent celles définies au niveau du registre de schémas.

Pour en savoir plus sur le mode de schéma, y compris ses valeurs, consultez Mode de schéma.

Rôles et autorisations requis pour modifier le mode de schéma

Pour obtenir les autorisations nécessaires pour modifier le mode de schéma d'un registre de schémas ou d'un sujet, demandez à votre administrateur de vous accorder le rôle IAM Éditeur de registre de schémas Kafka géré (roles/managedkafka.schemaRegistryEditor) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour modifier le mode de schéma d'un registre de schémas ou d'un sujet. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour modifier le mode de schéma d'un registre de schémas ou d'un sujet :

  • Accordez l'autorisation suivante sur la ressource pour laquelle vous souhaitez modifier le mode : managedkafka.mode.update

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Modifier le mode de schéma d'un registre de schémas

Console

Pour modifier le mode de schéma de l'ensemble du registre de schémas, procédez comme suit :

  1. Dans la Google Cloud console, accédez à la page Registres de schémas.

    Accéder aux registres de schémas

    La liste des registres de schémas de votre projet s'affiche.

  2. Cliquez sur le nom du registre de schémas pour lequel vous souhaitez modifier le mode de schéma.

    La page Détails du registre de schémas s'ouvre.

  3. Dans la section principale des détails du registre, recherchez le paramètre Mode de schéma , puis cliquez sur l'icône Modifier à côté.

    La page Modifier le mode de schéma s'ouvre.

  4. Dans le menu déroulant Mode de schéma, sélectionnez la valeur.

    Pour en savoir plus sur ces valeurs, consultez À propos du mode de schéma.

  5. Cliquez sur Enregistrer.

gcloud

Pour modifier le mode de schéma d'un registre de schémas, utilisez la gcloud alpha managed-kafka schema-registries update commande :

gcloud alpha managed-kafka schema-registries update SCHEMA_REGISTRY_ID \
    --location=LOCATION \
    --mode=MODE_TYPE
  • SCHEMA_REGISTRY_ID : ID du registre de schémas à modifier.
  • LOCATION : région du registre de schémas à modifier.
  • MODE_TYPE : nouveau mode de schéma. Les valeurs valides sont les suivantes :
    • READWRITE
    • READONLY

Exemple :

Pour modifier le mode de schéma du registre de schémas test-registry dans la région us-central1 sur READONLY, exécutez la commande suivante :

gcloud alpha managed-kafka schema-registries update test-registry \
    --location=us-central1 \
    --mode=READONLY

REST

La demande doit être authentifiée à l'aide d'un jeton d'accès dans l'en-tête Authorization. Pour obtenir un jeton d'accès pour les identifiants par défaut actuels de l'application, exécutez la commande suivante : gcloud auth application-default print-access-token.

Pour modifier le mode de schéma, envoyez une requête PUT au point de terminaison de l'API REST pour le registre de schémas à l'aide de la projects.locations.schemaRegistries.contexts.mode.update méthode.

Modification du mode de schéma pour le registre de schémas avec un contexte par défaut :

PUT https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID/mode

Remplacez les paramètres de chemin d'accès suivants :

  • PROJECT_ID : ID de votre projet Google Cloud.
  • LOCATION : région dans laquelle se trouve le registre de schémas.
  • SCHEMA_REGISTRY_ID : ID unique du registre de schémas.

Corps de la requête :

Incluez un objet JSON dans le corps de la requête en spécifiant les détails du mode.

{
  "mode": "MODE_TYPE"
}

Remplacez MODE_TYPE par l'une des options de chaîne valides pour le mode :

  • READWRITE
  • READONLY

En cas de réussite, l'API renvoie un code d'état 200 OK et un corps de réponse contenant la représentation JSON de la configuration du mode modifié.

Pour en savoir plus, reportez-vous à la documentation de l'API REST.

Modifier le mode de schéma d'un sujet

Console

Pour modifier le mode de schéma d'un sujet spécifique, procédez comme suit :

  1. Dans la Google Cloud console, accédez à la page Registres de schémas.

    Accéder aux registres de schémas

  2. Cliquez sur le nom du registre de schémas contenant le sujet.

    La page Détails du registre de schémas s'ouvre.

  3. Dans le tableau Sujets dans ce registre de schémas, cliquez sur le nom du sujet pour lequel vous souhaitez modifier le mode de schéma.
  4. Recherchez le paramètre Mode de schéma du sujet, puis cliquez sur l'icône Modifier à côté.

    La page Modifier le mode de schéma s'ouvre.

  5. Dans le menu déroulant Mode de schéma, sélectionnez la valeur. Le choix d'une valeur ici remplace le paramètre au niveau du registre pour ce sujet spécifique.

    Pour en savoir plus sur ces valeurs, consultez À propos du mode de schéma.

  6. Cliquez sur Enregistrer.

gcloud

Pour modifier le mode de schéma d'un sujet, utilisez la gcloud alpha managed-kafka schema-registries subject update commande :

gcloud alpha managed-kafka schema-registries subject update SUBJECT_NAME \
    --schema-registry=SCHEMA_REGISTRY_ID \
    --location=LOCATION \
    --mode=MODE_TYPE
  • SUBJECT_NAME : nom du sujet à modifier.
  • SCHEMA_REGISTRY_ID : ID du registre de schémas contenant le sujet.
  • LOCATION : région du registre de schémas contenant le sujet.
  • MODE_TYPE : nouveau mode de schéma. Les valeurs valides sont les suivantes :
    • READWRITE
    • READONLY

Exemple :

Pour modifier le mode de schéma du sujet test-subject dans le registre de schémas test-registry dans la région us-central1 sur READONLY, exécutez la commande suivante :

gcloud alpha managed-kafka schema-registries subject update test-subject \
    --schema-registry=test-registry \
    --location=us-central1 \
    --mode=READONLY

REST

La demande doit être authentifiée à l'aide d'un jeton d'accès dans l'en-tête Authorization. Pour obtenir un jeton d'accès pour les identifiants par défaut actuels de l'application, exécutez la commande suivante : gcloud auth application-default print-access-token.

Pour modifier le mode de schéma d'un sujet, envoyez une PUT requête au point de terminaison de l'API REST pour un sujet spécifique à l'aide de la projects.locations.schemaRegistries.contexts.mode.update méthode.

Modification du mode de schéma pour un sujet dans le contexte par défaut :

PUT https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID/mode/SUBJECT_NAME

Remplacez les paramètres de chemin d'accès suivants :

  • PROJECT_ID : ID de votre projet Google Cloud.
  • LOCATION : région dans laquelle se trouve le registre de schémas.
  • SCHEMA_REGISTRY_ID : ID unique du registre de schémas.
  • SUBJECT_NAME : nom du sujet.

Corps de la requête :

Incluez un objet JSON dans le corps de la requête en spécifiant les détails du mode.

{
  "mode": "MODE_TYPE"
}

Remplacez MODE_TYPE par l'une des options de chaîne valides pour le mode :

  • READWRITE
  • READONLY

Exemple : Définissez le mode de schéma du sujet user_events sur Readonly dans le contexte par défaut :

Requête à PUT https://managedkafka.googleapis.com/v1main/projects/test-gcp-project/locations/us-east1/schemaRegistries/main_registry/mode/user_events

Avec le corps :

{
  "mode": "READONLY"
}

En cas de réussite, l'API renvoie un code d'état 200 OK et un corps de réponse contenant la représentation JSON du sujet ou de la ressource de contexte modifié reflétant ce changement.

Modification du mode de schéma pour un sujet dans un contexte spécifique :

PUT https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID/contexts/CONTEXT_NAME/mode/SUBJECT_NAME

Remplacez les paramètres de chemin d'accès suivants :

  • PROJECT_ID : ID de votre projet Google Cloud.
  • LOCATION : région dans laquelle se trouve le registre de schémas.
  • SCHEMA_REGISTRY_ID : ID unique du registre de schémas.
  • CONTEXT_NAME : nom du contexte.
  • SUBJECT_NAME : nom du sujet.

Corps de la requête :

Incluez un objet JSON dans le corps de la requête en spécifiant les détails du mode.

{
  "mode": "MODE_TYPE"
}

Remplacez MODE_TYPE par l'une des options de chaîne valides pour le mode :

  • READWRITE
  • READONLY

Exemple : Définissez le mode de schéma du sujet user_events sur Readonly dans le contexte test_context :

Requête à PUT https://managedkafka.googleapis.com/v1main/projects/test-gcp-project/locations/us-east1/schemaRegistries/main_registry/contexts/test_context/mode/user_events

Avec le corps :

{
  "mode": "READONLY"
}

En cas de réussite, l'API renvoie un code d'état 200 OK et un corps de réponse contenant la représentation JSON du sujet ou de la ressource de contexte modifié reflétant ce changement.

Pour en savoir plus, reportez-vous à la documentation de l'API REST.

Étape suivante

Apache Kafka® est une marque déposée d'Apache Software Foundation ou de ses filiales aux États-Unis et/ou dans d'autres pays.