Setting up Remote Sources

Objective

After completing this lesson, you will be able to cree una fuente remota mediante la interfaz de usuario o SQL.

Configuración de fuente remota con la interfaz gráfica de usuario

Cuando se cumplen los requisitos previos técnicos y de seguridad, está listo para crear una fuente remota. Existen dos formas principales de hacerlo:

  • En el catálogo del explorador de base de datos SAP HANA, con la interfaz gráfica de usuario
  • En cualquier consola SQL conectada a su base de datos local/destino, con una sentencia SQL

Analicemos primero el proceso de creación gráfico basado en interfaz de usuario.

Para crear una fuente remota con la interfaz gráfica de usuario

  1. Vaya al Catálogo a la sección Fuentes remotas.
  2. Haga clic con el botón derecho en Fuentes remotas y seleccione Añadir fuente remota.
  3. Defina el nombre de la fuente remota.
  4. Seleccione el adaptador relevante.
  5. Para las fuentes remotas SDI, especifique una ubicación de adaptador ("Ubicación de origen").
  6. Rellene la propiedad de fuente remota.
  7. Seleccione Crear.

Inicie este vídeo para aprender a crear una fuente remota de acceso a datos inteligentes con el editor basado en formularios en el explorador de base de datos de SAP HANA.

La creación de fuentes remotas para escenarios de integración de datos inteligentes con la interfaz gráfica de usuario es muy similar a lo que acabamos de analizar. Una diferencia clave es que, dado que los adaptadores no se ejecutan en el servidor de índices de la instancia de base de datos de SAP HANA, es necesario especificar dónde se encuentran los adaptadores. Este es un recordatorio:

  • Los adaptadores OData se ejecutan en el servidor de aprovisionamiento de datos (dentro de la base de datos).

    La ubicación dpserver se asigna automáticamente y no se puede modificar.

  • Todos los demás adaptadores de Smart Data Integration se ejecutan en un agente de aprovisionamiento de datos

    Especifique un agente de aprovisionamiento de datos o un grupo de agentes de aprovisionamiento de datos en caso de que varios agentes formen parte de un grupo de agentes de alta disponibilidad.

    Nota

    El equipo de administración del sistema determina la configuración de los agentes. Lo que solo necesita de ellos es la información sobre qué agente o grupo de agentes se debe utilizar en un escenario en particular.

Inicie este vídeo para aprender a crear una fuente remota de integración de datos inteligentes con el editor basado en formularios en el explorador de base de datos de SAP HANA.

Verificar una fuente remota

Al crear una fuente remota en el explorador de base de datos SAP HANA con un formulario, se ejecutan dos verificaciones automáticas sucesivas.

  1. Consistencia de fuente remota – Bloqueo

    La definición de fuente remota debe ser "sintácticamente" correcta con todos los parámetros necesarios rellenados.

    La verificación puede fallar, por ejemplo, si ha olvidado el nombre del servidor o no ha proporcionado el nombre de usuario y la contraseña para un usuario técnico.

    En ese caso, no se puede crear la fuente remota. Debe modificar la definición de la fuente remota e intentar guardarla de nuevo.

    Nota

    En el formulario de definición de fuente remota, todos los parámetros obligatorios se identifican con un asterisco rojo.
  2. Conectividad de fuente remota: no bloqueante

    Esta verificación de segundo nivel, iniciada automáticamente en el formulario del explorador de base de datos SAP HANA, verifica si la definición de fuente remota permite que SAP HANA se conecte al sistema remoto y autentique al usuario remoto.

    Si no se supera esta verificación, solo recibirá una advertencia, que NO impedirá la creación de la fuente remota.

    La verificación puede fallar, por ejemplo, debido a un error en el nombre del servidor o en la configuración del conector de la nube de SAP (si procede), o simplemente porque el servidor remoto no está disponible actualmente. Otro motivo podría ser que la fuente remota está definida con credenciales secundarias, pero actualmente no existe ninguna credencial para su usuario.

    En este caso, solo se emite un mensaje de advertencia. Puede modificar la definición de la fuente remota inmediatamente (por ejemplo, si identifica un error evidente), pero también puede guardar la definición de fuente remota tal cual y modificarla más adelante.

Configuración de fuente remota con SQL

Como alternativa al uso de la interfaz gráfica de usuario del explorador de base de datos de SAP HANA para crear fuentes remotas, puede ejecutar sentencias SQL. Uno de los beneficios clave es que puede crear varias fuentes remotas por lotes muy rápidamente.

La sentencia SQL se estructura de la siguiente manera:

Code Snippet
123456
CREATE REMOTE SOURCE "<remote_source_name>" ADAPTER "<adapter_name>" AT LOCATION <agent_or_agent_group_name> CONFIGURATION '<configuration_string>' WITH CREDENTIAL TYPE '<credential_type>' USING '<credential_definition_string>';

Veamos un ejemplo sencillo en el que definiremos una fuente remota de acceso a datos inteligentes que apunte a un sistema fuente local de SAP HANA.

Code Snippet
1234
CREATE REMOTE SOURCE "RS1" ADAPTER "hanaodbc" CONFIGURATION 'ServerNode=hana_cloud_src1.mycompany.com:30115' WITH CREDENTIAL TYPE 'PASSWORD' USING 'user=myuser;password=MyPassword';

Nota

Tenga en cuenta que, dado que se trata de una fuente remota de acceso a datos inteligentes de SAP HANA, no hay ninguna cláusula AT LOCATION.

Para las fuentes de datos de SAP HANA, acceso a datos inteligentes, hay dos variantes para definir la cadena de configuración. La de arriba es más compacta. La siguiente versión más larga pasa la configuración como XML. Ambos logran el mismo resultado.

Code Snippet
1234567891011
CREATE REMOTE SOURCE "RS1" ADAPTER "hanaodbc" CONFIGURATION '<?xml version="1.0" encoding="UTF-8"?> <ConnectionProperties name="connectionproperties"> <PropertyEntry name="adapterversion">1.0</PropertyEntry> <PropertyEntry name="connectionmode">Adapter Properties</PropertyEntry> <PropertyEntry name="server">hana_cloud_src1.mycompany.com</PropertyEntry> <PropertyEntry name="port">30015</PropertyEntry> </ConnectionProperties>' WITH CREDENTIAL TYPE 'PASSWORD' USING 'user=myuser;password=MyPassword';

Nota

Este formulario más largo es opcional para la fuente de acceso a datos inteligentes de SAP HANA. Se presenta aquí porque esto es lo que obtiene cuando selecciona GENERAR ESTADO DE CREACIÓN de una fuente remota existente en el catálogo Explorador de base de datos SAP HANA.

Inicie este vídeo para aprender a crear una fuente remota con una sentencia SQL.

Nombre de adaptador coincidente (SQL) con nombre de visualización de adaptador (interfaz gráfica de usuario)

Cuando trabaja con SQL y el explorador de base de datos de SAP HANA para crear fuentes remotas, puede encontrar en la tabla del sistema "SYS"."ADAPTERS" la lista de adaptadores que se ejecutan actualmente en la base de datos de SAP HANA. Esto le permite hacer coincidir el nombre de un adaptador que se utiliza en una sentencia SQL CREATE REMOTE SOURCE con el nombre de visualización que se muestra en el Explorador de base de datos SAP HANA al crear o editar una definición de fuente remota.

La tabla se puede consultar de la siguiente manera:

Code Snippet
1
SELECT * FROM "SYS"."ADAPTERS";

El resultado muestra todos los adaptadores del sistema (SDA), además de todos los adaptadores que están registrados actualmente en cualquiera de los agentes de aprovisionamiento de datos conectados a su base de datos local de SAP HANA.

Esta diapositiva muestra cómo enumerar los adaptadores disponibles

Verificar una fuente remota

Al crear una fuente remota con SQL, hay dos niveles de verificación disponibles.

  1. Consistencia de fuente remota – Bloqueo

    Esta verificación se realiza como parte de la sentencia SQL CREATE REMOTE SOURCE.

    La definición de fuente remota debe ser "sintácticamente" correcta, con todos los parámetros necesarios rellenados.

    La verificación puede fallar, por ejemplo, si ha olvidado el nombre del servidor o no ha proporcionado un nombre de agente válido en la cláusula AT LOCATION (si procede).

    En ese caso, la sentencia SQL falla y no se puede crear la fuente remota. Debe modificar la sentencia SQL y ejecutarla de nuevo.

  2. Conectividad de fuente remota: sin bloqueo

    Esta verificación es opcional, no forma parte de la sentencia CREATE REMOTE SOURCE.

    Puede ejecutar una sentencia SQL adicional para verificar si la definición de fuente remota permite que SAP HANA se conecte al sistema remoto y autentique al usuario remoto.

    Code Snippet
    1
    CALL CHECK_REMOTE_SOURCE('<remote_source_name>');

    La ejecución de este procedimiento es correcta (verificación aprobada) o, si falla, obtiene algunos detalles sobre la causa principal en la consola SQL.

    Puede tratarse de un error en el nombre del servidor, en la configuración del conector de la nube de SAP, si procede, o simplemente en el hecho de que el servidor remoto no está disponible actualmente. En otros contextos, esto podría deberse a que la fuente remota se define con credenciales secundarias, pero no existe para su usuario.