Skip To Content

Conectar a Google BigQuery desde ArcGIS

Para conectarse a Google BigQuery, debe instalar y configurar los archivos de cliente para implementar la comunicación entre ArcGIS y BigQuery y crear archivos de conexión a la base de datos de ArcGIS Pro. Para publicar capas web, los archivos de conexión a la base de datos deben registrarse en el sitio del servidor de alojamiento del portal de ArcGIS Enterprise. Para obtener el mejor rendimiento, implemente los clientes de ArcGIS en Google Cloud.

Normalmente, los profesionales de TI instalan el software de ArcGIS y los controladores necesarios para conectarse al almacén de datos. También configuran la red, el firewall y otros canales de comunicación necesarios para permitir la comunicación entre ArcGIS y el almacén de datos en la nube.

A continuación, el administrador del almacén de datos en la nube crea cuentas y otorga a las cuentas privilegios para acceder a tablas específicas del almacén de datos en la nube. El administrador puede crear una conexión desde ArcGIS Pro al almacén de datos en la nube y compartir el archivo de conexión con los publicadores, o bien el administrador puede proporcionar a los publicadores las credenciales necesarias para permitirles crear sus propios archivos de conexión.

Para publicar servicios web de ArcGIS Server que hagan referencia a datos del almacén de datos en la nube, los publicadores deben registrar el archivo de conexión de base de datos con el sitio de ArcGIS GIS Server que actúa como el servidor de alojamiento del portal de ArcGIS Enterprise.

Instalar y configurar controladores

Para conectarse desde ArcGIS Pro a BigQuery, debe instalar el controlador de Conectividad abierta de base de datos (ODBC) de Magnitude Simba más reciente en los equipos de ArcGIS Pro. Para publicar una capa de imagen de mapa o capa de entidad que contenga datos de BigQuery, debe instalar los controladores y configurar las máquinas en el sitio del servidor de alojamiento del portal de ArcGIS Enterprise para que se conecten a BigQuery.

Consulte la documentación de Google BigQuery para obtener más información y los vínculos para descargar e instalar el controlador ODBC de 64 bits.

Equipos con Microsoft Windows

Instale el controlador ODBC de Magnitude Simba en cada equipo de ArcGIS Pro y en cada equipo de un servidor de alojamiento que utilice un sistema operativo Windows.

Confirme que la ruta del controlador ODBC de Magnitude Simba está presente en la variable de entorno del sistema PATH de Windows. Si no lo está, agréguela.

Equipos con Linux

Si el servidor de alojamiento del portal funciona en equipos Linux, deberá instalar los controladores ODBC de Magnitude Simba en cada equipo del sitio de GIS Server.

Al editar el archivo de Magnitude Simba /etc/odbcinst.ini para hacer referencia a la ubicación del controlador ODBC de Simba, debe cambiar el título de la sección para que sea Simba ODBC Driver for Google BigQuery. El texto debe coincidir exactamente con este. Por ejemplo, si el título es Simba ODBC Driver for Google BigQuery 64bit o cualquier otro, las conexiones desde ArcGIS fallarán.

Después de configurar el archivo /etc/odbcinst.ini, configure el archivo de ArcGIS Server init_user_param.sh para acceder a los controladores.

Modificar el script init_user_param.sh

Modifique el script init_user_param.sh instalado con ArcGIS Server para hacer referencia a los controladores. Puede acceder a este script navegando al directorio <ArcGIS Server installation directory>/arcgis/server/usr.

  1. Asegúrese de que el propietario de la instalación de ArcGIS Server en cada equipo tenga al menos permisos de lectura y de ejecución en las bibliotecas de clientes del almacén de datos.
  2. Abra el script init_user_param.sh en un editor de texto.
  3. Elimine las marcas de comentario (#) de las líneas que empiecen por export y sustituya las ubicaciones de los controladores por las rutas de su equipo.

    # -----------------------------------------------------------------------
    # Modify this section to configure an ODBC connection to Google BigQuery Data 
    # Warehouse.
    #
    # To make a connection, copy GoogleBigQueryODBC.did to the lib folder under the 
    # extracted directory for Google BigQuery ODBC driver. Edit 
    # simba.googlebigqueryodbc.ini and set DriverManagerEncoding=UTF-16. Configure and 
    # store the odbcinst.ini in the /etc folder. 
    #
    # -----------------------------------------------------------------------
    export LIB_ODBC_DRIVER_MANAGER=<Location_to_ODBC_driver_manager_libraries>/libodbc.so.2
    export SIMBAGOOGLEBIGQUERYODBCINI=<Location_to_simba.googlebigqueryodbc.ini>/simba.googlebigqueryodbc.ini

  4. Guarde y cierre el script.
  5. Para que los cambios que realizó en el archivo init_user_param.sh tengan efecto, debe reiniciar ArcGIS Server.

    Para ello, ejecute el script stopserver.sh y, a continuación, ejecute el script startserver.sh en cada equipo del sitio de ArcGIS Server.

    ./stopserver.sh

    ./startserver.sh

Crear archivos de conexión a la base de datos

En ArcGIS Pro, utilice el cuadro de diálogo Nueva conexión de base de datos para crear una conexión a BigQuery.

  1. Abra el panel Catálogo en ArcGIS Pro.
  2. Haga clic con el botón derecho en Bases de datos y haga clic en Nueva conexión de base de datos.
  3. Elija BigQuery en la lista desplegable Plataforma de base de datos.
  4. En la lista desplegable Tipo de autenticación, elija el tipo de conexión que desea realizar:
    • Autenticación del usuario: utiliza un token de actualización para la autenticación.
    • Autenticación del servicio: utiliza un archivo de claves de cuenta de servicio para la autenticación.

    Consulte la documentación sobre la autenticación de Google BigQuery como ayuda para decidir cuál utilizar.

  5. Si elige Autenticación del usuario, proporcione un token de actualización.
  6. Si elige Autenticación del servicio, busque la ubicación del archivo de claves que contiene las credenciales que necesita para conectarse a BigQuery, seleccione el archivo y haga clic en Abrir.
  7. Escriba el Id. del proyecto y el nombre del dataset predeterminado asociado al usuario con el que desea conectarse.

    Nota:

    No se conecte utilizando ninguno de los proyectos de datos públicos de BigQuery como proyecto predeterminado. No puede habilitar la agrupación en bins de las entidades ni crear una vista materializada directamente en ninguna de las tablas de los datasets de proyectos de datos públicos.

    Si quiere crear una vista materializada utilizando este archivo de conexión, asegúrese de que la conexión tenga asignado un dataset predeterminado en el que se puedan crear objetos de base de datos.

  8. Si su conexión requiere más parámetros que los requeridos en los pasos anteriores, indíquelos en el campo Opciones avanzadas.

    Separe las opciones con punto y coma (;). Lea la documentación de Google BigQuery para obtener información sobre los parámetros avanzados de conexión.

    Por ejemplo, para configurar el conector de ODBC para reintentar llamadas erróneas a la API durante 200 segundos y utilizar un certificado de una autoridad de certificación almacenada en la unidad compartida \\certificates, escriba Timeout=200;TrustedCerts=\\certificates en el campo Opciones avanzadas.

  9. Haga clic en Aceptar para crear el archivo de conexión.

Puede cambiar el nombre del archivo escribiendo un nombre nuevo en el panel Catálogo y pulsando Intro.

Asegúrese de que la cuenta utilizada para la conexión tenga los privilegios correctos para acceder al contenido del almacén de datos.

Registrarse en el servidor de alojamiento

Para permitir que el sitio de ArcGIS Server acceda a los datos, utilice el archivo de conexión de base de datos que ha creado para agregar un data store registrado en ArcGIS Pro o agregar un elemento de data store al portal.

Pasos siguientes

Después de configurar los clientes de ArcGIS para conectarse y crear un archivo de conexión de base de datos, usted y otros miembros de la organización pueden hacer lo siguiente:

  • Si los publicadores tienen previsto crear instantáneas de datos que se van a almacenar en el data store relacional, asegúrese de que el administrador de ArcGIS Data Store lo tenga en cuenta y haya configurado suficiente memoria y espacio en disco en los equipos del data store relacional y los equipos de copia de seguridad para darles cabida.
  • Los analistas y publicadores crean una capa de consulta en un mapa en ArcGIS Pro.