从 Stripe 实体中读取

先决条件

• 您要从中读取内容的 Stripe 对象。

支持的实体

实体	可以筛选	支持限制	支持排序依据	支持选择*	支持分区
余额	否	否	否	是	否
余额交易	是	是	否	是	是
收费	是	是	否	是	是
争议	是	是	否	是	是
文件链接	是	是	否	是	是
付款意图	是	是	否	是	是
设置意图	是	是	否	是	是
支出	是	是	否	是	是
退款	是	是	否	是	是
产品	是	是	否	是	是
价格	是	是	否	是	是
优惠券	是	是	否	是	是
促销代码	是	是	否	是	是
税码	否	是	否	是	否
税率	是	是	否	是	是
运费	是	是	否	是	是
会话	是	是	否	是	是
信用票据	是	是	否	是	是
客户	是	是	否	是	是
账单	是	是	否	是	是
发票项目	是	是	否	是	否
计划	是	是	否	是	是
报价	是	是	否	是	否
订阅	是	是	否	是
订阅项目	否	是	否	是	否
订阅计划	是	是	否	是	是
账户	否	是	否	是	是
申请费	是	是	否	是	是
国家/地区具体要求	否	是	否	是	否
转接	是	是	否	是	是
欺诈预警	是	是	否	是	是
报告类型	否	否	否	是	否

示例

stripe_read = glueContext.create_dynamic_frame.from_options(
    connection_type="stripe",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "coupons",
        "API_VERSION": "v1"
    }
)

Stripe 实体和字段详细信息

实体	字段	数据类型	支持的运算符
余额
	available	列出
	connect_reserved	列出
	待处理	列出
	livemode	布尔值
	object	String
	instant_available	列出
	issuing	Struct
余额交易
	id	String
	object	String
	amount	整数
	available_on	DateTime	=, >=, <=,<,>
	created	DateTime	=, >=, <=,<,>
	currency	String
	description	String
	exchange_rate	BigDecimal
	fee	整数
	fee_details	列出
	net	整数
	reporting_category	String
	源	String	=
	状态	String
	type	String	=
	cross_border_classification	String
收费
	id	String
	object	String
	amount	整数	=, <, >
	amount_captured	整数
	amount_refunded	整数
	应用程序	String
	application_fee	String
	application_fee_amount	整数
	balance_transaction	String
	billing_details	Struct
	calculated_statement_descriptor	String
	captured	布尔值
	created	DateTime	=, >=, <=,<,>
	currency	String
	customer	String	=
	description	String
	目的地	String
	dispute	String
	disputed	布尔值	=
	failure_balance_transaction	String
	failure_code	String
	failure_message	String
	fraud_details	Struct
	发票	String
	livemode	布尔值
	metadata	Struct
	on_behalf_of	String
	顺序	String
	outcome	Struct
	paid	布尔值
	payment_intent	String	=
	payment_method	String
	payment_method_details	Struct
	receipt_email	String
	receipt_number	String
	receipt_url	String
	refunded	布尔值	=
	退款	Struct
	审核	String
	shipping	Struct
	源	Struct
	source_transfer	String
	statement_descriptor	String
	statement_descriptor_suffix	String
	状态	String
	转移	String
	transfer_data	Struct
	transfer_group	String	=
争议
	id	String
	object	String
	amount	整数	=, <, >
	balance_transaction	String
	balance_transactions	列出
	费用	String	=
	created	DateTime	=, >=, <=,<,>
	currency	String
	evidence	Struct
	evidence_details	Struct
	is_charge_refundable	布尔值
	livemode	布尔值
	metadata	Struct
	payment_intent	String	=
	reason	String	=
	状态	String
	payment_method_details	Struct
文件链接
	id	String
	object	String
	created	DateTime	=, >=, <=,<,>
	expired	布尔值	=
	expires_at	DateTime
	file	String	=
	livemode	布尔值
	metadata	Struct
	url	String
付款意图
	id	String
	object	String
	amount	整数
	amount_capturable	整数
	amount_details	Struct
	amount_received	整数
	应用程序	String
	application_fee_amount	整数
	automatic_payment_methods	Struct
	canceled_at	DateTime
	cancellation_reason	String
	capture_method	String
	client_secret	String
	confirmation_method	String
	created	DateTime	=, >=, <=,<,>
	currency	String
	customer	String	=
	description	String
	发票	String
	last_payment_error	Struct
	latest_charge	String
	livemode	布尔值
	metadata	Struct
	next_action	Struct
	on_behalf_of	String
	payment_method	String
	payment_method_options	Struct
	payment_method_types	列出
	payment_method_configuration_details	Struct
	处理	Struct
	receipt_email	String
	审核	String
	setup_future_usage	String
	shipping	Struct
	源	String
	statement_descriptor	String
	statement_descriptor_suffix	String
	状态	String
	transfer_data	Struct
	transfer_group	String
设置意图
	id	String
	object	String
	应用程序	String
	cancellation_reason	String
	client_secret	String
	created	DateTime	=, >=, <=,<,>
	customer	String	=
	description	String
	flow_directions	列出
	last_setup_error	Struct
	latest_attempt	String
	livemode	布尔值
	mandate	String
	metadata	Struct
	next_action	Struct
	on_behalf_of	String
	payment_method	String
	payment_method_options	Struct
	payment_method_types	列出
	single_use_mandate	String
	状态	String
	使用情况	String
	automatic_payment_methods	Struct
支出
	id	String
	object	String
	amount	整数	=, <, >
	arrival_date	DateTime	=, >=, <=,<,>
	automatic	布尔值
	balance_transaction	String
	created	DateTime	=, >=, <=,<,>
	currency	String
	description	String	=
	目的地	String
	failure_balance_transaction	String
	failure_code	String
	failure_message	String
	livemode	布尔值
	metadata	Struct
	method	String
	original_payout	String
	reversed_by	String
	reconciliation_status	String
	source_type	String
	statement_descriptor	String
	状态	String
	type	String
	application_fee	String
	application_fee_amount	整数
退款
	id	String
	object	String
	amount	整数
	balance_transaction	String
	费用	String	=
	created	DateTime	=, >=, <=,<,>
	currency	String
	metadata	Struct
	destination_details	Struct
	payment_intent	String	=
	reason	String
	receipt_number	String
	source_transfer_reversal	String
	状态	String
	transfer_reversal	String
产品
	id	String
	object	String
	active	布尔值	=
	属性	列出
	created	DateTime	=, >=, <=,<,>
	default_price	String
	description	String
	images	列出
	livemode	布尔值
	metadata	Struct
	name	String
	package_dimensions	Struct
	shippable	布尔值
	statement_descriptor	String
	tax_code	String
	type	String	=
	unit_label	String
	已更新	DateTime
	url	String
	特征	列出
价格
	id	String
	object	String
	active	布尔值	=
	billing_scheme	String
	created	DateTime	=, >=, <=,<,>
	currency	String	=
	custom_unit_amount	Struct
	livemode	布尔值
	lookup_key	String
	metadata	Struct
	nickname	String
	product	String	=
	recurring	Struct
	tax_behavior	String
	tiers_mode	String
	transform_quantity	Struct
	type	String	=
	unit_amount	整数
	unit_amount_decimal	String
优惠券
	Id	String
	object	String
	amount_off	整数
	created	DateTime	=, >=, <=,<,>
	currency	String	=
	duration	String	=
	duration_in_months	整数	=,<,>
	livemode	布尔值
	max_redemptions	整数	=, <, >
	metadata	Struct
	name	String
	percent_off	Double	=
	redeem_by	DateTime	=, >=, <=, <, >
	times_redeemed	整数
	valid	布尔值
促销代码
	Id	String
	object	String
	active	布尔值	=
	代码	String	=
	coupon	Struct
	created	DateTime	=,>=,<=,<,>
	customer	String
	expires_at	DateTime
	livemode	布尔值
	max_redemptions	整数
	metadata	Struct
	限制	Struct
	times_redeemed	整数
税码
	Id	String
	object	String
	description	String
	name	String
税率
	Id	String
	object	String
	active	布尔值	=
	country	String
	created	DateTime	=, >=, <=, <, >
	description	String
	display_name	String
	inclusive	布尔值	=
	jurisdiction	String
	jurisdiction_level	String
	livemode	布尔值
	metadata	Struct
	percentage	Double
	effective_percentage	Double
	状态	String
	tax_type	String
运费
	Id	String
	object	String
	active	布尔值	=
	created	DateTime	=, >=, <=, <, >
	delivery_estimate	Struct
	display_name	String
	fixed_amount	Struct
	livemode	布尔值
	metadata	Struct
	tax_behavior	String
	tax_code	String
	type	String
会话
	id	String
	object	String
	after_expiration	Struct
	allow_promotion_codes	布尔值
	amount_subtotal	整数
	amount_total	整数
	automatic_tax	Struct
	billing_address_collection	String
	cancel_url	String
	client_reference_id	String
	consent	Struct
	consent_collection	Struct
	created	DateTime	=, >=, <=, <, >
	currency	String
	custom_text	Struct
	customer	String
	customer_creation	String
	customer_details	Struct
	customer_email	String
	expires_at	DateTime
	发票	String
	invoice_creation	Struct
	livemode	布尔值
	locale	String
	metadata	Struct
	mode	String
	payment_intent	String	=
	payment_link	String
	payment_method_collection	String
	payment_method_options	Struct
	payment_method_types	列出
	payment_status	String
	phone_number_collection	Struct
	recovered_from	String
	setup_intent	String
	shipping_address_collection	Struct
	shipping_cost	Struct
	shipping_details	Struct
	shipping_options	列出
	状态	String
	submit_type	String
	订阅	String
	success_url	String
	tax_id_collection	Struct
	total_details	Struct
	url	String
	ui_mode	String
信用票据
	id	String
	object	String
	amount	整数
	created	DateTime	=, >=, <=, <, >
	currency	String
	customer	String	=
	customer_balance_transaction	String
	discount_amount	整数
	discount_amounts	列出
	发票	String	=
	lines	Struct
	livemode	布尔值
	memo	String
	metadata	Struct
	number	String
	out_of_band_amount	整数
	pdf	String
	reason	String
	refund	String
	状态	String
	subtotal	整数
	subtotal_excluding_tax	整数
	tax_amounts	列出
	total	整数
	total_excluding_tax	整数
	type	String
	voided_at	DateTime
	amount_shipping	整数
	effective_at	DateTime
	shipping_cost	Struct
客户
	id	String
	object	String
	address	Struct
	balance	整数
	created	DateTime
	currency	String	=, >=, <=, <, >
	default_source	String
	delinquent	布尔值	=
	description	String
	discount	Struct
	email	String	=
	invoice_prefix	String
	invoice_settings	Struct
	livemode	布尔值
	metadata	Struct
	name	String
	next_invoice_sequence	整数
	phone	String
	preferred_locales	列出
	shipping	Struct
	tax_exempt	String
	test_clock	String
账单
	id	String
	object	String
	account_country	String
	account_name	String
	account_tax_ids	列出
	amount_due	整数
	amount_paid	整数
	amount_remaining	整数
	应用程序	String
	application_fee_amount	整数
	attempt_count	整数
	attempted	布尔值	=
	auto_advance	布尔值	=
	automatic_tax	Struct
	billing_reason	String
	费用	String
	collection_method	String	=
	created	DateTime	=, >=, <=, <, >
	currency	String
	custom_fields	列出
	customer	String	=
	customer_address	Struct
	customer_email	String
	customer_name	String
	customer_phone	String
	customer_shipping	Struct
	customer_tax_exempt	String
	customer_tax_ids	列出
	default_payment_method	String
	default_source	String
	default_tax_rates	列出
	description	String
	discount	Struct
	discounts	列出
	due_date	DateTime	=, >=, <=, <, >
	ending_balance	整数
	footer	String
	from_invoice	Struct
	hosted_invoice_url	String
	invoice_pdf	String
	last_finalization_error	Struct
	latest_revision	String
	lines	Struct
	livemode	布尔值
	metadata	Struct
	next_payment_attempt	DateTime
	number	String
	on_behalf_of	String
	paid	布尔值	=
	paid_out_of_band	布尔值
	payment_intent	String
	payment_settings	Struct
	period_end	DateTime	=, >=, <=, <, >
	period_start	DateTime	=, >=, <=, <, >
	post_payment_credit_notes_amount	整数
	pre_payment_credit_notes_amount	整数
	quote	String
	receipt_number	String
	rendering	Struct
	rendering_options	Struct
	starting_balance	整数
	statement_descriptor	String
	状态	String	=
	status_transitions	Struct
	订阅	String
	subscription_details	Struct
	subtotal	整数	=, <, >
	subtotal_excluding_tax	整数
	tax	整数
	test_clock	String
	total	整数	=, <, >
	total_discount_amounts	列出
	total_excluding_tax	整数
	total_tax_amounts	列出
	transfer_data	Struct
	webhooks_delivered_at	DateTime
	automatically_finalizes_at	DateTime
	effective_at	DateTime
	发布者	Struct
发票项目
	id	String
	object	String
	amount	整数	=, <, >
	currency	String
	customer	String	=
	date	DateTime
	description	String
	discountable	布尔值
	discounts	列出
	发票	String	=
	livemode	布尔值
	metadata	Struct
	周期	Struct
	计划	Struct
	price	Struct
	proration	布尔值	=
	quantity	整数
	订阅	String
	subscription_item	String
	tax_rates	列出
	test_clock	String
	unit_amount	整数
	unit_amount_decimal	String
计划
	id	String
	object	String
	active	布尔值	=
	aggregate_usage	String
	amount	整数
	amount_decimal	String
	billing_scheme	String
	created	DateTime	=, >=, <=, <, >
	currency	String	=
	interval	String	=
	interval_count	整数
	livemode	布尔值
	metadata	Struct
	nickname	String
	product	String	=
	tiers_mode	String
	transform_usage	Struct
	trial_period_days	整数	=, <, >
	usage_type	String
	计量器	String
报价
	id	String
	object	String
	amount_subtotal	整数
	amount_total	整数
	应用程序	String
	application_fee_amount	整数
	application_fee_percent	Double
	automatic_tax	Struct
	collection_method	String
	computed	Struct
	created	DateTime
	currency	String
	customer	String	=
	default_tax_rates	列出
	description	String
	discounts	列出
	expires_at	DateTime
	footer	String
	from_quote	Struct
	header	String
	发票	String
	invoice_settings	Struct
	livemode	布尔值
	metadata	Struct
	number	String
	on_behalf_of	String
	状态	String	=
	status_transitions	Struct
	订阅	String
	subscription_data	Struct
	subscription_schedule	String
	test_clock	String
	total_details	Struct
	transfer_data	Struct
订阅
	id	String
	object	String
	应用程序	String
	application_fee_percent	Double
	automatic_tax	Struct
	billing_cycle_anchor	DateTime
	billing_thresholds	Struct
	cancel_at	DateTime
	cancel_at_period_end	布尔值
	canceled_at	DateTime
	collection_method	String	=
	created	DateTime	=, >=, <=,<,>
	currency	String
	current_period_end	DateTime	=, >=, <=
	current_period_start	DateTime	=, >=, <=
	customer	String	=
	days_until_due	整数
	default_payment_method	String
	default_source	String
	default_tax_rates	列出
	description	String
	discount	Struct
	ended_at	DateTime
	物品	Struct
	latest_invoice	String
	livemode	布尔值
	metadata	Struct
	next_pending_invoice_item_invoice	DateTime
	pause_collection	Struct
	payment_settings	Struct
	pending_invoice_item_interval	Struct
	pending_setup_intent	String
	pending_update	Struct
	计划	Struct
	quantity	整数
	schedule	String
	start_date	DateTime
	状态	String	=
	test_clock	String
	transfer_data	Struct
	trial_end	DateTime
	trial_start	DateTime
订阅项目
	Id	String
	object	String
	billing_thresholds	Struct
	created	DateTime	=, >=, <=, <, >
	metadata	Struct
	计划	Struct
	price	Struct
	订阅	String
	tax_rates	列出
	discounts	列出
订阅计划
	object	String
	应用程序	String
	canceled_at	DateTime
	completed_at	DateTime
	created	DateTime
	current_phase	Struct
	customer	String	=
	default_settings	Struct
	end_behavior	String
	livemode	布尔值
	metadata	Struct
	phases	列出
	released_at	DateTime
	released_subscription	String
	renewal_interval	String
	状态	String
	订阅	String
	test_clock	String
账户
	details_submitted	布尔值
	tos_acceptance	Struct
	type	String
	metadata	Struct
	id	String
	object	String
	default_currency	String
	能力	Struct
	charges_enabled	布尔值
	设置	Struct
	要求	Struct
	payouts_enabled	布尔值
	future_requirements	Struct
	external_accounts	Struct
	控制器	Struct
	country	String
	email	String
	created	DateTime	=, >=, <=, <, >
	business_profile	Struct
	business_type	String
	company	Struct
申请费
	id	String
	object	String
	账户	String
	amount	整数	=, <, >
	amount_refunded	整数	=, <, >
	应用程序	String
	balance_transaction	String
	费用	String	=
	created	DateTime
	currency	String
	livemode	布尔值
	originating_transaction	String
	refunded	布尔值	=
	退款	Struct
	fee_source	Struct
国家/地区具体要求
	id	String
	object	String
	default_currency	String
	supported_bank_account_currencies	Struct
	supported_payment_currencies	列出
	supported_payment_methods	列出
	supported_transfer_countries	列出
	verification_fields	Struct
转接
	id	String
	object	String
	amount	整数	=, <, >
	amount_reversed	整数
	balance_transaction	String
	created	DateTime	=, >=, <=, <, >
	currency	String	=
	description	String
	目的地	String	=
	destination_payment	String
	livemode	布尔值
	metadata	Struct
	reversals	Struct
	reversed	布尔值
	source_transaction	String
	source_type	String
	transfer_group	String	=
欺诈预警
	id	String
	object	String
	actionable	布尔值
	费用	String	=
	created	DateTime	=, >=, <=, <, >
	fraud_type	String
	livemode	布尔值
	payment_intent	String	=
报告类型
	id	String
	object	String
	data_available_end	DateTime
	data_available_start	DateTime
	default_columns	列出
	livemode	布尔值
	name	String
	已更新	DateTime
	版本	整数

对查询进行分区

如果您想在 Spark 中利用并发，可以提供附加 Spark 选项 PARTITION_FIELD、LOWER_BOUND、UPPER_BOUND 和 NUM_PARTITIONS。使用这些参数，原始查询将被拆分为 NUM_PARTITIONS 个子查询，这些子查询可以由 Spark 任务同时执行。

• PARTITION_FIELD：用于对查询进行分区的字段的名称。

• LOWER_BOUND：所选分区字段的包含下限值。

  对于日期，我们接受 Spark SQL 查询中使用的 Spark 日期格式。有效值示例："2024-07-01T00:00:00.000Z"。

• UPPER_BOUND：所选分区字段的排除上限值。

• NUM_PARTITIONS：分区的数量。

基于实体的分区字段支持详细信息如下表中所示。

Entity Name	分区字段	数据类型
余额交易	created	DateTime
收费	created	DateTime
争议	created	DateTime
文件链接	created	DateTime
付款意图	created	DateTime
设置意图	created	DateTime
支出	created	DateTime
退款	created	DateTime
产品	created	DateTime
价格	created	DateTime
优惠券	created	DateTime
促销代码	created	DateTime
税率	created	DateTime
运费	created	DateTime
会话	created	DateTime
信用票据	created	DateTime
客户	created	DateTime
账单	created	DateTime
计划	created	DateTime
订阅	created	DateTime
订阅计划	created	DateTime
账户	created	DateTime
申请费	created	DateTime
转接	created	DateTime
欺诈预警	created	DateTime

示例

stripe_read = glueContext.create_dynamic_frame.from_options(
    connection_type="stripe",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "coupons",
        "API_VERSION": "v1",
        "PARTITION_FIELD": "created"
        "LOWER_BOUND": "2024-05-01T20:55:02.000Z"
        "UPPER_BOUND": "2024-07-11T20:55:02.000Z"
        "NUM_PARTITIONS": "10"
    }
)