Freshdesk エンティティからの読み取り - AWS Glue
パーティショニングクエリ

Freshdesk エンティティからの読み取り

前提条件

読み取り元の Freshdesk オブジェクト。オブジェクト名が必要になります。

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

エンティティ フィルタリング可能 制限をサポートする Order By をサポートする Select * をサポートする パーティション分割をサポートする
エージェント はい あり なし あり あり
営業時間 なし あり なし あり あり
Company はい あり なし あり あり
問い合わせ はい あり なし あり あり
Conversations なし あり なし あり なし
E メール設定 なし あり なし あり なし
E メール受信トレイ はい あり あり あり なし
フォーラムカテゴリ なし あり なし あり なし
フォーラム なし あり なし あり なし
グループ なし あり なし あり なし
製品 なし あり なし あり なし
ロール なし あり なし あり なし
満足度評価 はい あり なし あり なし
スキル なし あり なし あり なし
解決方法 はい あり なし あり なし
アンケート なし あり なし あり なし
チケット はい あり あり あり あり
時間エントリ はい あり なし あり なし
トピック なし あり なし あり なし
トピックのコメント なし あり なし あり なし

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

エンティティ API バージョン フィルタリング可能 制限をサポートする Order By をサポートする Select * をサポートする パーティション分割をサポートする
Companies v2 なし なし なし なし なし
問い合わせ v2 なし なし なし なし なし

例:

freshdesk_read = glueContext.create_dynamic_frame.from_options(
    connection_type="freshdesk",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v2"
    }

Freshdesk エンティティとフィールドの詳細

エンティティ フィールド
エージェント https://developers.freshdesk.com/api/#list_all_agents
営業時間 https://developers.freshdesk.com/api/#list_all_business_hours
コメント https://developers.freshdesk.com/api/#comment_attributess
Company https://developers.freshdesk.com/api/#companies
問い合わせ https://developers.freshdesk.com/api/#list_all_contacts
Conversations https://developers.freshdesk.com/api/#list_all_ticket_notes
Email-configs https://developers.freshdesk.com/api/#list_all_email_configs
Email-inboxes https://developers.freshdesk.com/api/#list_all_email_mailboxes
Forum-categories https://developers.freshdesk.com/api/#category_attributes
フォーラム https://developers.freshdesk.com/api/#forum_attributes
グループ https://developers.freshdesk.com/api/#list_all_groups
製品 https://developers.freshdesk.com/api/#list_all_products
ロール https://developers.freshdesk.com/api/#list_all_roles
Satisfaction-rating https://developers.freshdesk.com/api/#view_all_satisfaction_ratingss
スキル https://developers.freshdesk.com/api/#list_all_skills
解決方法 https://developers.freshdesk.com/api/#solution_content
アンケート https://developers.freshdesk.com/api/#list_all_survey
チケット https://developers.freshdesk.com/api/#list_all_tickets
Time-entries https://developers.freshdesk.com/api/#list_all_time_entries
トピック https://developers.freshdesk.com/api/#topic_attributes

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

フィルターベースのパーティション分割:

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

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

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

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

    有効な値の例は次のとおりです:

    "2024-09-30T01:01:01.000Z"

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

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

例:

freshDesk_read = glueContext.create_dynamic_frame.from_options(
     connection_type="freshdesk",
     connection_options={
         "connectionName": "connectionName",
         "ENTITY_NAME": "entityName",
         "API_VERSION": "v2",
         "PARTITION_FIELD": "Created_Time"
         "LOWER_BOUND": " 2024-10-27T23:16:08Z“
         "UPPER_BOUND": " 2024-10-27T23:16:08Z"
         "NUM_PARTITIONS": "10"
     }