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"
     }