Skip to content
AWS for Query.Farm

aws.sesv2.get_export_job

Example SQL Queries

SELECT * FROM
aws.sesv2.get_export_job
WHERE
"job_id" = 'VALUE';

Description

Provides information about an export job.

Table Definition

Column NameColumn Data Type
job_id Required Input Column

The export job ID.

VARCHAR
_aws_profile Input Column

The AWS profile defines the AWS identity used. It can be defined via credentials or by assuming a IAM role.

STRUCT(
    "type" VARCHAR,
    "name" VARCHAR,
    "account_id" VARCHAR,
    "via_profile_name" VARCHAR,
    "assumed_role_arn" VARCHAR,
    "organization" STRUCT(
        "account_name" VARCHAR,
        "id" VARCHAR,
        "tags" STRUCT(
            "key" VARCHAR,
            "value" VARCHAR
        )[],
        "master_account" STRUCT(
            "id" VARCHAR,
            "email" VARCHAR
        ),
        "parents" STRUCT(
            "type" VARCHAR,
            "id" VARCHAR,
            "name" VARCHAR,
            "tags" STRUCT(
                "key" VARCHAR,
                "value" VARCHAR
            )[]
        )[]
    )
)
Show child fields
_aws_profile.account_id

The AWS account id

_aws_profile.assumed_role_arn

The ARN of the assumed role

_aws_profile.name

The unique name of the profile.

_aws_profile.organization

Information about this profile's membership in the AWS organization.

Show child fields
_aws_profile.organization.account_name

The name of account speciifed by the organization

_aws_profile.organization.id

The organization id

_aws_profile.organization.master_account
Show child fields
_aws_profile.organization.master_account.email

The organization master account email address

_aws_profile.organization.master_account.id

The organization master account id

_aws_profile.organization.parents[]
Show child fields
_aws_profile.organization.parents[].id

The id of the parent

_aws_profile.organization.parents[].name

The name of the parent

_aws_profile.organization.parents[].tags[]
Show child fields
_aws_profile.organization.parents[].tags[].key
_aws_profile.organization.parents[].tags[].value
_aws_profile.organization.parents[].type

The type of parent can be an organization unit or a root

_aws_profile.organization.tags[]
Show child fields
_aws_profile.organization.tags[].key
_aws_profile.organization.tags[].value
_aws_profile.type

The type of profile, either 'credentials' or 'assumed_role'

_aws_profile.via_profile_name

This IAM role for this profile is assumed by first utilizing another profile with this name to obtain credentials.

completed_timestamp

The timestamp of when the export job was completed.

TIMESTAMP_S
created_timestamp

The timestamp of when the export job was created.

TIMESTAMP_S
export_data_source

The data source of the export job.

STRUCT(
    "metrics_data_source" STRUCT(
        "dimensions" MAP(VARCHAR, VARCHAR[]),
        "namespace" VARCHAR,
        "metrics" STRUCT(
            "name" VARCHAR,
            "aggregation" VARCHAR
        )[],
        "start_date" TIMESTAMP_S,
        "end_date" TIMESTAMP_S
    ),
    "message_insights_data_source" STRUCT(
        "start_date" TIMESTAMP_S,
        "end_date" TIMESTAMP_S,
        "include" STRUCT(
            "from_email_address" VARCHAR[],
            "destination" VARCHAR[],
            "subject" VARCHAR[],
            "isp" VARCHAR[],
            "last_delivery_event" VARCHAR[],
            "last_engagement_event" VARCHAR[]
        ),
        "exclude" STRUCT(
            "from_email_address" VARCHAR[],
            "destination" VARCHAR[],
            "subject" VARCHAR[],
            "isp" VARCHAR[],
            "last_delivery_event" VARCHAR[],
            "last_engagement_event" VARCHAR[]
        ),
        "max_results" BIGINT
    )
)
Show child fields
export_data_source.message_insights_data_source

An object that contains filters applied when performing the Message Insights export.

Show child fields
export_data_source.message_insights_data_source.end_date

Represents the end date for the export interval as a timestamp. The end date is inclusive.

export_data_source.message_insights_data_source.exclude

Filters for results to be excluded from the export file.

Show child fields
export_data_source.message_insights_data_source.exclude.destination[]
export_data_source.message_insights_data_source.exclude.from_email_address[]
export_data_source.message_insights_data_source.exclude.isp[]
export_data_source.message_insights_data_source.exclude.last_delivery_event[]
export_data_source.message_insights_data_source.exclude.last_engagement_event[]
export_data_source.message_insights_data_source.exclude.subject[]
export_data_source.message_insights_data_source.include

Filters for results to be included in the export file.

Show child fields
export_data_source.message_insights_data_source.include.destination[]
export_data_source.message_insights_data_source.include.from_email_address[]
export_data_source.message_insights_data_source.include.isp[]
export_data_source.message_insights_data_source.include.last_delivery_event[]
export_data_source.message_insights_data_source.include.last_engagement_event[]
export_data_source.message_insights_data_source.include.subject[]
export_data_source.message_insights_data_source.max_results

The maximum number of results.

export_data_source.message_insights_data_source.start_date

Represents the start date for the export interval as a timestamp. The start date is inclusive.

export_data_source.metrics_data_source

An object that contains details about the data source for the metrics export.

Show child fields
export_data_source.metrics_data_source.dimensions

An object that contains a mapping between a MetricDimensionName and MetricDimensionValue to filter metrics by. Must contain a least 1 dimension but no more than 3 unique ones.

export_data_source.metrics_data_source.end_date

Represents the end date for the export interval as a timestamp.

export_data_source.metrics_data_source.metrics[]
Show child fields
export_data_source.metrics_data_source.metrics[].aggregation

The aggregation to apply to a metric, can be one of the following:

  • VOLUME - The volume of events for this metric.

  • RATE - The rate for this metric relative to the SEND metric volume.

export_data_source.metrics_data_source.metrics[].name

The metric to export, can be one of the following:

  • SEND - Emails sent eligible for tracking in the VDM dashboard. This excludes emails sent to the mailbox simulator and emails addressed to more than one recipient.

  • COMPLAINT - Complaints received for your account. This excludes complaints from the mailbox simulator, those originating from your account-level suppression list (if enabled), and those for emails addressed to more than one recipient

  • PERMANENT_BOUNCE - Permanent bounces - i.e., feedback received for emails sent to non-existent mailboxes. Excludes bounces from the mailbox simulator, those originating from your account-level suppression list (if enabled), and those for emails addressed to more than one recipient.

  • TRANSIENT_BOUNCE - Transient bounces - i.e., feedback received for delivery failures excluding issues with non-existent mailboxes. Excludes bounces from the mailbox simulator, and those for emails addressed to more than one recipient.

  • OPEN - Unique open events for emails including open trackers. Excludes opens for emails addressed to more than one recipient.

  • CLICK - Unique click events for emails including wrapped links. Excludes clicks for emails addressed to more than one recipient.

  • DELIVERY - Successful deliveries for email sending attempts. Excludes deliveries to the mailbox simulator and for emails addressed to more than one recipient.

  • DELIVERY_OPEN - Successful deliveries for email sending attempts. Excludes deliveries to the mailbox simulator, for emails addressed to more than one recipient, and emails without open trackers.

  • DELIVERY_CLICK - Successful deliveries for email sending attempts. Excludes deliveries to the mailbox simulator, for emails addressed to more than one recipient, and emails without click trackers.

  • DELIVERY_COMPLAINT - Successful deliveries for email sending attempts. Excludes deliveries to the mailbox simulator, for emails addressed to more than one recipient, and emails addressed to recipients hosted by ISPs with which Amazon SES does not have a feedback loop agreement.

export_data_source.metrics_data_source.namespace

The metrics namespace - e.g., VDM.

export_data_source.metrics_data_source.start_date

Represents the start date for the export interval as a timestamp.

export_destination

The destination of the export job.

STRUCT(
    "data_format" VARCHAR,
    "s3_url" VARCHAR
)
Show child fields
export_destination.data_format

The data format of the final export job file, can be one of the following:

  • CSV - A comma-separated values file.

  • JSON - A Json file.

export_destination.s3_url

An Amazon S3 pre-signed URL that points to the generated export file.

export_source_type

The type of source of the export job.

VARCHAR
failure_info

The failure details about an export job.

STRUCT(
    "failed_records_s3_url" VARCHAR,
    "error_message" VARCHAR
)
Show child fields
failure_info.error_message

A message about why the job failed.

failure_info.failed_records_s3_url

An Amazon S3 pre-signed URL that contains all the failed records and related information.

job_status

The status of the export job.

VARCHAR
statistics

The statistics about the export job.

STRUCT(
    "processed_records_count" BIGINT,
    "exported_records_count" BIGINT
)
Show child fields
statistics.exported_records_count

The number of records that were exported to the final export file.

This value might not be available for all export source types

statistics.processed_records_count

The number of records that were processed to generate the final export file.