Extremos regionales
En esta página, se describen los extremos regionales de Bigtable, se explica lo que deberías considerar antes de usarlos y se muestra cómo configurar un extremo con 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, los clústeres y los nodos y los perfiles de la app.
Los conceptos clave incluyen lo siguiente:
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 Cloud Bigtable (API de datos) es
bigtable.googleapis.com. El extremo predeterminado de la API de datos accede al extremo global.Extremo regional: Un extremo regional aplica restricciones regionales, lo que garantiza que los datos se almacenen y procesen en una región específica.
Solo puedes usar extremos regionales con la API de Cloud Bigtable (API de datos). Los extremos regionales no son compatibles con la API de Cloud Bigtable Admin.
Cuándo usar extremos regionales
El beneficio de usar un extremo regional de Bigtable en lugar de un extremo global es que este proporciona aislamiento y protección regionales para cumplir con los requisitos regulatorios, 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 normativos.
Usa el extremo global si no tienes requisitos de restricción regional estrictos.
Consideraciones para el uso de un extremo regional
Ubicaciones de clústeres
Antes de poder usar un extremo regional, debes crear una instancia con al menos un clúster en la región en la que deseas aislar los 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 y muestra el error FAILED_PRECONDITION con un mensaje que indica que no se puede acceder a ningún clúster mediante 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. Para obtener más información sobre FAILED_PRECONDITION, consulta los códigos de estado de Bigtable.
Perfiles de app
Después de establecer un extremo regional, debes usar un perfil de app configurado para enrutar las 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 (con el enrutamiento de un solo clúster) o a clústeres en una región diferente a la del extremo (con 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 app configurado para enrutar a cualquier clúster de una instancia de alta disponibilidad (HA) y también usas un extremo regional, el extremo regional garantiza que todas las solicitudes se enruten solo a los clústeres de su región, incluso si la instancia tiene clústeres de otras regiones. La conmutación por error automática está restringida, por lo que las solicitudes solo se entregan desde clústeres ubicados en la región del extremo.
Considera un ejemplo en el que envías solicitudes mediante un perfil de app 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 replican en la región B tal como sucede 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 del 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 que logre un porcentaje de tiempo de actividad mensual de >=99.999%. Un tiempo de actividad mensual igual o superior al 99.999% requiere conmutación por error automática de las solicitudes que superen los límites regionales, lo que un extremo regional impide porque limita todas las solicitudes a una sola región. Para obtener más información sobre los porcentajes de tiempo de actividad mensual, consulta el Acuerdo de Nivel de Servicio (ANS) de 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 un nombre de región, como northamerica-northeast2.
Por ejemplo, si deseas aislar tus datos en la región de Iowa, ya que el nombre de la región es us-central1, la URL del extremo regional de esta región 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 con Google Cloud CLI, la CLI de cbt o las bibliotecas cliente de Cloud Bigtable.
gcloud
Para especificar un extremo regional y anular el extremo global con la gcloud CLI, 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 establecer 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 puedes agregar lo siguiente a tu archivo ~/.cbtrc. Para obtener información adicional sobre cómo crear 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 establecer un extremo regional, como us-central1 o europe-west1.
Por ejemplo, para configurar el extremo regional como us-central1, agrega lo siguiente al archivo ~/.cbtrc:
data-endpoint = https://us-central1-bigtable.googleapis.com/
Especifica el extremo global
gcloud
Para volver a configurar un extremo regional en el extremo global, ejecuta este 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 agregaste una línea data-endpoint con anterioridad a tu archivo ~/.cbtrc, bórrala.