Points de terminaison localisés

Cette page décrit les points de terminaison géographiques Bigtable, explique ce que vous devez prendre en compte avant de les utiliser et montre comment définir un point de terminaison à l'aide de la Google Cloud CLI.

Vous pouvez utiliser un point de terminaison de service global ou de localisation pour envoyer des requêtes Bigtable. Les points de terminaison locaux de Bigtable que les données d'une instance sont stockées et traitées dans Bigtable région où résident les données. Vous devrez peut-être utiliser points de terminaison locaux pour Bigtable dans une région géographique spécifique pour répondre aux besoins de sécurité et de conformité de votre projet.

Avant de lire ce document, vous devez connaître les instances, clusters et nœuds et les profils d'application.

Voici les concepts clés:

  • Point de terminaison du service:un service point de terminaison est une URL de base spécifie l'adresse réseau d'un service d'API. Bigtable dispose de points de terminaison globaux et de points de terminaison géographiques.

  • Point de terminaison global : un point de terminaison global permet à Bigtable de stocker et d'acheminer les données d'une instance Bigtable vers n'importe quelle région contenant l'un des clusters de l'instance. Le point de terminaison global de l'API Cloud Bigtable (API Data) est bigtable.googleapis.com. Les données par défaut Le point de terminaison de l'API accède au point de terminaison global.

  • Point de terminaison localisé Un point de terminaison localisé applique des restrictions géographiques, en s'assurant que les données sont stockées et traitées dans une région spécifiée.

Vous ne pouvez utiliser des points de terminaison localisés qu'avec l'API Cloud Bigtable (API Data). Les points de terminaison géographiques ne sont pas compatibles avec l'API Cloud Bigtable Admin.

Quand utiliser les points de terminaison locaux ?

L'avantage d'utiliser un point de terminaison local Bigtable plutôt que est qu'il fournit une isolation de l'emplacement pour répondre aux exigences réglementaires, de sécurité et de conformité.

Utilisez un point de terminaison géographique si l'emplacement de vos données doit être limité et contrôlé afin de respecter les exigences réglementaires.

Utilisez le point de terminaison global si vous n'avez pas de restriction d'emplacement stricte exigences.

Éléments à prendre en compte lors de l'utilisation d'un point de terminaison localisé

Tenez compte des facteurs suivants lorsque vous utilisez un point de terminaison localisé.

Emplacements des clusters

Avant de pouvoir utiliser un point de terminaison local, vous devez créer une instance dont le au moins un cluster dans la région où vous souhaitez isoler vos données. Les points de terminaison localisés Bigtable sont disponibles dans tous les emplacements Bigtable.

Vous ne pouvez utiliser qu'un point de terminaison géographique appartenant à la région dans laquelle vous souhaitez isoler vos données. Par exemple, vous ne pouvez pas utiliser us-west1-bigtable.googleapis.com pour diffuser les requêtes si le cluster que vous se trouve dans la région us-central1.

Si vous essayez d'utiliser une adresse e-mail point de terminaison pour accéder à un cluster situé dans une région différente, la requête est rejetée avec une erreur FAILED_PRECONDITION avec un message indiquant qu'aucun cluster n'est accessible à l'aide du cluster et du point de terminaison spécifiés. Par exemple, une requête envoyée à us-west1-bigtable.googleapis.com pour les clusters dans us-central1 échoue avec FAILED_PRECONDITION. Pour en savoir plus sur FAILED_PRECONDITION, consultez la section Codes d'état Bigtable.

Profils d'application

Après avoir défini un point de terminaison localisé, vous devez utiliser un profil d'application qui est configuré pour acheminer les requêtes vers un cluster de la région du point de terminaison.

Si vous essayez d'utiliser un profil d'application configuré pour envoyer des écritures uniquement à un cluster (à l'aide du routage à cluster unique) ou à des clusters situés dans une région différente du point de terminaison (à l'aide du routage multicluster), vous recevez le message d'erreur There are no clusters accessible through this app profile and the REGION_NAME endpoint.. Pour en savoir plus sur le routage de cluster, consultez la section Règle de routage.

Si vous utilisez un profil d'application configuré pour acheminer les données vers n'importe quel cluster d'une pour la haute disponibilité. De plus, vous utilisez un point de terminaison localisé, ce point de terminaison local garantit que toutes les requêtes sont acheminées uniquement vers les clusters même si l'instance possède des clusters dans d'autres régions. Automatique le basculement est limité, de sorte que les requêtes ne sont diffusés qu'à partir de clusters situés dans la région du point de terminaison.

Prenons l'exemple d'une instance contenant des clusters dans us-west1-a (Oregon), us-west1-b (Oregon) et us-central1-a (Iowa) à laquelle vous envoyez des requêtes à l'aide d'un profil d'application configuré pour le routage multicluster. Si vous envoyez ces requêtes au us-central1-bigtable.googleapis.com toutes les requêtes sont diffusées par us-central1-a, même si vous ne reconfigurer le profil d'application. Les requêtes qui ne peuvent pas être traitées par us-central1-a échouent.

Réplication

Les points de terminaison locaux n'affectent pas et n'empêchent pas la réplication. Si vous configurez un point de terminaison géographique dans la région A, puis que vous ajoutez un cluster à votre instance dans la région B, vos données sont répliquées dans la région B, comme si vous utilisiez le point de terminaison mondial.

Pour éviter de répliquer des données dans une autre région, ne créez des clusters que dans la région souhaitée.

Pour empêcher les utilisateurs de votre organisation d'ajouter des clusters en dehors de la région des points de terminaison, vous pouvez définir une règle d'administration qui utilise des contraintes de localisation. Pour en savoir plus, consultez la section Limiter les emplacements de ressources.

Disponibilité

Lorsque vous utilisez des points de terminaison localisés, vous ne pouvez pas configurer Bigtable pour obtenir un pourcentage de disponibilité mensuel supérieur ou égal à 99,999 %. un temps d'activité mensuel supérieur ou égal à 99,999 % ; nécessite un basculement automatique au-delà des limites géographiques, ce qu'un point de terminaison local empêche car il confine toutes les requêtes à une seule région. Pour en savoir plus sur les pourcentages de disponibilité mensuels, consultez le contrat de niveau de service (CLN) Bigtable.

Sémantique du point de terminaison localisé

Le premier segment du nom d'un point de terminaison géographique Bigtable est le nom de la région Google Cloud. Un point de terminaison local respecte le format REGION-bigtable.googleapis.com, où REGION est un nom de région, tel que northamerica-northeast2

Par exemple, si vous souhaitez isoler vos données dans la région de l'Iowa, nom de la région pour l'Iowa est us-central1, l'URL du point de terminaison local pour l'Iowa est us-central1-bigtable.googleapis.com. Pour obtenir la liste des consultez la section Emplacements Bigtable.

Spécifier un point de terminaison localisé

Vous pouvez spécifier un point de terminaison local Bigtable à l'aide du Google Cloud CLI, la CLI cbt ou le client Cloud Bigtable bibliothèques.

gcloud

Pour spécifier un point de terminaison local et remplacer le point de terminaison global à l'aide de la méthode gcloud CLI, exécutez la commande suivante:

gcloud config set api_endpoint_overrides/bigtable https://REGION-bigtable.googleapis.com/

Remplacez REGION par la région dans laquelle vous souhaitez définir une point de terminaison localisé, tel que us-central1 ou europe-west1.

Par exemple, pour configurer le point de terminaison géographique en tant que us-central1, exécutez la commande suivante :

gcloud config set api_endpoint_overrides/bigtable https://us-central1-bigtable.googleapis.com/

cbt

Pour spécifier un point de terminaison local et remplacer le point de terminaison global à l'aide de la CLI cbt, procédez comme suit : vous pouvez utiliser l'option --data-endpoint dans votre requête ou ajouter l'option à votre fichier ~/.cbtrc. Pour en savoir plus sur la création ~/.cbtrc, consultez la documentation de référence de la CLI cbt.

data-endpoint = https://REGION-bigtable.googleapis.com/

Remplacez REGION par la région dans laquelle vous souhaitez définir un point de terminaison géographique, par exemple us-central1 ou europe-west1.

Par exemple, pour configurer le point de terminaison local en tant que us-central1, ajoutez ceci à Fichier ~/.cbtrc:

data-endpoint = https://us-central1-bigtable.googleapis.com/

Spécifier le point de terminaison global

gcloud

Pour reconfigurer un point de terminaison géographique en point de terminaison global, exécutez la commande suivante :

gcloud config unset api_endpoint_overrides/bigtable

cbt

Pour spécifier le point de terminaison global, envoyez votre requête sans utiliser l'option --data-endpoint. Si vous avez déjà ajouté une ligne data-endpoint dans votre fichier ~/.cbtrc, supprimez-le.

Étape suivante