Extremos regionales
En esta página, se describen los extremos regionales de Cloud Bigtable, se explica lo que debes tener en cuenta antes de usarlos y se muestra cómo configurar un extremo mediante Google Cloud CLI.
Puedes usar un extremo de servicio global o regional para enviar solicitudes a Bigtable. Los extremos regionales de Bigtable garantizan y garantizan que los datos de una instancia se almacenen y procesen en la región de Bigtable donde residen los datos. Es posible que debas usar extremos regionales para Bigtable en una región geográfica específica a fin de satisfacer las necesidades de seguridad y cumplimiento de tu proyecto.
Antes de leer este documento, debes familiarizarte con las instancias, clústeres y nodos y los perfiles de apps.
Entre los conceptos clave, se incluyen los siguientes:
Extremo de servicio: Un extremo de servicio es una URL base que especifica la dirección de red de un servicio de API. Bigtable tiene extremos globales y regionales.
Extremo global: Un extremo global permite que Bigtable almacene y enrute los datos de una instancia de Bigtable a cualquier región que contenga uno de los clústeres de la instancia. El extremo global de la API de datos de Bigtable es
bigtable.googleapis.com. El extremo predeterminado de la API de datos accede al extremo global.Extremo regional: Un extremo regional aplica restricciones regionales para garantizar que los datos se almacenen y se procesen en una región específica.
Solo puedes usar extremos regionales con la API de datos de Bigtable. Los extremos regionales no son compatibles con la API de Administrador de Bigtable.
Cuándo usar extremos regionales
El beneficio de usar un extremo regional de Bigtable en lugar de un extremo global es que el extremo regional proporciona aislamiento y protección regionales para cumplir con los requisitos normativos, de seguridad y de cumplimiento.
Usa un extremo regional si la ubicación de tus datos debe restringirse y controlarse para cumplir con los requisitos reglamentarios.
Usa el extremo global si no tienes requisitos estrictos de restricción regional.
Consideraciones para usar un extremo regional
Ubicaciones del clúster
Antes de poder usar un extremo regional, debes crear una instancia con al menos un clúster en la región en la que quieres aislar tus datos. Los extremos regionales de Bigtable están disponibles en todas las ubicaciones de Bigtable.
Solo puedes usar un extremo regional que pertenezca a la región en la que deseas aislar tus datos. Por ejemplo, no puedes usar us-west1-bigtable.googleapis.com para entregar solicitudes si el clúster al que accedes está en la región us-central1.
Si intentas usar un extremo regional para acceder a un clúster en una región diferente, la solicitud se rechaza con un error FAILED_PRECONDITION que indica que no se puede acceder a ningún clúster con el clúster y el extremo especificados. Por ejemplo, una solicitud enviada a us-west1-bigtable.googleapis.com para clústeres en us-central1 falla con FAILED_PRECONDITION. Si quieres obtener más información sobre FAILED_PRECONDITION, consulta Códigos de estado de Bigtable.
Perfiles de app
Después de establecer un extremo regional, debes usar un perfil de aplicación configurado para enrutar solicitudes a un clúster en la región del extremo.
Si intentas usar un perfil de app configurado para enviar operaciones de escritura solo a un clúster (mediante el enrutamiento de un solo clúster) o a clústeres en una región diferente del extremo (mediante el enrutamiento de varios clústeres), recibirás el mensaje de error de condición previa con errores There are no clusters accessible through this app profile and the
REGION_NAME endpoint.. Para obtener más información sobre el enrutamiento de clústeres, consulta Política de enrutamiento.
Si usas un perfil de aplicación configurado a fin de enrutar a cualquier clúster en una instancia para alta disponibilidad (HA), y también usas un extremo regional, el extremo regional garantiza que todas las solicitudes se enruten solo a clústeres en su región, incluso si la instancia tiene clústeres en otras regiones. La conmutación por error automática está restringida, por lo que las solicitudes solo se entregan desde clústeres en la región del extremo.
Considera un ejemplo en el que envías solicitudes mediante un perfil de aplicación configurado para el enrutamiento de varios clústeres a una instancia que tiene clústeres en us-west1-a (Oregón), us-west1-b (Oregón) y us-central1-a (Iowa). Si envías estas solicitudes al extremo regional us-central1-bigtable.googleapis.com, us-central1-a entrega todas las solicitudes, incluso si no vuelves a configurar el perfil de la app. Las solicitudes que us-central1-a no puede entregar fallan.
Replicación
Los extremos regionales no afectan ni impiden la replicación. Si configuras un extremo regional en la región A y, luego, agregas un clúster a la instancia en la región B, tus datos se replicarán en la región B como lo harías si usas el extremo global.
Para evitar replicar datos en otra región, crea clústeres solo en la región deseada.
Para evitar que los usuarios de tu organización agreguen clústeres fuera de la región de extremo, puedes establecer una política de la organización que use restricciones de ubicación. Para obtener más información, consulta Cómo restringir las ubicaciones de recursos.
Disponibilidad
Cuando usas extremos regionales, no puedes configurar Bigtable para lograr un porcentaje de tiempo de actividad mensual de >=99.999%. Un tiempo de actividad mensual de >=99.999% requiere conmutación por error automática de solicitudes que superan los límites regionales, lo que evita un extremo regional porque confunde todas las solicitudes a una sola región. Si deseas obtener más información sobre los porcentajes de tiempo de actividad mensuales, consulta el Acuerdo de Nivel de Servicio (ANS) de Cloud Bigtable.
Semántica de los extremos regionales
El primer segmento de un nombre de extremo regional de Bigtable es el nombre de la región de Google Cloud. Un extremo regional sigue el formato REGION-bigtable.googleapis.com, en el que REGION es el nombre de una región, como northamerica-northeast2.
Por ejemplo, si deseas aislar tus datos en la región de Iowa, porque el nombre de la región de Iowa es us-central1, la URL del extremo regional de la región de Iowa es us-central1-bigtable.googleapis.com. Para obtener una lista de las regiones disponibles, consulta Ubicaciones de Bigtable.
Especifica un extremo regional
Puedes especificar un extremo regional de Bigtable mediante Google Cloud CLI, la CLI de cbt o las bibliotecas cliente de Bigtable.
gcloud
Para especificar un extremo regional y anularlo con la CLI de gcloud, ejecuta el siguiente comando:
gcloud config set api_endpoint_overrides/bigtable https://REGION-bigtable.googleapis.com/
Reemplaza REGION por la región en la que deseas configurar un extremo regional, como us-central1 o europe-west1.
Por ejemplo, para configurar el extremo regional como us-central1, ejecuta el siguiente comando:
gcloud config set api_endpoint_overrides/bigtable https://us-central1-bigtable.googleapis.com/
cbt
Para especificar un extremo regional y anular el extremo global con la CLI de cbt, puedes usar la opción --data-endpoint en tu solicitud o agregar lo siguiente a tu archivo ~/.cbtrc. Para obtener información adicional sobre la creación de un archivo ~/.cbtrc, consulta la referencia de la CLI de cbt.
data-endpoint = https://REGION-bigtable.googleapis.com/
Reemplaza REGION por la región en la que deseas configurar un extremo regional, como us-central1 o europe-west1.
Por ejemplo, para configurar el extremo regional como us-central1, agrega esto al archivo ~/.cbtrc:
data-endpoint = https://us-central1-bigtable.googleapis.com/
Especifica el extremo global
gcloud
Para volver a configurar un extremo regional al extremo global, ejecute el siguiente comando:
gcloud config unset api_endpoint_overrides/bigtable
cbt
Para especificar el punto de envío global, envía tu solicitud sin usar la opción --data-endpoint. Si ya agregaste una línea data-endpoint a tu archivo ~/.cbtrc, bórralo.