# 连接到 Facebook Page Insights Facebook Page 允许公司和其他利益团体为 Facebook.com 社交网络创建页面。公司使用这些页面来共享营业时间、发布公告以及与客户进行在线互动。如果是 Facebook Page Insights 用户，则可将 AWS Glue 连接到 Facebook Page Insights 账户。可以使用 Facebook Page Insights 作为 ETL 作业中的数据来源。通过运行这些作业，可将数据从 Facebook Page Insights 传输到 AWS 服务或其他受支持的应用程序。 **Topics** + [AWS Glue 支持 Facebook Page Insights](facebook-page-insights-support.md) + [包含创建和使用连接的 API 操作的策略](facebook-page-insights-configuring-iam-permissions.md) + [配置 Facebook Page Insights](facebook-page-insights-configuring.md) + [配置 Facebook Page Insights 连接](facebook-page-insights-configuring-connections.md) + [从 Facebook Page Insight 读取内容](facebook-page-insights-reading-from-entities.md) + [Facebook Page Insights 连接选项](facebook-page-insights-connection-options.md) + [Facebook Page Insights 连接器的限制和说明](facebook-page-insights-connector-limitations.md) # AWS Glue 支持 Facebook Page Insights AWS Glue 对 Facebook Page Insights 的支持情况如下： **是否支持作为来源？** 是。可以使用 AWS Glue ETL 作业查询 Facebook Page Insights 中的数据。 **是否支持作为目标？** 否。 **支持的 Facebook Page Insight API 版本** 支持以下 Facebook Page Insights API 版本： + v17 + v18 + v19 + v20 + v21 # 包含创建和使用连接的 API 操作的策略 以下示例策略描述了创建和使用连接所需的 AWS IAM 权限。如果您要创建新角色，请创建包含以下内容的策略： ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "glue:ListConnectionTypes", "glue:DescribeConnectionType", "glue:RefreshOAuth2Tokens", "glue:ListEntities", "glue:DescribeEntity" ], "Resource": "*" } ] } ``` ------ 如果您不想使用上述方法，也可以使用以下托管 IAM 策略： + [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole) – 授予对各种 AWS Glue 进程代表您运行所需的资源的访问权限。这些资源包括 AWS Glue、Amazon S3、IAM、CloudWatch Logs 和 Amazon EC2。如果您遵循此策略中指定的资源的命名约定，则 AWS Glue 进程具有所需的权限。此策略通常附加到在定义爬网程序、作业和开发终端节点时指定的角色。 + [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)：当策略所附加到的身份使用 AWS 管理控制台时，授予对 AWS Glue 资源的完全访问权限。如果遵循此策略中指定的资源的命名约定，则用户具有完全控制台功能。此策略通常附加到 AWS Glue 控制台的用户。 # 配置 Facebook Page Insights 必须满足以下要求，才能使用 AWS Glue 从 Facebook Page Insights 传输数据： ## 最低要求 以下是最低要求： + 可通过 Facebook 直接访问 Facebook 标准账户。 + 需要进行用户身份验证才能生成访问令牌。 + Facebook Page Insights 连接器将实现用户访问令牌 OAuth 流。 + 连接器使用 OAuth2.0 来验证我们向 Facebook Page Insights 发送的 API 请求。这属于多重身份验证（MFA）架构，是双重身份验证（2FA）的超集。它是基于 Web 的身份验证。 + 用户需要授予访问端点的权限。为了访问用户的数据，端点授权是通过权限和功能来处理的。 # 配置 Facebook Page Insights 连接 要配置 Facebook Page Insights 连接，请执行以下操作： 1. 在 AWS Glue Glue Studio 中，按照以下步骤在**数据连接**下创建连接： 1. 选择**连接类型**时，请选择 Facebook Page Insights。 1. 选择 AWS Glue 可以代入并有权执行以下操作的 AWS IAM 角色： ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "secretsmanager:DescribeSecret", "secretsmanager:GetSecretValue", "secretsmanager:PutSecretValue", "ec2:CreateNetworkInterface", "ec2:DescribeNetworkInterfaces", "ec2:DeleteNetworkInterface" ], "Resource": "*" } ] } ``` ------ 1. 选择授权码 URL。 1. 在 AWS Glue 中选择您要用于此连接的 `secretName`，然后放置令牌。 1. 如果要使用网络，请选择网络选项。 1. 向与您的 AWS Glue 作业关联的 IAM 角色授予读取 `secretName` 的权限。 # 从 Facebook Page Insight 读取内容 **先决条件** 要从中读取内容的 Facebook Page Insights 对象。您将需要对象名称。 **源支持的实体**： | 实体 | 可以筛选 | 支持限制 | 支持排序依据 | 支持 Select \$1 | 支持分区 | | --- | --- | --- | --- | --- | --- | | 页面内容 | 是 | 否 | 是 | 是 | 是 | | 页面 CTA 点击次数 | 是 | 否 | 否 | 是 | 是 | | 页面互动量 | 是 | 否 | 否 | 是 | 是 | | 页面展示量 | 是 | 否 | 否 | 是 | 是 | | 页面文章数 | 是 | 否 | 否 | 是 | 是 | | 页面文章互动量 | 否 | 否 | 否 | 是 | 否 | | 页面文章反应量 | 否 | 否 | 否 | 是 | 否 | | 页面反应量 | 是 | 否 | 否 | 是 | 是 | | 故事 | 是 | 否 | 否 | 是 | 是 | | 页面用户人口统计数据 | 是 | 否 | 否 | 是 | 是 | | 页面视频观看量 | 是 | 否 | 否 | 是 | 是 | | 页面浏览量 | 是 | 否 | 否 | 是 | 是 | | 页面视频文章量 | 是 | 否 | 否 | 是 | 是 | | 页面 | 否 | 是 | 否 | 是 | 否 | | 动态 | 支持 | 是 | 否 | 是 | 是 | **示例：** ``` facebookPageInsights_read = glueContext.create_dynamic_frame. from options( connection_type="facebookpageinsights", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "entityName", "API_VERSION": "v21" } ``` **Facebook Page Insights 字段详细信息**： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/glue/latest/dg/facebook-page-insights-reading-from-entities.html) ## 对查询进行分区 **基于筛选器的分区**： 如果您想在 Spark 中利用并发，可以提供其他 Spark 选项：`PARTITION_FIELD`、`LOWER_BOUND`、`UPPER_BOUND` 和 `NUM_PARTITIONS`。使用这些参数，原始查询将被拆分为 `NUM_PARTITIONS` 个子查询，这些子查询可以由 Spark 任务同时执行。 + `PARTITION_FIELD`：用于对查询进行分区的字段的名称。 + `LOWER_BOUND`：所选分区字段的**包含**下限值。 对于“日期时间”字段，我们接受 Spark SQL 查询中使用的 Spark 时间戳格式。 有效值示例： ``` "2024-09-30T01:01:01.000Z" ``` + `UPPER_BOUND`：所选分区字段的**排除**上限值。 + `NUM_PARTITIONS`：分区的数量。 示例： ``` facebookPageInsights_read = glueContext.create_dynamic_frame.from_options( connection_type="facebookpageinsights", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "entityName", "API_VERSION": "v21", "PARTITION_FIELD": "created_Time" "LOWER_BOUND": "2024-10-27T07:00:00+0000" "UPPER_BOUND": "2024-10-27T07:00:00+0000" "NUM_PARTITIONS": "10" } ``` # Facebook Page Insights 连接选项 以下是 Facebook Page Insights 的连接选项： + `ENTITY_NAME`（字符串）：（必填）用于读取。Facebook Page Insights 中对象的名称。 + `API_VERSION`（字符串）：（必填）用于读取。要使用的 Facebook Page Insights Rest API 版本。 + `SELECTED_FIELDS`（列表<字符串>）–默认：empty(SELECT \$1)。用于读取。您想要为对象选择的列。 + `FILTER_PREDICATE`（字符串）– 默认：空。用于读取。应采用 Spark SQL 格式。 + `QUERY`（字符串）– 默认：空。用于读取。完整的 Spark SQL 查询。 + `PARTITION_FIELD`（字符串）– 用于读取。用于分区查询的字段。 + `LOWER_BOUND`（字符串）– 用于读取。所选分区字段的包含下限值。 + `UPPER_BOUND`（字符串）– 用于读取。所选分区字段的排除上限值。 + `NUM_PARTITIONS`（整数）– 默认：1。用于读取。要读取的分区数。 + `INSTANCE_URL`（字符串）：（必填）用于读取。有效的 Facebook Page Insights 实例 URL。 # Facebook Page Insights 连接器的限制和说明 以下是 Facebook Page Insights 连接器的限制或说明： + 大多数指标每 24 小时更新一次。 + 仅提供最近两年的见解数据。 + 使用 `since` 和 `until` 参数时，一次只能查看 90 天的见解数据。