Facebook 広告エンティティからの読み取り - AWS Glue
Facebook 広告エンティティとフィールドの詳細パーティショニングクエリ

Facebook 広告エンティティからの読み取り

前提条件

読み取り元の Facebook 広告オブジェクト。オブジェクト名が必要になります。次の表は、サポートされているエンティティを示しています。

ソースに対応するエンティティ:

エンティティ フィルタリング可能 制限をサポートする Order By をサポートする Select * をサポートする パーティション分割をサポートする
キャンペーン はい あり なし あり あり
Ad Set はい あり なし あり あり
Ads はい あり なし あり あり
Ad Creative なし あり なし あり なし
Insights - Account なし あり なし あり なし
Adaccounts はい あり なし あり なし
Insights - Ad はい あり なし あり あり
Insights - AdSet はい あり なし あり あり
Insights - Campaign はい あり なし あり あり

例:

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

Facebook 広告エンティティとフィールドの詳細

エンティティとフィールドの詳細については、以下を参照してください:

詳細については、「Marketing API」を参照してください。

注記

構造体データ型とリストデータ型は、コネクタの応答で文字列データ型に変換されます。

パーティショニングクエリ

Spark で同時実行を使用する場合は、追加の Spark オプション PARTITION_FIELD、LOWER_BOUND、UPPER_BOUND、および NUM_PARTITIONS を指定できます。これらのパラメータを使用すると、元のクエリは Spark タスクで同時に実行できるサブクエリの NUM_PARTITIONS の数に分割されます。

  • PARTITION_FIELD: クエリのパーティション化に使用するフィールドの名前。

  • LOWER_BOUND: 選択したパーティションフィールドの包括的な下限値。

    DateTime フィールドでは、Spark SQL クエリで使用される Spark タイムスタンプ形式を受け入れます。

    有効な値の例:

    "2022-01-01"

  • UPPER_BOUND: 選択したパーティションフィールドの排他的上限値。

  • NUM_PARTITIONS: パーティション数。

例:

FacebookADs_read = glueContext.create_dynamic_frame.from_options(
    connection_type="FacebookAds",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v20.0",
        "PARTITION_FIELD": "created_time"
        "LOWER_BOUND": "2022-01-01"
        "UPPER_BOUND": "2024-01-02"
        "NUM_PARTITIONS": "10"
    }