Implementa un conector de bases de datos

Puedes configurar Google Cloud Search para descubrir e indexar datos de las bases de datos de tu organización con el conector de bases de datos de Cloud Search.

Consideraciones importantes

Puedes instalar y ejecutar el conector de bases de datos de Cloud Search en casi cualquier entorno en el que se pueden ejecutar las aplicaciones de Java, siempre que el conector tenga acceso tanto a Internet como a la base de datos.

Requisitos del sistema

Implementa el conector

En estos pasos, se describe cómo instalar el conector y configurarlo para indexar tus bases de datos y mostrar resultados a los usuarios de Cloud Search.

Requisitos previos

Antes de implementar el conector, recopila esta información:

• Clave privada de Google Workspace (que contiene el ID de cuenta de servicio). Consulta Configura el acceso a la API de Cloud Search.
• ID de la fuente de datos de Google Workspace. Consulta Agrega una fuente de datos a la búsqueda.

Paso 1: Descarga y compila el software del conector de bases de datos

1. Clona el repositorio del conector desde GitHub.

   $ git clone https://github.com/google-cloudsearch/database-connector.git
   $ cd database-connector

2. Revisa la versión seleccionada:

   $ git checkout tags/v1-0.0.3

3. Compila el conector:

   $ mvn package

   Para omitir las pruebas, usa mvn package -DskipTests.

4. Extrae el archivo ZIP del conector en tu directorio de instalación:

   $ cp target/google-cloudsearch-database-connector-v1-0.0.3.zip installation-dir
   $ cd installation-dir
   $ unzip google-cloudsearch-database-connector-v1-0.0.3.zip
   $ cd google-cloudsearch-database-connector-v1-0.0.3

Paso 2: Configura el conector de bases de datos

1. Crea un archivo de texto llamado connector-config.properties (el predeterminado). Google recomienda la extensión .properties o .config. Mantén el archivo en el mismo directorio que el conector.

2. Agrega parámetros como pares clave-valor. El archivo debe especificar el acceso a la fuente de datos, el acceso a la base de datos, una instrucción SQL de recorrido completo, un título de campo de contenido y definiciones de columna.

   # Data source access
   api.sourceId=1234567890abcdef
   api.identitySourceId=0987654321lmnopq
   api.serviceAccountPrivateKeyFile=./PrivateKey.json
   
   # Database access
   db.url=jdbc:mysql://localhost:3306/mysql_test
   db.user=root
   db.password=passw0rd
   
   # Full traversal SQL statement
   db.allRecordsSql=select customer_id, first_name, last_name, phone from address_book
   
   # Column definitions and URL format
   db.allColumns=customer_id, first_name, last_name, phone
   db.uniqueKeyColumns=customer_id
   url.columns=customer_id
   
   # Content field
   contentTemplate.db.title=customer_id
   
   # Optional: ACLs
   defaultAcl.mode=fallback
   defaultAcl.public=true
   
   # Optional: traversal schedule
   schedule.traversalIntervalSecs=36000
   schedule.performTraversalOnStart=true
   

   Para obtener parámetros específicos de la base de datos, consulta la Referencia de los parámetros de configuración. Para obtener parámetros comunes, consulta Parámetros de conectores que proporciona Google.

Paso 3: Ejecuta el conector de bases de datos

Ejecuta el conector desde la línea de comandos:

java
   -cp "google-cloudsearch-database-connector-v1-0.0.3.jar:mysql-connector-java-5.1.41-bin.jar"
   com.google.enterprise.cloudsearch.database.DatabaseFullTraversalConnector
   [-Dconfig=mysql.config]

El conector informa errores de configuración y de inicialización. Otros errores, como la sintaxis de SQL no válida, aparecen cuando el conector intenta acceder a la base de datos por primera vez.

Referencia de los parámetros de configuración

En esta sección, se enumeran los parámetros que se usan en el archivo de configuración del conector de bases de datos.

Parámetros de acceso a la fuente de datos

Parámetros de acceso a la base de datos

Parámetros de búsqueda de SQL de recorrido

El conector usa consultas SELECT de SQL para recorrer los registros.

• Recorrido completo: Lee todos los registros configurados. Es obligatorio para la indexación inicial y la reindexación periódica.
• Recorrido incremental: Lee solo los registros recién modificados. Requiere campos de marca de tiempo en la base de datos.

Parámetros de definición de columna

Campos de contenido