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.
- 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.
- Abra el script init_user_param.sh en un editor de texto.
- 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 - Guarde y cierre el script.
- 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.
- Abra el panel Catálogo en ArcGIS Pro.
- Haga clic con el botón derecho en Bases de datos y haga clic en Nueva conexión de base de datos.
- Elija BigQuery en la lista desplegable Plataforma de base de datos.
- En la lista desplegable Tipo de autenticación, elija el tipo de autenticación que se va a utilizar para la conexión.
- 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 de Google BigQuery acerca de la autenticación para decidir qué tipo utilizar.
- Si elige Autenticación del usuario, proporcione un token de actualización.
- 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.
- Escriba o elija el Id. del proyecto y seleccione un 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. La vista se creará en ese dataset, que puede no estar en el mismo dataset que los datos que participan en la vista materializada.
- Introduzca el nombre del archivo de conexión en el campo Nombre del archivo de conexión.
Al proporcionar información de conexión, se crea un nombre predeterminado. Puede utilizar el predeterminado o introducir un nombre de archivo más descriptivo.
Este es el nombre que aparecerá en el panel Catálogo y la vista, y el nombre del archivo .sde almacenado en el disco.
- Si lo desea, expanda la sección Propiedades adicionales y especifique parámetros de conexión adicionales, además de los requeridos en los pasos anteriores.
- Proyectos adicionales
- Tiempo de espera
- Trazado
- Nivel de registro
- Ruta de registro
Si necesita una propiedad que no está disponible en el menú desplegable, puede introducirla en el campo Propiedad y proporcionar el valor adecuado para ella.
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 ODBC para intentar realizar de nuevo llamadas erróneas a la API durante 200 segundos, elija Tiempo de espera en el menú desplegable Propiedad y especifique 200 en el campo Valor.
- Haga clic en Aceptar para crear el archivo de conexión.
Aparece una conexión de base de datos en Bases de datos en el panel Catálogo y se crea un archivo de conexión (.sde) en el directorio del proyecto de ArcGIS Pro.
Asegúrese de que la cuenta utilizada para la conexión tenga los privilegios necesarios para acceder al contenido del almacén de datos.
Registrarse en el servidor de alojamiento
Para permitir que los sitios de ArcGIS Server accedan 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.