Lecture à partir d’entités Instagram Ads - AWS Glue
Détails des entités et des champs Instagram AdsRequêtes de partitionnement

Lecture à partir d’entités Instagram Ads

Prérequis

Un objet Instagram Ads à partir duquel vous souhaitez lire. Vous aurez besoin du nom de l’objet. Les tableaux suivants présentent les entités prises en charge.

Entités prises en charge pour la source :

Entité Peut être filtré Limit prise en charge Order by prise en charge Select prise en charge* Partitionnement pris en charge
Campagne Oui Oui Non Oui Oui
Ad Set Oui Oui Non Oui Oui
Ads Oui Oui Non Oui Oui
Ad Creative Non Oui Non Oui Non
Insights - Account Non Oui Non Oui Non
Ad Image Oui Oui Non Oui Non
Insights - Ad Oui Oui Non Oui Oui
Insights - AdSet Oui Oui Non Oui Oui
Insights - Campaign Oui Oui Non Oui Oui

Exemple :

instagramAds_read = glueContext.create_dynamic_frame.from_options(
    connection_type="instagramads",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v20.0"
    }

Détails des entités et des champs Instagram Ads

Pour plus d’informations sur les entités et de détails sur les champs, consultez :

Pour plus d’informations, consultez API Marketing.

Note

Les types de données Struct et List sont convertis en type de données String dans la réponse des connecteurs.

Requêtes de partitionnement

Vous pouvez indiquer les options Spark supplémentaires PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND et NUM_PARTITIONS si vous souhaitez utiliser la simultanéité dans Spark. Avec ces paramètres, la requête d’origine serait divisée en NUM_PARTITIONS nombres de sous-requêtes pouvant être exécutées simultanément par les tâches Spark.

  • PARTITION_FIELD : le nom du champ à utiliser pour partitionner la requête.

  • LOWER_BOUND : une valeur limite inférieure inclusive du champ de partition choisi.

    Pour le champ DateTime, nous acceptons le format d’horodatage Spark utilisé dans les requêtes SQL Spark.

    Exemple de valeur valide :

    "2022-01-01T00:00:00.000Z"

  • UPPER_BOUND : une valeur limite supérieure exclusive du champ de partition choisi.

    Exemple de valeur valide :

    "2024-01-02T00:00:00.000Z"

  • NUM_PARTITIONS : le nombre de partitions.

Exemple :

instagramADs_read = glueContext.create_dynamic_frame.from_options(
    connection_type="instagramads",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v20.0",
        "PARTITION_FIELD": "created_time"
        "LOWER_BOUND": "2022-01-01T00:00:00.000Z"
        "UPPER_BOUND": "2024-01-02T00:00:00.000Z"
        "NUM_PARTITIONS": "10"
    }