SAP HANA

Entidades, operaciones y acciones

Todos los conectores de integración proporcionan una capa de abstracción para los objetos de la aplicación conectada. Solo puedes acceder a los objetos de una aplicación a través de esta abstracción. La abstracción se te muestra como entidades, operaciones y acciones.

• Entidad: una entidad se puede considerar como un objeto o un conjunto de propiedades en la aplicación o el servicio conectados. La definición de una entidad varía de un conector a otro. Por ejemplo, en un conector de base de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; y en un conector de sistema de mensajería, las colas son las entidades.

  Sin embargo, es posible que un conector no admita o no tenga ninguna entidad. En ese caso, la lista Entities estará vacía.

• Operación: una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:
  • Mostrar
  • Obtener
  • Crear
  • Actualizar
  • Eliminar

  Al seleccionar una entidad de la lista disponible, se genera una lista de operaciones disponibles para la entidad. Para ver una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea Connectors. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, esas operaciones no admitidas no se mostrarán en la lista Operations.

• Acción: una acción es una función de primera clase que se pone a disposición de la integración a través de la interfaz del conector. Una acción te permite hacer cambios en una o varias entidades y varía de un conector a otro. Normalmente, una acción tendrá algunos parámetros de entrada y un parámetro de salida. Sin embargo, es posible que un conector no admita ninguna acción, en cuyo caso la lista Actions estará vacía.

Acciones

En esta sección se enumeran las acciones que admite el conector. Para saber cómo configurar las acciones, consulta los ejemplos de acciones.

Acción EMPLOYEE_PROCEDURE_HANA

Esta acción devuelve los datos de un ID.

Parámetros de entrada de la acción EMPLOYEE_PROCEDURE_HANA

Para ver un ejemplo de cómo configurar la acción EMPLOYEE_PROCEDURE_HANA, consulta Ejemplos.

Acción ExecuteCustomQuery

Esta acción te permite realizar tareas específicas. Por ejemplo, HANADB te permite ejecutar una consulta SQL personalizada.

Parámetros de entrada de la acción ExecuteCustomQuery

Para ver un ejemplo de cómo configurar la acción ExecuteCustomQuery, consulta Ejemplos.

Ejemplos de acciones

Ejemplo: EMPLOYEE_PROCEDURE_HANA

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción EMPLOYEE_PROCEDURE_HANA y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "ID":1
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea EMPLOYEE_PROCEDURE_HANA tendrá un valor similar al siguiente:

 [{
"EMP_ID": 1.0,
"NAME": "Komal",
"CITY": "UP",
"SALARY": 7500.0,
"DEPARTMENT": "IT" 
}]

Ejemplo: ExecuteCustomQuery Join_GroupBy

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "SELECT CUSTOMER.COMPANY, SUM(ORDERS.AMOUNT) AS Total
   FROM ORDERS
   INNER JOIN CUSTOMER
   ON ORDERS.CUSTOMER_ID = CUSTOMER.ID
   GROUP BY CUSTOMER.COMPANY"
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

[{
"COMPANY": "google India",
"TOTAL": 1560.0
},{
"COMPANY": "IBM India",
"TOTAL": 4500.0
}]

Ejemplo: ExecuteCustomQuery Join

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "SELECT ID, NAME, AGE, AMOUNT FROM CUSTOMERS JOIN ORDERS ON CUSTOMERS.ID = ORDERS.CUSTOMER_ID"
     }]
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

[{
  "ID": 3.0,
  "NAME": "Kaushik",
  "AGE": 23.0,
  "AMOUNT": 3000.0
}, {
  "ID": 3.0,
  "NAME": "Kaushik",
  "AGE": 23.0,
  "AMOUNT": 1500.0
}, {
  "ID": 2.0,
  "NAME": "Khilan",
  "AGE": 25.0,
  "AMOUNT": 1560.0
}, {
  "ID": 4.0,
  "NAME": "Chaitali",
  "AGE": 25.0,
  "AMOUNT": 2060.0
}]

Ejemplo: ExecuteCustomQuery Groupby_Having_Count

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "SELECT COUNT(ID), CITY FROM GCP_HANA_CUSTOM GROUP BY CITY HAVING COUNT(ID) > 1"
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

 [{
  "COUNT(ID)": 2.0,
  "CITY": "Delhi"
}] 

Ejemplo: ExecuteCustomQuery GroupBy

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "SELECT COUNT(ID), CITY FROM GCP_HANA_CUSTOM GROUP BY CITY"
   }
   

En este ejemplo se actualizarán los registros de ExecuteCustomQuery. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

[{
  "COUNT(ID)": 1.0,
  "CITY": "Kolkata"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Katihar"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Bangalore"
}, {
  "COUNT(ID)": 2.0,
  "CITY": "Delhi"
}]

Ejemplo: ExecuteCustomQuery GroupBy_OrderBy

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "SELECT COUNT(ID), CITY FROM GCP_HANA_CUSTOM GROUP BY CITY ORDER BY COUNT(ID) DESC"
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

[{
  "COUNT(ID)": 2.0,
  "CITY": "Delhi"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Kolkata"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Bangalore"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Katihar"
}]

Ejemplo: ExecuteCustomQuery Insert_Table

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "INSERT INTO CUSTOMER VALUES (3, 'IBM India')"
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

[{
}]

Ejemplo: ExecuteCustomQuery SUM_AggFunc

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "SELECT SUM(SALARY) FROM CUSTOMERS"
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

 [{
"SUM(SALARY)": 12000.0
}] 

Ejemplo: ExecuteCustomQuery AVG_AggFunc

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "SELECT AVG(SALARY) FROM CUSTOMERS"
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

[{
"AVG(SALARY)": 3000.0
}] 

Ejemplo: ExecuteCustomQuery MAX_AggFunc

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "SELECT MAX(SALARY) FROM CUSTOMERS"
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

 [{
"MAX(SALARY)": 6500.0
}] 

Ejemplo: ExecuteCustomQuery MIN_AggFunc

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "SELECT MIN(SALARY) FROM CUSTOMERS"
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

[{
"MIN_SALARY": 1500.0
}]

Ejemplo: ExecuteCustomQuery COUNT_AggFunc

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "SELECT COUNT(*) FROM CUSTOMERS"
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

[{
"COUNT(*)": 4.0
}]

Ejemplo: ExecuteCustomQuery CreateTable

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "CREATE TABLE CUSTOMER (ID INT NOT NULL,COMPANY VARCHAR (20))"
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

[{
}]

Ejemplo: ExecuteCustomQuery AlterTable

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "ALTER TABLE GCP_HANA_CUSTOM ADD CONSTRAINT test PRIMARY KEY (ID)"
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

[{
}]

Ejemplo: ExecuteCustomQuery TruncateTable

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "TRUNCATE TABLE GCP_HANA_RENAME"
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

[{
}]

Ejemplo: ExecuteCustomQuery DropTable

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "DROP TABLE GCP_HANA_DROP"
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

[{
}]

Ejemplo: ExecuteCustomQuery RenameTable

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "RENAME TABLE GCP_HANA_CUSTOM1 TO GCP_HANA_RENAME"
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

[{
}]

Ejemplo: ExecuteCustomQuery UpdateTable

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "UPDATE CUSTOMERS SET ADDRESS = 'Pune' WHERE ID = 3"
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

[{
}]

Ejemplo: ExecuteCustomQuery SELECT_DATA_Table

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "SELECT * FROM CUSTOMERS"
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

[{
  "ID": 1.0,
  "NAME": "Ramesh",
  "AGE": 32.0,
  "ADDRESS": "Ahmedabad",
  "SALARY": 2000.0
}, {
  "ID": 2.0,
  "NAME": "Khilan",
  "AGE": 25.0,
  "ADDRESS": "Delhi",
  "SALARY": 1500.0
}, {
  "ID": 4.0,
  "NAME": "Chaitali",
  "AGE": 25.0,
  "ADDRESS": "Mumbai",
  "SALARY": 6500.0
}]

Ejemplo: ExecuteCustomQuery DeleteTable

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ExecuteCustomQuery y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "query": "DELETE FROM CUSTOMERS WHERE ID = 3"
   }
   

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ExecuteCustomQuery tendrá un valor similar al siguiente:

[{
}]

Ejemplos de operaciones de entidades

En esta sección se muestra cómo realizar algunas de las operaciones de entidad en este conector.

Ejemplo: listar todos los empleados

En este ejemplo se enumeran todos los empleados de la entidad Employee.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Employee en la lista Entity.
3. Selecciona la operación List y, a continuación, haz clic en Hecho.
4. Opcionalmente, en la sección Entrada de tarea de la tarea Conectores, puedes filtrar el conjunto de resultados especificando una cláusula de filtro. Especifique siempre el valor de la cláusula de filtro entre comillas simples ('). Por ejemplo, City='Bangalore'. También puede especificar varias condiciones de filtro mediante operadores lógicos. Por ejemplo, City='Bangalore' and region='asia-south2'.

Ejemplo: obtener un registro

En este ejemplo se obtiene un registro con el ID especificado de la entidad Employee.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Employee en la lista Entity.
3. Selecciona la operación Get y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haga clic en EntityId y, a continuación, introduzca 12294 en el campo Valor predeterminado.

   En este caso, 12294 es un valor de clave principal de la entidad Employee.

Ejemplo: crear un registro en Hana_unicode

En este ejemplo, se crea un registro en la entidad Hana_unicode.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Hana_unicode en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "ID": 2.0,
   "UNICODEDATA": "Unicode データ型はグローバル化されたデータの保存に使用されます",
   "TEST": "Test7"
   }

   Si la integración se realiza correctamente, el campo connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {
   "ID": 2.0,
   "UNICODEDATA": "Unicode データ型はグローバル化されたデータの保存に使用されます",
   "TEST": "Test7"
   }

Ejemplo: crear un registro en Languages

En este ejemplo, se crea un registro en la entidad Languages.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Languages en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "ID": 5,
   "ARABICTEXT": "مرحبا",
   "GERMANTEXT": "Günther",
   "HINDITEXT": "नमस्ते",
   "ENGLISHTEST": "Test1"
   }

   Si la integración se realiza correctamente, el campo connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {
   "ID": 5.0,
   "ARABICTEXT": "مرحبا",
   "GERMANTEXT": "Günther",
   "HINDITEXT": "नमस्ते",
   "ENGLISHTEST": "Test1"
   }

Ejemplo: actualizar un registro

En este ejemplo se actualiza un registro de la entidad Employee.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Employee en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "SALARY": 9000.0
   }

5. Haga clic en entityId y, a continuación, introduzca 12294 en el campo Valor predeterminado.

   Si la integración se realiza correctamente, el campo connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {
   "SALARY": 9000.0
   }

Ejemplo: eliminar un registro

En este ejemplo se elimina el registro con el ID especificado de la entidad Employee.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Employee en la lista Entity.
3. Selecciona la operación Delete y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haga clic en entityId y, a continuación, introduzca 10001 en el campo Valor predeterminado.