Conectar a SAP HANA desde ArcGIS

Para conectarse a una base de datos de SAP HANA desde clientes de ArcGIS, instale y configure el controlador ODBC del cliente de SAP HANA en los equipos cliente de ArcGIS. SAP HANA : los controladores ODBC del cliente están disponibles para los usuarios de SAP en SAP Support Portal, en la sección Software Downloads.

Una vez el controlador ODBC esté configurado en todos sus equipos de cliente de ArcGIS, cree un archivo de conexión de base de datos en ArcGIS Pro o ArcMap. Para publicar servicios web de ArcGIS Server que hagan referencia a los datos de la base de datos de SAP HANA, registre el archivo de conexión de base de datos con sus sitios de ArcGIS Server.

Nota:

Instale las aplicaciones y los controladores ODBC de 32 y 64 bits en equipos separados, para evitar que surjan problemas cuando se instalen diferentes versiones de los mismos controladores en la misma máquina.

Conectarse desde ArcGIS Pro

Para conectar desde un proyecto de ArcGIS Pro con SAP HANA, instale el controlador ODBC del cliente de SAP HANA en el equipo de ArcGIS Pro y cree una conexión de base de datos.

Instalar el cliente de SAP HANA

Siga estos pasos para descargar el controlador ODBC del cliente de SAP HANA y configurar la variable de ruta en su equipo cliente:

1. Descargue un cliente de 64 bits SAP HANA compatible desde SAP Support Portal, en la sección Software Downloads, e instálelo en todos los equipos de ArcGIS Pro.
2. Agregue el directorio de instalación del cliente de SAP HANA en la variable de entorno del sistema Windows PATH.

   Por ejemplo, si instaló el controlador ODBC del cliente de SAP HANA en C:\Program Files\sap\hdbclient, agregue eso a la variable de entorno PATH.

Conéctese a la base de datos.

Puede utilizar el nombre de servidor SAP HANA y el número de puerto SQL para conectarse a la base de datos si su sitio reúne todas estas condiciones:

• Su base de datos de SAP HANA es una versión compatible, 2.0 SPS2 o posteriores.
• Se está conectando desde ArcGIS Pro 2.2 o versiones posteriores.
• El número de caracteres del nombre de servidor SAP HANA y el número de puerto SQL de su servidor SAP HANA es menor que 31.

Si no se cumple alguna de las condiciones anteriores, debe configurar un nombre de fuente de datos (DSN) de sistema para el controlador ODBC del cliente de SAP HANA antes de seguir estos pasos para conectarse desde ArcGIS Pro.

Agregue una conexión de base de datos usando el cuadro de diálogo Conexión de base de datos o la herramienta de geoprocesamiento Crear conexión de la base de datos. Los siguientes pasos describen el uso del cuadro de diálogo Conexión de base de datos.

1. Haga clic con el botón derecho del ratón en Bases de datos en el panel Catálogo y haga clic en Nueva conexión de base de datos.
2. Elija SAP HANA en la lista desplegable Plataforma de base de datos.
3. En el cuadro de texto Fuente de datos, escriba uno de los siguientes:
   • El nombre de servidor SAP HANA y el número de puerto SQL utilizados para comunicarse con la base de datos separados por dos puntos (:). Por ejemplo, si el nombre totalmente calificado de su servidor de SAP HANA es miservidor.red.com y SAP HANA se comunica a través del puerto 98765, escriba miservidor.red.com:98765.
   • El nombre de fuente de datos que configuró para el controlador ODBC.
4. Elija Autenticación de base de datos para el tipo de autenticación.
5. Proporcione un nombre de usuario y contraseña válidos para la base de datos en los cuadros de texto Nombre de usuario y Contraseña respectivamente.
6. Si prefiere no guardar la información de inicio de sesión como parte de la conexión, desactive Guardar nombre de usuario y contraseña; hacerlo puede ayudar a garantizar la seguridad de la base de datos. Sin embargo, al hacerlo, deberá proporcionar un nombre de usuario y contraseña cada vez que se conecta desde clientes de escritorio.

   Nota:

   La opción Guardar nombre de usuario y contraseña debe estar activada para los archivos de conexión que registre con un sitio de ArcGIS Server o si desea buscar para localizar datos a los que se accede a través de este archivo de conexión.

7. Haga clic en Aceptar para conectarse.

Configurar un nombre de fuente de datos (opcional en la mayoría de casos)

Si se cumple alguna de las siguientes condiciones, debe configurar un nombre de fuente de datos (DSN) de sistema para el controlador ODBC del cliente de SAP HANA para conectarse a la base de datos:

• Utiliza SAP HANA 1.0 (cualquier versión de Service Pack compatible).
• Utiliza ArcGIS Pro 2.1 o versiones anteriores.
• El número de caracteres del nombre de servidor SAP HANA y el número de puerto SQL de su servidor SAP HANA supera los 31.

Si no se dan estas condiciones en su sitio, puede seguir configurando un nombre de fuente de datos para conectarse a SAP HANA, pero no es obligatorio.

Siga estos pasos para configurar un nombre de fuente de datos para su base de datos de SAP HANA:

1. Abra el Administrador de orígenes de datos ODBC (64 bits) en su equipo cliente.

   Nota:

   Use el mismo nombre al configurar todos los clientes ODBC de SAP HANA en la misma base de datos. Por ejemplo, use el mismo nombre de fuente de datos cuando configure el controlador ODBC de cliente de SAP HANA en los equipos de ArcGIS Pro que utilizó al configurar el nombre de fuente de datos del controlador ODBC en los equipos de ArcGIS Server. Si no utiliza el mismo nombre, tendrá problemas al publicar porque ArcGIS compara las cadenas de conexión de los datos que se van a publicar y la base de datos registrada.

2. Haga clic en la pestaña DSN de sistema del Administrador de orígenes de datos ODBC (64 bits) y haga clic en Agregar.
3. Elija el cliente ODBC de SAP HANA y haga clic en Finalizar.
4. Proporcione un nombre, una descripción y un número de puerto SQL para la fuente de datos.
5. Abra la configuración avanzada del cliente de ODBC y agregue la propiedad SPATIALTYPES y establezca su valor en 1.

   Nota:

   Puede omitir este paso si utiliza ArcGIS Pro 2.2 o una versión más reciente con una versión admitida de SAP HANA 2.0.

6. Haga clic en Aceptar en la configuración del cliente de ODBC y en el Administrador de orígenes de datos ODBC para cerrarlos.

Conectarse desde ArcMap

Para conectarse desde ArcMap a SAP HANA, instale y configure el controlador ODBC del cliente de SAP HANA en todos los equipos con ArcMap y cree una conexión desde ArcMap a la base de datos.

Instalar el controlador ODBC del cliente de SAP HANA

Siga estos pasos para descargar el controlador ODBC del cliente de SAP HANA y configurar la variable de ruta en su equipo cliente:

1. Descargue un cliente de SAP HANA de 32 bits compatibledesde SAP Support Portal e instálelo en cada equipo de ArcMap.
2. Agregue el directorio de instalación del cliente de SAP HANA en la variable de entorno del sistema Microsoft Windows PATH.

   Por ejemplo, si instaló el controlador ODBC del cliente de SAP HANA en C:\Program Files\sap\hdbclient, agregue eso a la variable de entorno PATH.

Conéctese a la base de datos.

Puede utilizar el nombre de servidor SAP HANA y el número de puerto SQL para conectarse a la base de datos si su sitio reúne todas estas condiciones:

• Su base de datos de SAP HANA es una versión compatible, 2.0 SPS2 o posteriores.
• Se está conectando desde ArcGIS Desktop 10.6.1 o versiones posteriores.
• El número de caracteres del nombre de servidor SAP HANA y el número de puerto SQL de su servidor SAP HANA es menor que 31.

Si no se cumple alguna de las condiciones anteriores, debe configurar un nombre de fuente de datos (DSN) de sistema para el controlador ODBC del cliente de SAP HANA antes de proceder con estos pasos para conectarse desde ArcMap.

Agregue una conexión de base de datos usando el cuadro de diálogo Conexión de base de datos o la herramienta de geoprocesamiento Crear conexión de la base de datos. En los siguientes pasos se describe el uso del cuadro de diálogo Conexión de base de datos:

1. Expanda el nodo Conexiones de base de datos en el árbol de Catálogo de ArcMap o ArcCatalog y haga doble clic en Agregar conexión de base de datos.
2. Elija SAP HANA en la lista desplegable Plataforma de base de datos.
3. En el cuadro de texto Fuente de datos, escriba uno de los siguientes:
   • El nombre de servidor SAP HANA y el número de puerto SQL utilizados para comunicarse con la base de datos separados por dos puntos (:). Por ejemplo, si el nombre totalmente calificado de su servidor de SAP HANA es miservidor.red.com y SAP HANA se comunica a través del puerto 98765, escriba miservidor.red.com:98765.
   • El nombre de fuente de datos que configuró para el controlador ODBC.
4. Elija Autenticación de base de datos para el tipo de autenticación.
5. Proporcione un nombre de usuario y contraseña válidos en los cuadros de texto Nombre de usuario y Contraseña respectivamente.
6. Si prefiere no guardar la información de inicio de sesión como parte de la conexión, desactive Guardar nombre de usuario y contraseña; hacerlo puede ayudar a garantizar la seguridad de la base de datos. Sin embargo, al hacerlo, deberá proporcionar un nombre de usuario y contraseña cada vez que se conecta desde clientes de escritorio.

   Nota:

   La opción Guardar nombre de usuario y contraseña debe estar activada para los archivos de conexión que registre con un sitio de ArcGIS Server o si desea usar la búsqueda de catálogo para localizar datos a los que se accede a través de este archivo de conexión.

7. Haga clic en Aceptar para conectarse.

Se crea un archivo en \\<computer_name>\Users\<user_name>\AppData\Roaming\ESRI\Desktop<release#>\ArcCatalog.

Puede mover la conexión a otra ubicación; solo asegúrese de que los usuarios y las aplicaciones que necesitan realizar una conexión tenga acceso de lectura al directorio donde ha colocado el archivo de conexión.

Si utiliza los datos de esta conexión como la fuente para un servicio, como un servicio de geoprocesamiento o geocodificación, es posible que deba colocar el archivo de conexión en una ubicación compartida de la red. Consulte Hacer que sus datos sean accesibles para ArcGIS Server para obtener más información sobre cómo compartir un archivo de conexión.

Configurar un nombre de fuente de datos (opcional en la mayoría de casos)

Si se cumple alguna de las siguientes condiciones, debe configurar un nombre de fuente de datos (DSN) de sistema para el controlador ODBC del cliente de SAP HANA para conectarse a la base de datos:

• Utiliza SAP HANA 1.0 (cualquier versión de Service Pack compatible).
• Se conecta desde ArcGIS Desktop 10.6 o versiones anteriores.
• El número de caracteres del nombre de servidor SAP HANA y el número de puerto SQL de su servidor SAP HANA supera los 31.

Si no se dan estas condiciones en su sitio, puede seguir configurando un nombre de fuente de datos para conectarse a SAP HANA, pero no es obligatorio.

Siga estos pasos para configurar un nombre de fuente de datos para su base de datos de SAP HANA:

1. Abra el Administrador de orígenes de datos ODBC (32 bits) en su equipo cliente.

   Nota:

   Use el mismo nombre al configurar todos los clientes ODBC de SAP HANA en la misma base de datos. Por ejemplo, use el mismo nombre de fuente de datos cuando configure el controlador ODBC de cliente de SAP HANA en los equipos de ArcMap que utilizó al configurar el nombre de fuente de datos del controlador ODBC en los equipos de ArcGIS Server. Si no utiliza el mismo nombre, tendrá problemas al publicar porque ArcGIS compara las cadenas de conexión de los datos que se van a publicar y la base de datos registrada.

2. Haga clic en la pestaña DSN de sistema del Administrador de orígenes de datos ODBC (64 bits) y haga clic en Agregar.
3. Elija el cliente ODBC de SAP HANA y haga clic en Finalizar.
4. Proporcione un nombre, una descripción y un número de puerto SQL para la fuente de datos.
5. Haga clic en Aceptar en la configuración del cliente de ODBC y en el Administrador de orígenes de datos ODBC para cerrarlos.

Conectarse desde ArcGIS Server

Si va a publicar datos de SAP HANA en un sitio de ArcGIS Server y desea que los servicios resultantes utilicen los datos de SAP HANA, instale un controlador ODBC del cliente de SAP HANA de 64 bits en cada equipo del sitio de ArcGIS Server. Siga las instrucciones específicas del sistema operativo donde está instalado ArcGIS Server.

Una vez haya configurado los equipos en el sitio de ArcGIS Server, cree una conexión de base de datos en su base de datos y registre el archivo de conexión con su sitio de ArcGIS Server.

Instalar SAP HANA en los equipos de ArcGIS Server (Microsoft Windows)

Descargue el controlador ODBC del cliente de SAP HANA e instálelo en cada equipo del sitio de ArcGIS Server.

Instale el controlador ODBC del cliente de SAP HANA en cada equipo con ArcGIS Server Windows:

1. Descargue un cliente de 64 bits compatible de SAP HANA desde SAP Support Portal e instálelo en cada equipo del sitio de ArcGIS Server.
2. Agregue el directorio de instalación del cliente de SAP HANA en la variable de entorno PATH del sistema Windows.

   Por ejemplo, si instaló el controlador ODBC del cliente de SAP HANA en C:\Program Files\sap\hdbclient, agréguelo a la variable de entorno PATH.

Cuando haya instalado el controlador ODBC del cliente de SAP HANA, puede seguir con el registro de una conexión de base de datos con su sitio de ArcGIS Server. No obstante, si se dan las siguientes condiciones, debe configurar un nombre de fuente de datos para el controlador ODBC antes de registrar una conexión de base de datos.

• Utiliza SAP HANA 1.0 (cualquier versión de Service Pack compatible).
• Se conecta a la base de datos desde ArcGIS Server 10.6 o versiones anteriores.
• El número de caracteres del nombre de servidor SAP HANA y el número de puerto SQL de su servidor SAP HANA supera los 31.

Configurar un nombre de fuente de datos de ODBC en Windows (opcional en la mayoría de casos)

Si requiere un nombre de fuente de datos, siga estos pasos para configurar un nombre de fuente de datos (DSN) de sistema para el controlador ODBC del cliente de SAP HANA en cada equipo de ArcGIS Server Windows:

Nota:

Use el nombre de fuente de datos cuando se conecte desde ArcGIS a la base de datos. Use el mismo nombre al configurar todos los clientes ODBC de SAP HANA en la misma base de datos. Por ejemplo, use el mismo nombre de fuente de datos cuando configure el controlador ODBC de cliente de SAP HANA en los equipos de ArcGIS Pro y ArcMap que utilizó al configurar el nombre de fuente de datos del controlador ODBC en los equipos de ArcGIS Server. Si no utiliza el mismo nombre, tendrá problemas al publicar porque ArcGIS compara las cadenas de conexión de los datos que se van a publicar y la base de datos registrada.

1. Abra el Administrador de orígenes de datos ODBC (64 bits).
2. Haga clic en la pestaña DSN de sistema del Administrador de orígenes de datos ODBC (64 bits) y haga clic en Agregar.

   Se abre el cuadro de diálogo Crear nueva fuente de datos.

3. Elija el cliente ODBC de SAP HANA y haga clic en Finalizar.
4. Rellene los campos Nombre del origen de datos, Descripción y Servidor:Puerto correspondientes a su base de datos.
5. Haga clic en Configuración para abrir el cuadro de diálogo Configuración avanzada de ODBC y agregue el siguiente valor clave en la sección Configuración de propiedad especial: SPATIALTYPES=1. Haga clic en Aceptar para aplicar los cambios y cerrar el cuadro de diálogo Configuración avanzada de ODBC.

   Nota:

   Puede omitir este paso si utiliza ArcGIS Server con una versión admitida de SAP HANA 2.0. o posteriores.

6. Haga clic en Aceptar en la configuración del cliente de ODBC y en el Administrador de orígenes de datos ODBC para cerrarlos.

Instalar SAP HANA en los equipos de ArcGIS Server (Linux)

Descargue el controlador ODBC del cliente de SAP HANA. Coloque al cliente en cada equipo del sitio de ArcGIS Server, instálelo y edite el script de ArcGIS Server init_user_param.sh en cada equipo de ArcGIS Server Linux.

1. Descargue un cliente de 64 bits compatible de SAP HANA desde SAP Support Portal e instálelo en cada equipo del sitio de ArcGIS Server.
2. Instale un administrador de controlador ODBC de Linux en cada equipo de ArcGIS Server si todavía no está instalado.

Una vez que haya instalado los archivos cliente de la base de datos, modifique la secuencia de comandos init_user_param.sh instalada con ArcGIS Server para hacer referencia a los archivos cliente. Puede acceder a este script navegando al directorio <ArcGIS Server installation directory>/arcgis/server/usr.

3. 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 de la base de datos.
4. Abra el script init_user_param.sh en un editor de texto.
5. Elimine la marca de comentario (#) de estas líneas y reemplace la información <SAPHANA_InstallDir> por la ruta del directorio en la que instaló el cliente de SAP HANA:

   export SAPHANADIR=<SAPHANA_InstallDir>/sap/hdbclient
   export LD_LIBRARY_PATH==$SAPHANADIR:$LD_LIBRARY_PATH

6. Guarde y cierre el script.
7. Una vez que haya configurado init_user_param.sh en cada equipo de su sitio de ArcGIS Server, ejecute el script startserver.sh en cada equipo para reiniciar ArcGIS Server.

   ./startserver.sh

Cuando haya instalado el controlador ODBC del cliente de SAP HANA, puede seguir con el registro de una conexión de base de datos con su sitio de ArcGIS Server. No obstante, si se dan las siguientes condiciones, debe configurar un nombre de fuente de datos para el controlador ODBC antes de registrar una conexión de base de datos.

• Utiliza SAP HANA 1.0 (cualquier versión de Service Pack compatible).
• Se conecta a la base de datos desde ArcGIS Server 10.6 o versiones anteriores.
• El número de caracteres del nombre de servidor SAP HANA y el número de puerto SQL de su servidor SAP HANA supera los 31.

Configurar un nombre de fuente de datos de ODBC en Linux (opcional en la mayoría de casos)

Si requiere un nombre de fuente de datos, siga estos pasos para configurar un nombre de fuente de datos de sistema para el controlador ODBC del cliente de SAP HANA en cada equipo de ArcGIS Server Linux:

Nota:

Use el mismo nombre de fuente de datos ODBC al configurar todos los clientes ODBC de SAP HANA en la misma base de datos. Por ejemplo, configure el nombre de fuente de datos de los equipos con ArcGIS Pro y ArcMap de modo que sea igual que el nombre del origen de datos del controlador ODBC del cliente de SAP HANA de los equipos de los sitios de ArcGIS Server. Si no utiliza el mismo nombre, tendrá problemas al publicar porque ArcGIS compara las cadenas de conexión de los datos que se van a publicar y la base de datos registrada.

1. Para configurar un nombre de fuente de datos de ODBC, edite los archivos de conexión de ODBC de SAP HANA, .odbc.ini y .odbcinst.ini.

   Los archivos se deben llamar .odbc.ini y .odbcinst.ini.

2. Abra el archivo .odbc.ini con un editor de texto.

   Asegúrese de que no haya espacios alrededor del signo igual (=) en el archivo .odbc.ini. Por ejemplo, esta entrada no tiene espacios alrededor de los signos igual:

   [<HANA_DNS>]
   Driver=/<usr>/sap/hdbclient/libodbcHDB.so
   Description=SAP Hana ODBC
   ServerNode=<HANA_Server_IP>:<SAP_HANA_port>
   UID=<user_name>
   Password=<user_password>
   SPATIALTYPES=1
   [ODBC]
   IANAAppCodePage=4
   InstallDir=/<usr>/sap/hdbclient
   Trace=0
   TraceDll=/opt/odbc64v51/lib/odbctrac.so
   TraceFile=/tmp/odbctrace.out
   UseCursorLib=0

   Nota:

   La entrada de SPATIALTYPES=1 no es obligatoria si utiliza ArcGIS Server con una versión admitida de SAP HANA 2.0 o posteriores.

3. Guarde y cierre el archivo .odbc.ini.
4. Abra el archivo .odbcinst.ini y edítelo para incluir la ruta del controlador ODBC.

   En el archivo .odbcinst.ini, no es obligatorio el mismo tipo de espaciado, como se muestra en este ejemplo:

   Description  =SAP HANA ODBC
   Driver64         = /<usr>/sap/hdbclient/libodbcHDB.so

5. Guarde y cierre el archivo .odbcinst.ini.

Registrar la base de datos

Si desea publicar sus servicios web usando los datos de SAP HANA, cree una conexión de base de datos y regístrela con sus sitios de ArcGIS Server. Consulte Administrar data stores registrados en la Ayuda de ArcGIS Pro o Registrar los datos con ArcGIS Server mediante Server Manager o Agregar elementos en la Ayuda del usuario del portal de ArcGIS Enterprise para obtener instrucciones.