Bigtable

El conector de Bigtable te permite realizar operaciones de inserción, eliminación, actualización y lectura en los datos de Bigtable.

Versiones compatibles

Este conector es compatible con la versión 2 de Google Bigtable.

Antes de comenzar

Antes de usar el conector de Bigtable, haz lo siguiente en tu Google Cloud proyecto:

  • Asegúrate de que la conectividad de red esté configurada. Para obtener información sobre los patrones de red, consulta Conectividad de red.
  • Otorga el rol de IAM roles/connectors.admin al usuario que configura el conector.
  • Otorga los roles de IAM roles/secretmanager.viewer y roles/secretmanager.secretAccessor a la cuenta de servicio que deseas usar para el conector.
  • Habilita los siguientes servicios:
    • secretmanager.googleapis.com (API de Secret Manager)
    • connectors.googleapis.com (API de conectores)

    Para comprender cómo habilitar servicios, consulta Habilita servicios. Si estos servicios o permisos no se habilitaron antes para tu proyecto, se te solicitará que los habilites cuando configures el conector.

Configura el conector

Una conexión es específica de una fuente de datos. Significa que, si tienes muchas fuentes de datos, debes crear una conexión independiente para cada fuente. Para crear una conexión, haz lo siguiente:

  1. En la consola de Cloud, ve a la página Conectores de Integration > Conexiones y, luego, selecciona o crea un proyecto de Google Cloud.

    Ir a la página Conexiones

  2. Haz clic en + CREAR NUEVO para abrir la página Crear conexión.
  3. En la sección Ubicación, elige la ubicación para la conexión.
    1. Región: selecciona una ubicación de la lista desplegable.

      Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.

    2. Haz clic en SIGUIENTE.
  4. En la sección Detalles de la conexión, completa lo siguiente:
    1. Conector: Selecciona Bigtable en la lista desplegable de conectores disponibles.
    2. Versión del conector: selecciona la versión del conector de la lista desplegable de versiones disponibles.
    3. En el campo Nombre de la conexión, ingresa un nombre para la instancia de conexión.

      Los nombres de las conexiones deben cumplir con los siguientes criterios:

      • Los nombres de las conexiones pueden usar letras, números o guiones.
      • Las letras deben estar en minúsculas.
      • Los nombres de las conexiones deben comenzar con una letra y terminar con una letra o un número.
      • Los nombres de las conexiones no pueden superar los 49 caracteres.
    4. De manera opcional, ingresa una Descripción para la instancia de conexión.
    5. De manera opcional, habilita Cloud Logging y, luego, selecciona un nivel de registro. De forma predeterminada, el nivel de registro se establece en Error.
    6. Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
    7. ID del proyecto: Es el ID del proyecto que contiene la instancia de Bigtable.
    8. ID de instancia: Es el ID de la instancia de Bigtable.
    9. Tamaño del grupo de conexiones: Es el tamaño del grupo de conexiones de Bigtable.
    10. De manera opcional, configura los parámetros de nodo de conexión:

      • Cantidad mínima de nodos: Ingresa la cantidad mínima de nodos de conexión.
      • Cantidad máxima de nodos: Ingresa la cantidad máxima de nodos de conexión.

      Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se requieren más nodos para procesar más transacciones para una conexión y, del mismo modo, se requieren menos para procesar menos transacciones. Para comprender cómo los nodos afectan el precio del conector, consulta Precios de nodos de conexión. Si no ingresas ningún valor, se establecen de forma predeterminada los nodos mínimos en 2 (para una mejor disponibilidad) y los nodos máximos se establecen en 50.

    11. De forma opcional, haz clic en + AGREGAR ETIQUETA para agregar una etiqueta a la conexión en forma de un par clave-valor.
    12. Haga clic en SIGUIENTE.
  5. En la sección Autenticación, ingresa los detalles de autenticación.
    1. Selecciona un Tipo de autenticación y, luego, ingresa los detalles relevantes.

      La conexión de Bigtable admite los siguientes tipos de autenticación:

      • Autenticación de la cuenta de servicio
      • Código de autorización de OAuth 2.0

      2. Para comprender cómo configurar estos tipos de autenticación, consulta Configura la autenticación.

    2. Haga clic en SIGUIENTE.
  6. Revisa: Revisa tus detalles de conexión y autenticación.
  7. Haz clic en Crear.

Configura la autenticación

Ingresa los detalles según la autenticación que desees usar.

  • Autenticación de la cuenta de servicio: Asegúrate de que la cuenta de servicio tenga los roles necesarios.
  • Código de autorización de OAuth 2.0
    • ID de cliente: Es el ID de cliente que proporciona la aplicación.
    • Alcances: Es la lista de los permisos deseados.
    • Secreto de cliente: Secret de Secret Manager que contiene el secreto del cliente para la aplicación.
    • Versión del Secret: Es la versión del secreto que seleccionaste anteriormente.

Muestras de configuración de conexión

En esta sección, se enumeran los valores de muestra de los diversos campos que configuras cuando creas la conexión.

Tipo de conexión de autenticación de la cuenta de servicio

Nombre del campo Detalles
Ubicación asia-east1
Versión 1
Conector bigtable
Versión del conector 1
Nombre de la conexión googlecloud-bigtable-service-authontication
Cuenta de servicio SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
ID del proyecto ID DEL PROYECTO
ID de instancia gcloud-bigtable-instance
Tamaño del grupo de conexiones 1
Cantidad mínima de nodos 2
Cantidad máxima de nodos 50
Secreto del cliente bigtable-client-secret
Versión del Secret 1

OAuth 2.0: Tipo de conexión del código de autorización

Nombre del campo Detalles
Ubicación asia-east1
Versión 1
Conector bigtable
Versión del conector 1
Nombre de la conexión bigtable-oauth
Cuenta de servicio SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
ID del proyecto ID DEL PROYECTO
ID de instancia googlecloud-bigtable-instance
Tamaño del grupo de conexiones 1
Cantidad mínima de nodos 2
Cantidad máxima de nodos 50
Secreto del cliente bigtable-client-secret
Versión del Secret 1

Limitaciones del sistema

El conector de Bigtable puede procesar un máximo de 16 transacciones por segundo por nodo y limita las transacciones que superen este límite. De forma predeterminada, Integration Connectors asignan 2 nodos (para una mejor disponibilidad) a una conexión.

Para obtener información sobre los límites aplicables a Integration Connectors, consulta Límites.

Usa la conexión de Bigtable en una integración

Después de crear la conexión, estará disponible en la integración de Apigee y en la Application Integration. Puedes usar la conexión en una integración a través de la tarea Connectors.

  • Para comprender cómo crear y usar la tarea Connectors en la integración de Apigee, consulta Tarea Connectors.
  • Para comprender cómo crear y usar la tarea Connectors en Application Integration, consulta Tarea Connectors.

Entidades, operaciones y acciones

Todos los Integration Connectors proporcionan una capa de abstracción para los objetos de la aplicación conectada. Solo puedes acceder a los objetos de una aplicación a través de esta abstracción. La abstracción se expone como entidades, operaciones y acciones.

  • Entidades: Una entidad puede considerarse como un objeto o una colección de propiedades en la aplicación o servicio conectados. La definición de una entidad difiere de conector a conector. Por ejemplo, en un conector de bases de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; en un conector de sistema de mensajería, las colas son las entidades.

    Sin embargo, es posible que un conector no admita o tenga ninguna entidad, en cuyo caso la lista Entities estará vacía.

  • Operaciones: Una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:

    Cuando se selecciona una entidad de la lista disponible, se genera una lista de operaciones disponibles para esa entidad. Para obtener una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea de conectores. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, estas operaciones no compatibles no se incluyen en la lista Operations.

  • Acción: Una acción es una función de primera clase que está disponible para la integración mediante la interfaz de Conectores. Una acción te permite realizar cambios en una entidad o entidades y variar de un conector a otro. Por lo general, una acción tendrá algunos parámetros de entrada y un parámetro de salida. Sin embargo, es posible que un conector no admita ninguna acción, en cuyo caso la lista Actions estará vacía.

Ejemplos de operaciones de entidades

En esta sección, se muestra cómo realizar algunas de las operaciones de la entidad en este conector.

Ejemplo: Cómo obtener un registro de una tabla

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Table en la lista Entity.
  3. Selecciona la operación Get y haz clic en Listo.
  4. Establece el ID de la entidad en Operación Get. Para establecer el ID de la entidad, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa row99 en el campo Input Value y elige EntityId como variable local.

Ejemplo: Muestra una lista de todos los registros de una tabla

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Table en la lista Entity.
  3. Selecciona la operación List y haz clic en Listo.

Ejemplo: Crea un registro en una tabla

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities and select Table2.
  2. Selecciona la operación Create y haz clic en Listo.
  3. Establece la operación RowKey en Create. Para establecer la clave de fila, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa en el campo Input Value y proporciona la clave de fila y la carga útil para la familia de columnas como variable local.

Ejemplo: Actualiza un registro en una tabla

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities and select Table.
  2. Selecciona la operación Update y haz clic en Listo.
  3. Establece el ID de la entidad en la operación de actualización. Para establecer el ID de la entidad, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa en el campo Input Value y proporciona RowKey y la carga útil para la familia de columnas como variable local.

Ejemplo: Borra un registro de una tabla

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities and select Table2.
  2. Selecciona la operación Delete y haz clic en Listo.
  3. Establece el ID de la entidad en la operación Delete. Para establecer el ID de la entidad, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa row99 en el campo Input Value y elige EntityId como variable local.

Obtén ayuda de la Comunidad de Google Cloud

Puedes publicar tus preguntas y debatir sobre este conector en la comunidad de Google Cloud en Cloud Forums.

¿Qué sigue?