SAP HANA

Entités, opérations et actions

Tous les connecteurs Integration Connectors fournissent une couche d'abstraction pour les objets de l'application connectée. Vous ne pouvez accéder aux objets d'une application que par le biais de cette abstraction. L'abstraction vous est présentée en tant qu'entités, opérations et actions.

• Entité : une entité peut être considérée comme un objet ou un ensemble de propriétés dans l'application ou le service connectés. La définition d'une entité diffère d'un connecteur à l'autre. Par exemple, dans un connecteur de base de données, les tables sont les entités, alors que dans un connecteur de serveur de fichiers, ce sont les dossiers, et dans un connecteur de système de messagerie, ce sont les files d'attente.

  Toutefois, il est possible qu'un connecteur n'accepte ou ne possède aucune entité. Dans ce cas, la liste Entities est vide.

• Opération : une opération est l'activité que vous pouvez effectuer sur une entité. Vous pouvez effectuer l'une des opérations suivantes sur une entité :
  • List
  • Get
  • Create
  • Update
  • Delete

  Lorsque vous sélectionnez une entité dans la liste proposée, cela génère une liste d'opérations disponibles pour l'entité. Pour obtenir une description détaillée des opérations, consultez les opérations d'entité de la tâche "Connecteurs". Cependant, si un connecteur n'accepte pas l'une des opérations d'entité, cette opération non compatible ne figure pas dans la liste Operations.

• Action : une action est une fonction de première classe mise à la disposition de l'intégration par le biais de l'interface du connecteur. Une action vous permet de modifier une ou plusieurs entités, et varie d'un connecteur à l'autre. Normalement, une action comporte des paramètres d'entrée et un paramètre de sortie. Toutefois, il est possible qu'un connecteur n'accepte aucune action, auquel cas la liste Actions est vide.

Actions

Dans cette section, vous trouverez la liste des actions prises en charge par le connecteur. Pour savoir comment configurer les actions, consultez Exemples d'actions.

Action EMPLOYEE_PROCEDURE_HANA

Cette action renvoie les données d'un ID.

Paramètres d'entrée de l'action EMPLOYEE_PROCEDURE_HANA

Pour obtenir des exemples de configuration de l'action EMPLOYEE_PROCEDURE_HANA, consultez Exemples.

Action ExecuteCustomQuery

Avec cette action, vous pouvez effectuer des tâches spécifiques. Par exemple, HANADB vous permet d'exécuter une requête SQL personnalisée.

Paramètres d'entrée de l'action ExecuteCustomQuery

Pour obtenir des exemples de configuration de l'action ExecuteCustomQuery, consultez Exemples.

Exemples d'actions

Exemple : EMPLOYEE_PROCEDURE_HANA

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action EMPLOYEE_PROCEDURE_HANA, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "ID":1
   }
   

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche EMPLOYEE_PROCEDURE_HANA aura une valeur semblable à la suivante :

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

Exemple : ExecuteCustomQuery Join_GroupBy

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ 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 l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

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

Exemple : ExecuteCustomQuery Join

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

[{
  "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
}]

Exemple : ExecuteCustomQuery Groupby_Having_Count

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

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

Exemple : ExecuteCustomQuery GroupBy

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Cet exemple met à jour les enregistrements ExecuteCustomQuery. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

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

Exemple : ExecuteCustomQuery GroupBy_OrderBy

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

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

Exemple : ExecuteCustomQuery Insert_Table

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

[{
}]

Exemple : ExecuteCustomQuery SUM_AggFunc

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

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

Exemple : ExecuteCustomQuery AVG_AggFunc

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

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

Exemple : ExecuteCustomQuery MAX_AggFunc

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

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

Exemple : ExecuteCustomQuery MIN_AggFunc

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

[{
"MIN_SALARY": 1500.0
}]

Exemple : ExecuteCustomQuery COUNT_AggFunc

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

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

Exemple : ExecuteCustomQuery CreateTable

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

[{
}]

Exemple : ExecuteCustomQuery AlterTable

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

[{
}]

Exemple : ExecuteCustomQuery TruncateTable

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "query": "TRUNCATE TABLE GCP_HANA_RENAME"
   }
   

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

[{
}]

Exemple : ExecuteCustomQuery DropTable

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "query": "DROP TABLE GCP_HANA_DROP"
   }
   

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

[{
}]

Exemple : ExecuteCustomQuery RenameTable

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

[{
}]

Exemple : ExecuteCustomQuery UpdateTable

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

[{
}]

Exemple : ExecuteCustomQuery SELECT_DATA_Table

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

[{
  "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
}]

Exemple : ExecuteCustomQuery DeleteTable

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ExecuteCustomQuery, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ExecuteCustomQuery aura une valeur semblable à la suivante :

[{
}]

Exemples d'opérations d'entité

Cette section explique comment effectuer certaines opérations d'entité dans ce connecteur.

Exemple : Lister tous les employés

Cet exemple liste tous les employés de l'entité Employee.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Employee dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.
4. (Facultatif) Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez filtrer votre ensemble de résultats en spécifiant une clause de filtre. Indiquez toujours la valeur de la clause de filtre entre guillemets simples ('). Par exemple : City='Bangalore'. Vous pouvez également spécifier plusieurs conditions de filtre à l'aide des opérateurs logiques. Par exemple : City='Bangalore' and region='asia-south2'.

Exemple : Récupérer un enregistrement

Cet exemple récupère un enregistrement ayant l'ID spécifié à partir de l'entité Employee.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Employee dans la liste Entity.
3. Sélectionnez l'opération Get, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur EntityId, puis saisissez 12294 dans le champ Valeur par défaut.

   Ici, 12294 est une valeur de clé primaire dans l'entité Employee.

Exemple : Créer un enregistrement dans Hana_unicode

Cet exemple crée un enregistrement dans l'entité Hana_unicode.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Hana_unicode dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

   Si l'intégration aboutit, le champ connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

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

Exemple : Créer un enregistrement dans Languages

Cet exemple crée un enregistrement dans l'entité Languages.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Languages dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

   Si l'intégration aboutit, le champ connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

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

Exemple : Mettre à jour un enregistrement

Cet exemple met à jour un enregistrement dans l'entité Employee.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Employee dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "SALARY": 9000.0
   }

5. Cliquez sur entityId, puis saisissez 12294 dans le champ Valeur par défaut.

   Si l'intégration aboutit, le champ connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

   {
   "SALARY": 9000.0
   }

Exemple : Supprimer un enregistrement

Cet exemple supprime l'enregistrement ayant l'ID spécifié dans l'entité Employee.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Employee dans la liste Entity.
3. Sélectionnez l'opération Delete, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur entityId, puis saisissez 10001 dans le champ Valeur par défaut.