DataWorks:Source de données Salesforce

Paramètre

Obligatoire

Description

Valeur par défaut

datasource

Oui

Le nom de la source de données. En mode script, vous pouvez ajouter une source de données. La valeur de ce paramètre doit correspondre au nom de la source de données ajoutée.

Aucune

serviceType

Non

Le mode de synchronisation. Valeurs possibles :

• sobject : interroge un objet Salesforce.

• query : interroge les données à l'aide d'une instruction SOQL.

• bulk1 : interroge un objet Salesforce à l'aide de l'API Bulk 1.0.

• bulk2 : interroge un objet Salesforce à l'aide de l'API Bulk 2.0.

  Important

  • Les modes bulk1 et bulk2 ne prennent pas en charge les types de données composites, tels que address et geolocation.

  • Le mode bulk2 ne prend pas en charge les tâches distribuées.

  • Les performances peuvent varier entre bulk1 et bulk2. Testez les deux modes sur votre objet Salesforce pour sélectionner le plus adapté.

sobject

table

Oui

L'objet Salesforce, similaire à un nom de table, tel que Account, Case ou Group. Obligatoire si serviceType est défini sur sobject, bulk1 ou bulk2.

Aucune

beginDateTime

Non

• Les heures de début et de fin pour l'extraction des données. Ce paramètre est utilisé lorsque serviceType est défini sur sobject, bulk1 ou bulk2.

• Filtre les données en fonction de l'heure de dernière modification de l'objet Salesforce. Le champ d'heure de dernière modification est identifié automatiquement selon l'ordre de priorité suivant : SystemModstamp > LastModifiedDate > CreatedDate.

• La plage horaire constitue un intervalle fermé à gauche et ouvert à droite.

• Une chaîne temporelle au format yyyymmddhhmmss. Vous pouvez utiliser ce paramètre avec les paramètres de planification pour effectuer une extraction incrémentielle.

Aucune

endDateTime

Non

Aucune

splitPk

Non

• La clé de partitionnement. Ce paramètre est utilisé lorsque serviceType est défini sur sobject.

• Spécifie un champ à utiliser comme clé de partitionnement pour le fractionnement des données. Cela permet d'exécuter des tâches concurrentes et d'améliorer l'efficacité de la synchronisation des données.

• Seuls les types de données datetime, int et long sont pris en charge. L'utilisation d'autres types entraîne l'échec de la tâche.

Aucune

blockCompoundColumn

Non

Spécifie le comportement lorsqu'un type de données composite est rencontré. Ce paramètre est utilisé lorsque serviceType est défini sur bulk1 ou bulk2. Valeurs possibles :

• true : la tâche échoue. Vous devez supprimer le mappage de colonne pour le type de données composite et relancer la tâche.

• false : le type de données composite est lu comme NULL.

true

bulkQueryJobTimeoutSeconds

Non

• Le délai d'attente pour la préparation des données par lots, en secondes. Ce paramètre est utilisé lorsque serviceType est défini sur bulk1 ou bulk2.

• Le serveur Salesforce prépare les données par lots avant le début de la lecture. La tâche échoue si cette préparation dépasse le délai d'attente spécifié.

86400

batchSize

Non

• Taille du lot, c'est-à-dire le nombre d'enregistrements à télécharger par lot. Ce paramètre est utilisé lorsque serviceType est défini sur bulk1 ou bulk2.

• Pour des performances optimales, spécifiez une valeur légèrement supérieure à la taille de lot déterminée par la tâche de préparation des données Salesforce.

• Étant donné que les données sont diffusées en flux continu, l'augmentation de cette valeur n'entraîne pas une hausse de la consommation mémoire.

• Il s'agit d'un paramètre avancé qui n'est pas pris en charge en mode assistant.

300000

where

Non

• Condition de filtre. Ce paramètre est utilisé lorsque serviceType est défini sur sobject, bulk1 ou bulk2.

• Dans les scénarios métier réels, vous pouvez filtrer les données. Par exemple, spécifiez Name != 'Aliyun'.

• Si ce paramètre est vide, le système synchronise l'intégralité des données.

• La valeur doit constituer une clause WHERE SOQL valide. Par exemple, limit 10 n'est pas valide car LIMIT représente une clause distincte en SOQL.

Aucune

query

Non

• Instruction de requête. Ce paramètre est utilisé lorsque serviceType est défini sur query.

• Lorsque le paramètre where s'avère insuffisant, utilisez query pour fournir une instruction de requête SOQL complète. Si ce paramètre est spécifié, il remplace les paramètres table, column, beginDateTime, endDateTime, where et splitPk. Exemple : select Id, Name, IsDeleted from Account where Name!='Aliyun'.

• Il s'agit d'un paramètre avancé qui n'est pas pris en charge en mode assistant.

Aucune

queryAll

Non

• Indique si les enregistrements supprimés doivent être inclus dans la requête. Ce paramètre est utilisé lorsque serviceType est défini sur sobject ou query.

• Si la valeur est définie sur true, les résultats incluent les enregistrements supprimés, identifiables via le champ IsDeleted.

false

column

Oui

Colonnes à synchroniser. Spécifiez les colonnes sous forme de tableau JSON.

• Prend en charge l'élagage des colonnes, ce qui permet de sélectionner un sous-ensemble de colonnes à exporter.

• Permet de réorganiser les colonnes afin de les exporter dans un ordre différent du schéma de la table.

• Vous pouvez configurer des constantes. Exemple :

  [
    {
      "name": "Id",
      "type": "STRING"
    },
    {
      "name": "Name",
      "type": "STRING"
    },
    {
      "name": "'123'",
      "type": "LONG"
    },
    {
      "name": "'abc'",
      "type": "STRING"
    }
  ]

  Remarque

  • Id et Name correspondent aux noms de colonne standards.

  • '123' représente une constante entière. Notez qu'elle doit être entourée de guillemets simples.

  • 'abc' représente une constante de type chaîne. Notez qu'elle doit être entourée de guillemets simples.

• Vous devez explicitement spécifier toutes les colonnes à synchroniser sous forme d'un tableau non vide.

Aucune

connectTimeoutSeconds

Non

• Délai d'attente pour l'établissement d'une connexion HTTP, exprimé en secondes. La tâche échoue si la connexion n'est pas établie dans ce délai.

• Il s'agit d'un paramètre avancé qui n'est pas pris en charge en mode assistant.

30

socketTimeoutSeconds

Non

• Délai d'attente de la réponse HTTP, exprimé en secondes. La tâche échoue si le temps écoulé entre la réception de paquets de données consécutifs dépasse cette valeur.

• Il s'agit d'un paramètre avancé qui n'est pas pris en charge en mode assistant.

600

retryIntervalSeconds

Non

• Intervalle de nouvelle tentative, exprimé en secondes.

• Il s'agit d'un paramètre avancé qui n'est pas pris en charge en mode assistant.

60

retryTimes

Non

• Le nombre de tentatives de nouvelle tentative.

• Il s'agit d'un paramètre avancé qui n'est pas pris en charge dans le mode Assistant.

3