本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 視覺化任務 API
視覺化任務 API 可讓您使用代表任務視覺化組態的 JSON 物件中的 AWS Glue API 來建立資料整合 AWS Glue 任務。
清單`CodeGenConfigurationNodes`會提供給建立或更新任務 API，以在 AWS Glue Studio 中為建立的任務註冊 DAG，並產生相關聯的程式碼。
## 資料類型
+ [CodeGenConfigurationNode 結構](#aws-glue-api-visual-job-api-CodeGenConfigurationNode)
+ [JDBCConnectorOptions 結構](#aws-glue-api-visual-job-api-JDBCConnectorOptions)
+ [StreamingDataPreviewOptions 結構](#aws-glue-api-visual-job-api-StreamingDataPreviewOptions)
+ [AthenaConnectorSource 結構](#aws-glue-api-visual-job-api-AthenaConnectorSource)
+ [JDBCConnectorSource 結構](#aws-glue-api-visual-job-api-JDBCConnectorSource)
+ [SparkConnectorSource 結構](#aws-glue-api-visual-job-api-SparkConnectorSource)
+ [CatalogSource 結構](#aws-glue-api-visual-job-api-CatalogSource)
+ [MySQLCatalogSource 結構](#aws-glue-api-visual-job-api-MySQLCatalogSource)
+ [PostgreSQLCatalogSource 結構](#aws-glue-api-visual-job-api-PostgreSQLCatalogSource)
+ [OracleSQLCatalogSource 結構](#aws-glue-api-visual-job-api-OracleSQLCatalogSource)
+ [MicrosoftSQLServerCatalogSource 結構](#aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogSource)
+ [CatalogKinesisSource 結構](#aws-glue-api-visual-job-api-CatalogKinesisSource)
+ [DirectKinesisSource 結構](#aws-glue-api-visual-job-api-DirectKinesisSource)
+ [KinesisStreamingSourceOptions 結構](#aws-glue-api-visual-job-api-KinesisStreamingSourceOptions)
+ [CatalogKafkaSource 結構](#aws-glue-api-visual-job-api-CatalogKafkaSource)
+ [DirectKafkaSource 結構](#aws-glue-api-visual-job-api-DirectKafkaSource)
+ [KafkaStreamingSourceOptions 結構](#aws-glue-api-visual-job-api-KafkaStreamingSourceOptions)
+ [RedshiftSource 結構](#aws-glue-api-visual-job-api-RedshiftSource)
+ [AmazonRedshiftSource 結構](#aws-glue-api-visual-job-api-AmazonRedshiftSource)
+ [AmazonRedshiftNodeData 結構](#aws-glue-api-visual-job-api-AmazonRedshiftNodeData)
+ [AmazonRedshiftAdvancedOption 結構](#aws-glue-api-visual-job-api-AmazonRedshiftAdvancedOption)
+ [選項結構](#aws-glue-api-visual-job-api-Option)
+ [S3CatalogSource 結構](#aws-glue-api-visual-job-api-S3CatalogSource)
+ [S3SourceAdditionalOptions 結構](#aws-glue-api-visual-job-api-S3SourceAdditionalOptions)
+ [S3CsvSource 結構](#aws-glue-api-visual-job-api-S3CsvSource)
+ [DirectJDBCSource 結構](#aws-glue-api-visual-job-api-DirectJDBCSource)
+ [S3DirectSourceAdditionalOptions 結構](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions)
+ [S3JsonSource 結構](#aws-glue-api-visual-job-api-S3JsonSource)
+ [S3ParquetSource 結構](#aws-glue-api-visual-job-api-S3ParquetSource)
+ [S3DeltaSource 結構](#aws-glue-api-visual-job-api-S3DeltaSource)
+ [S3CatalogDeltaSource 結構](#aws-glue-api-visual-job-api-S3CatalogDeltaSource)
+ [CatalogDeltaSource 結構](#aws-glue-api-visual-job-api-CatalogDeltaSource)
+ [S3HudiSource 結構](#aws-glue-api-visual-job-api-S3HudiSource)
+ [S3CatalogHudiSource 結構](#aws-glue-api-visual-job-api-S3CatalogHudiSource)
+ [S3ExcelSource 結構](#aws-glue-api-visual-job-api-S3ExcelSource)
+ [CatalogHudiSource 結構](#aws-glue-api-visual-job-api-CatalogHudiSource)
+ [DynamoDBCatalogSource 結構](#aws-glue-api-visual-job-api-DynamoDBCatalogSource)
+ [RelationalCatalogSource 結構](#aws-glue-api-visual-job-api-RelationalCatalogSource)
+ [JDBCConnectorTarget 結構](#aws-glue-api-visual-job-api-JDBCConnectorTarget)
+ [SparkConnectorTarget 結構](#aws-glue-api-visual-job-api-SparkConnectorTarget)
+ [BasicCatalogTarget 結構](#aws-glue-api-visual-job-api-BasicCatalogTarget)
+ [MySQLCatalogTarget 結構](#aws-glue-api-visual-job-api-MySQLCatalogTarget)
+ [PostgreSQLCatalogTarget 結構](#aws-glue-api-visual-job-api-PostgreSQLCatalogTarget)
+ [OracleSQLCatalogTarget 結構](#aws-glue-api-visual-job-api-OracleSQLCatalogTarget)
+ [MicrosoftSQLServerCatalogTarget 結構](#aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogTarget)
+ [RedshiftTarget 結構](#aws-glue-api-visual-job-api-RedshiftTarget)
+ [AmazonRedshiftTarget 結構](#aws-glue-api-visual-job-api-AmazonRedshiftTarget)
+ [UpsertRedshiftTargetOptions 結構](#aws-glue-api-visual-job-api-UpsertRedshiftTargetOptions)
+ [S3CatalogTarget 結構](#aws-glue-api-visual-job-api-S3CatalogTarget)
+ [S3GlueParquetTarget 結構](#aws-glue-api-visual-job-api-S3GlueParquetTarget)
+ [CatalogSchemaChangePolicy 結構](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy)
+ [S3DirectTarget 結構](#aws-glue-api-visual-job-api-S3DirectTarget)
+ [S3HudiCatalogTarget 結構](#aws-glue-api-visual-job-api-S3HudiCatalogTarget)
+ [S3HudiDirectTarget 結構](#aws-glue-api-visual-job-api-S3HudiDirectTarget)
+ [S3DeltaCatalogTarget 結構](#aws-glue-api-visual-job-api-S3DeltaCatalogTarget)
+ [S3DeltaDirectTarget 結構](#aws-glue-api-visual-job-api-S3DeltaDirectTarget)
+ [S3HyperDirectTarget 結構](#aws-glue-api-visual-job-api-S3HyperDirectTarget)
+ [S3IcebergDirectTarget 結構](#aws-glue-api-visual-job-api-S3IcebergDirectTarget)
+ [DirectSchemaChangePolicy 結構](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy)
+ [ApplyMapping 結構](#aws-glue-api-visual-job-api-ApplyMapping)
+ [Mapping 結構](#aws-glue-api-visual-job-api-Mapping)
+ [SelectFields 結構](#aws-glue-api-visual-job-api-SelectFields)
+ [DropFields 結構](#aws-glue-api-visual-job-api-DropFields)
+ [RenameField 結構](#aws-glue-api-visual-job-api-RenameField)
+ [Spigot 結構](#aws-glue-api-visual-job-api-Spigot)
+ [Join 結構](#aws-glue-api-visual-job-api-Join)
+ [JoinColumn 結構](#aws-glue-api-visual-job-api-JoinColumn)
+ [SplitFields 結構](#aws-glue-api-visual-job-api-SplitFields)
+ [SelectFromCollection 結構](#aws-glue-api-visual-job-api-SelectFromCollection)
+ [FillMissingValues 結構](#aws-glue-api-visual-job-api-FillMissingValues)
+ [Filter 結構](#aws-glue-api-visual-job-api-Filter)
+ [FilterExpression 結構](#aws-glue-api-visual-job-api-FilterExpression)
+ [FilterValue 結構](#aws-glue-api-visual-job-api-FilterValue)
+ [CustomCode 結構](#aws-glue-api-visual-job-api-CustomCode)
+ [SparkSQL 結構](#aws-glue-api-visual-job-api-SparkSQL)
+ [SqlAlias 結構](#aws-glue-api-visual-job-api-SqlAlias)
+ [DropNullFields 結構](#aws-glue-api-visual-job-api-DropNullFields)
+ [NullCheckBoxList 結構](#aws-glue-api-visual-job-api-NullCheckBoxList)
+ [NullValueField 結構](#aws-glue-api-visual-job-api-NullValueField)
+ [Datatype 結構](#aws-glue-api-visual-job-api-Datatype)
+ [Merge 結構](#aws-glue-api-visual-job-api-Merge)
+ [Union 結構](#aws-glue-api-visual-job-api-Union)
+ [PIIDetection 結構](#aws-glue-api-visual-job-api-PIIDetection)
+ [Aggregate 結構](#aws-glue-api-visual-job-api-Aggregate)
+ [DropDuplicates 結構](#aws-glue-api-visual-job-api-DropDuplicates)
+ [GovernedCatalogTarget 結構](#aws-glue-api-visual-job-api-GovernedCatalogTarget)
+ [GovernedCatalogSource 結構](#aws-glue-api-visual-job-api-GovernedCatalogSource)
+ [AggregateOperation 結構](#aws-glue-api-visual-job-api-AggregateOperation)
+ [GlueSchema 結構](#aws-glue-api-visual-job-api-GlueSchema)
+ [GlueStudioSchemaColumn 結構](#aws-glue-api-visual-job-api-GlueStudioSchemaColumn)
+ [GlueStudioColumn 結構](#aws-glue-api-visual-job-api-GlueStudioColumn)
+ [DynamicTransform 結構](#aws-glue-api-visual-job-api-DynamicTransform)
+ [TransformConfigParameter 結構](#aws-glue-api-visual-job-api-TransformConfigParameter)
+ [EvaluateDataQuality 結構](#aws-glue-api-visual-job-api-EvaluateDataQuality)
+ [DQResultsPublishingOptions 結構](#aws-glue-api-visual-job-api-DQResultsPublishingOptions)
+ [DQStopJobOnFailureOptions 結構](#aws-glue-api-visual-job-api-DQStopJobOnFailureOptions)
+ [EvaluateDataQualityMultiFrame 結構](#aws-glue-api-visual-job-api-EvaluateDataQualityMultiFrame)
+ [配方結構](#aws-glue-api-visual-job-api-Recipe)
+ [RecipeReference 結構](#aws-glue-api-visual-job-api-RecipeReference)
+ [SnowflakeNodeData 結構](#aws-glue-api-visual-job-api-SnowflakeNodeData)
+ [SnowflakeSource 結構](#aws-glue-api-visual-job-api-SnowflakeSource)
+ [SnowflakeTarget 結構](#aws-glue-api-visual-job-api-SnowflakeTarget)
+ [ConnectorDataSource 結構](#aws-glue-api-visual-job-api-ConnectorDataSource)
+ [ConnectorDataTarget 結構](#aws-glue-api-visual-job-api-ConnectorDataTarget)
+ [RecipeStep 結構](#aws-glue-api-visual-job-api-RecipeStep)
+ [RecipeAction 結構](#aws-glue-api-visual-job-api-RecipeAction)
+ [ConditionExpression 結構](#aws-glue-api-visual-job-api-ConditionExpression)
+ [S3CatalogIcebergSource 結構](#aws-glue-api-visual-job-api-S3CatalogIcebergSource)
+ [CatalogIcebergSource 結構](#aws-glue-api-visual-job-api-CatalogIcebergSource)
+ [S3IcebergCatalogTarget 結構](#aws-glue-api-visual-job-api-S3IcebergCatalogTarget)
+ [DynamoDBELTConnectorSource 結構](#aws-glue-api-visual-job-api-DynamoDBELTConnectorSource)
+ [DDBELTConnectionOptions 結構](#aws-glue-api-visual-job-api-DDBELTConnectionOptions)
+ [DDBELTCatalogAdditionalOptions 結構](#aws-glue-api-visual-job-api-DDBELTCatalogAdditionalOptions)
+ [路由結構](#aws-glue-api-visual-job-api-Route)
+ [GroupFilters 結構](#aws-glue-api-visual-job-api-GroupFilters)
+ [AutoDataQuality 結構](#aws-glue-api-visual-job-api-AutoDataQuality)
## CodeGenConfigurationNode 結構
`CodeGenConfigurationNode` 列舉所有有效的節點類型。僅可以填入一個成員變數。
**欄位**
+ `AthenaConnectorSource` – [AthenaConnectorSource](#aws-glue-api-visual-job-api-AthenaConnectorSource) 物件。
指定 Amazon Athena 資料來源的連接器。
+ `JDBCConnectorSource` – [JDBCConnectorSource](#aws-glue-api-visual-job-api-JDBCConnectorSource) 物件。
指定 JDBC 資料來源的連接器。
+ `SparkConnectorSource` – [SparkConnectorSource](#aws-glue-api-visual-job-api-SparkConnectorSource) 物件。
指定 Apache Spark 資料來源的連接器。
+ `CatalogSource` – [CatalogSource](#aws-glue-api-visual-job-api-CatalogSource) 物件。
指定 Data Catalog 中的 AWS Glue 資料存放區。
+ `RedshiftSource` – [RedshiftSource](#aws-glue-api-visual-job-api-RedshiftSource) 物件。
指定 Amazon Redshift 資料存放區。
+ `S3CatalogSource` – [S3CatalogSource](#aws-glue-api-visual-job-api-S3CatalogSource) 物件。
在 Data Catalog 中指定 Amazon S3 AWS Glue 資料存放區。
+ `S3CsvSource` – [S3CsvSource](#aws-glue-api-visual-job-api-S3CsvSource) 物件。
指定存放在 Amazon S3 中的命令分隔值 (CSV) 資料存放區。
+ `S3JsonSource` – [S3JsonSource](#aws-glue-api-visual-job-api-S3JsonSource) 物件。
指定儲存在 Amazon S3 中的 JSON 資料存放區。
+ `S3ParquetSource` – [S3ParquetSource](#aws-glue-api-visual-job-api-S3ParquetSource) 物件。
指定存放在 Amazon S3 中的 Apache Parquet 資料存放區。
+ `RelationalCatalogSource` – [RelationalCatalogSource](#aws-glue-api-visual-job-api-RelationalCatalogSource) 物件。
指定 AWS Glue Data Catalog 中的關聯式目錄資料存放區。
+ `DynamoDBCatalogSource` – [DynamoDBCatalogSource](#aws-glue-api-visual-job-api-DynamoDBCatalogSource) 物件。
指定 Data Catalog 中的 DynamoDBC Catalog AWS Glue 資料存放區。
+ `JDBCConnectorTarget` – [JDBCConnectorTarget](#aws-glue-api-visual-job-api-JDBCConnectorTarget) 物件。
指定以 Apache Parquet 直欄式儲存寫入 Amazon S3 的資料目標。
+ `SparkConnectorTarget` – [SparkConnectorTarget](#aws-glue-api-visual-job-api-SparkConnectorTarget) 物件。
指定使用 Apache Spark 連接器的目標。
+ `CatalogTarget` – [BasicCatalogTarget](#aws-glue-api-visual-job-api-BasicCatalogTarget) 物件。
指定使用 AWS Glue Data Catalog 資料表的目標。
+ `RedshiftTarget` – [RedshiftTarget](#aws-glue-api-visual-job-api-RedshiftTarget) 物件。
指定使用 Amazon Redshift 的目標。
+ `S3CatalogTarget` – [S3CatalogTarget](#aws-glue-api-visual-job-api-S3CatalogTarget) 物件。
指定使用 Data Catalog 寫入 Amazon S3 AWS Glue 的資料目標。
+ `S3GlueParquetTarget` – [S3GlueParquetTarget](#aws-glue-api-visual-job-api-S3GlueParquetTarget) 物件。
指定以 Apache Parquet 直欄式儲存寫入 Amazon S3 的資料目標。
+ `S3DirectTarget` – [S3DirectTarget](#aws-glue-api-visual-job-api-S3DirectTarget) 物件。
指定寫入 Amazon S3 的資料目標。
+ `ApplyMapping` – [ApplyMapping](#aws-glue-api-visual-job-api-ApplyMapping) 物件。
指定將資料來源中的資料屬性索引鍵映射至資料目標中資料屬性索引鍵的轉換。您可以重新命名索引鍵、修改索引鍵的資料類型，以及選擇要從資料集中捨棄哪些索引鍵。
+ `SelectFields` – [SelectFields](#aws-glue-api-visual-job-api-SelectFields) 物件。
指定選擇要保留之資料屬性索引鍵的轉換。
+ `DropFields` – [DropFields](#aws-glue-api-visual-job-api-DropFields) 物件。
指定選擇要捨棄之資料屬性索引鍵的轉換。
+ `RenameField` – [RenameField](#aws-glue-api-visual-job-api-RenameField) 物件。
指定重新命名單一資料屬性索引鍵的轉換。
+ `Spigot` – [Spigot](#aws-glue-api-visual-job-api-Spigot) 物件。
指定將資料範例寫入 Amazon S3 儲存貯體的轉換。
+ `Join` – [Join](#aws-glue-api-visual-job-api-Join) 物件。
使用指定資料屬性索引鍵上的比較片語，將兩個資料集聯結為一個資料集。可以使用內、外、左、右、左半、左反聯結。
+ `SplitFields` – [SplitFields](#aws-glue-api-visual-job-api-SplitFields) 物件。
指定將資料屬性索引鍵分割成兩個 `DynamicFrames` 的轉換。輸出是 `DynamicFrames` 的集合：一個具有所選資料屬性索引鍵，另一個具有其餘資料屬性索引鍵。
+ `SelectFromCollection` – [SelectFromCollection](#aws-glue-api-visual-job-api-SelectFromCollection) 物件。
指定從 `DynamicFrames` 的集合選擇一個 `DynamicFrame` 的轉換。輸出為所選的 `DynamicFrame`。
+ `FillMissingValues` – [FillMissingValues](#aws-glue-api-visual-job-api-FillMissingValues) 物件。
指定如下轉換：尋找遺失值之資料集中的記錄，並新增具有由插補決定值的新欄位。輸入資料集會用於訓練機器學習模型，以決定遺失值應該是什麼。
+ `Filter` – [Filter](#aws-glue-api-visual-job-api-Filter) 物件。
指定根據篩選條件將資料集分割成兩個的轉換。
+ `CustomCode` – [CustomCode](#aws-glue-api-visual-job-api-CustomCode) 物件。
指定使用您提供的自訂程式碼來執行資料轉換的轉換。輸出是 DynamicFrames 的集合。
+ `SparkSQL` – [SparkSQL](#aws-glue-api-visual-job-api-SparkSQL) 物件。
指定轉換，其中輸入使用 Spark SQL 語法的 SQL 查詢來轉換資料。輸出是單個 `DynamicFrame`。
+ `DirectKinesisSource` – [DirectKinesisSource](#aws-glue-api-visual-job-api-DirectKinesisSource) 物件。
指定直接的 Amazon Kinesis 資料來源。
+ `DirectKafkaSource` – [DirectKafkaSource](#aws-glue-api-visual-job-api-DirectKafkaSource) 物件。
指定 Apache Kafka 資料存放區。
+ `CatalogKinesisSource` – [CatalogKinesisSource](#aws-glue-api-visual-job-api-CatalogKinesisSource) 物件。
在 AWS Glue Data Catalog 中指定 Kinesis 資料來源。
+ `CatalogKafkaSource` – [CatalogKafkaSource](#aws-glue-api-visual-job-api-CatalogKafkaSource) 物件。
指定 Data Catalog 中的 Apache Kafka 資料存放區。
+ `DropNullFields` – [DropNullFields](#aws-glue-api-visual-job-api-DropNullFields) 物件。
指定轉換，如果資料行中的所有值都為「null」(空)，則從資料集中刪除此行。根據預設， AWS Glue Studio 會辨識 null 物件，但一些值，例如空字串、「null」字串、-1 整數或其他預留位置，例如零，則不會自動辨識為 null。
+ `Merge` – [Merge](#aws-glue-api-visual-job-api-Merge) 物件。
指定根據指定的主索引鍵來合併此 `DynamicFrame` 與暫存 `DynamicFrame` 以識別記錄的轉換。重複的記錄 (具有相同主索引鍵的記錄) 不會被刪除重複資料。
+ `Union` – [UNION](#aws-glue-api-visual-job-api-Union) 物件。
指定將兩個或多個資料集中的列合併為單一結果的轉換。
+ `PIIDetection` – [PIIDetection](#aws-glue-api-visual-job-api-PIIDetection) 物件。
指定用於標識、刪除或遮罩 PII 資料的轉換。
+ `Aggregate` – [Aggregate](#aws-glue-api-visual-job-api-Aggregate) 物件。
指定轉換，依照所選欄位來分組行，並依照指定函數計算彙總值。
+ `DropDuplicates` – [DropDuplicates](#aws-glue-api-visual-job-api-DropDuplicates) 物件。
指定用於從資料集刪除重複資料行的轉換。
+ `GovernedCatalogTarget` – [GovernedCatalogTarget](#aws-glue-api-visual-job-api-GovernedCatalogTarget) 物件。
指定資料目標寫入受管目錄。
+ `GovernedCatalogSource` – [GovernedCatalogSource](#aws-glue-api-visual-job-api-GovernedCatalogSource) 物件。
指定受管 Data Catalog 中的 資料來源。
+ `MicrosoftSQLServerCatalogSource` – [MicrosoftSQLServerCatalogSource](#aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogSource) 物件。
指定 AWS Glue Data Catalog 中的 Microsoft SQL 伺服器資料來源。
+ `MySQLCatalogSource` – [MySQLCatalogSource](#aws-glue-api-visual-job-api-MySQLCatalogSource) 物件。
在 AWS Glue Data Catalog 中指定 MySQL 資料來源。
+ `OracleSQLCatalogSource` – [OracleSQLCatalogSource](#aws-glue-api-visual-job-api-OracleSQLCatalogSource) 物件。
在 AWS Glue Data Catalog 中指定 Oracle 資料來源。
+ `PostgreSQLCatalogSource` – [PostgreSQLCatalogSource](#aws-glue-api-visual-job-api-PostgreSQLCatalogSource) 物件。
在 AWS Glue Data Catalog 中指定 PostgresSQL 資料來源。
+ `MicrosoftSQLServerCatalogTarget` – [MicrosoftSQLServerCatalogTarget](#aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogTarget) 物件。
指定使用 Microsoft SQL 的目標。
+ `MySQLCatalogTarget` – [MySQLCatalogTarget](#aws-glue-api-visual-job-api-MySQLCatalogTarget) 物件。
指定使用 MySQL 的目標。
+ `OracleSQLCatalogTarget` – [OracleSQLCatalogTarget](#aws-glue-api-visual-job-api-OracleSQLCatalogTarget) 物件。
指定使用 Oracle SQL 的目標。
+ `PostgreSQLCatalogTarget` – [PostgreSQLCatalogTarget](#aws-glue-api-visual-job-api-PostgreSQLCatalogTarget) 物件。
指定使用 Postgres SQL 的目標。
+ `Route` – [路由](#aws-glue-api-visual-job-api-Route) 物件。
指定路由節點，根據定義的篩選條件將資料導向不同的輸出路徑。
+ `DynamicTransform` – [DynamicTransform](#aws-glue-api-visual-job-api-DynamicTransform) 物件。
指定使用者建立的自訂視覺化轉換。
+ `EvaluateDataQuality` – [EvaluateDataQuality](#aws-glue-api-visual-job-api-EvaluateDataQuality) 物件。
指定資料品質評估標準。
+ `S3CatalogHudiSource` – [S3CatalogHudiSource](#aws-glue-api-visual-job-api-S3CatalogHudiSource) 物件。
指定在 AWS Glue Data Catalog 中註冊的 Hudi 資料來源。資料來源必須存放在其中 Amazon S3。
+ `CatalogHudiSource` – [CatalogHudiSource](#aws-glue-api-visual-job-api-CatalogHudiSource) 物件。
指定在 AWS Glue Data Catalog 中註冊的 Hudi 資料來源。
+ `S3HudiSource` – [S3HudiSource](#aws-glue-api-visual-job-api-S3HudiSource) 物件。
指定存放於 的 Hudi 資料來源 Amazon S3。
+ `S3HudiCatalogTarget` – [S3HudiCatalogTarget](#aws-glue-api-visual-job-api-S3HudiCatalogTarget) 物件。
指定在 AWS Glue Data Catalog 中寫入 Hudi 資料來源的目標。
+ `S3HudiDirectTarget` – [S3HudiDirectTarget](#aws-glue-api-visual-job-api-S3HudiDirectTarget) 物件。
指定寫入 Hudi 資料來源的目標 Amazon S3。
+ `S3CatalogDeltaSource` – [S3CatalogDeltaSource](#aws-glue-api-visual-job-api-S3CatalogDeltaSource) 物件。
指定在 AWS Glue Data Catalog 中註冊的 Delta Lake 資料來源。資料來源必須存放在其中 Amazon S3。
+ `CatalogDeltaSource` – [CatalogDeltaSource](#aws-glue-api-visual-job-api-CatalogDeltaSource) 物件。
指定在 AWS Glue Data Catalog 中註冊的 Delta Lake 資料來源。
+ `S3DeltaSource` – [S3DeltaSource](#aws-glue-api-visual-job-api-S3DeltaSource) 物件。
指定存放於 的 Delta Lake 資料來源 Amazon S3。
+ `S3DeltaCatalogTarget` – [S3DeltaCatalogTarget](#aws-glue-api-visual-job-api-S3DeltaCatalogTarget) 物件。
指定在 AWS Glue Data Catalog 中寫入 Delta Lake 資料來源的目標。
+ `S3DeltaDirectTarget` – [S3DeltaDirectTarget](#aws-glue-api-visual-job-api-S3DeltaDirectTarget) 物件。
指定寫入 Delta Lake 資料來源的目標 Amazon S3。
+ `AmazonRedshiftSource` – [AmazonRedshiftSource](#aws-glue-api-visual-job-api-AmazonRedshiftSource) 物件。
指定在 Amazon Redshift 中寫入資料來源的目標。
+ `AmazonRedshiftTarget` – [AmazonRedshiftTarget](#aws-glue-api-visual-job-api-AmazonRedshiftTarget) 物件。
指定在 Amazon Redshift 中寫入資料目標的目標。
+ `EvaluateDataQualityMultiFrame` – [EvaluateDataQualityMultiFrame](#aws-glue-api-visual-job-api-EvaluateDataQualityMultiFrame) 物件。
指定資料品質評估標準。允許多個輸入資料，並會傳回動態影格集合。
+ `Recipe` – [Recipe](#aws-glue-api-visual-job-api-Recipe) 物件。
指定 AWS Glue DataBrew 配方節點。
+ `SnowflakeSource` – [SnowflakeSource](#aws-glue-api-visual-job-api-SnowflakeSource) 物件。
指定 Snowflake 資料來源。
+ `SnowflakeTarget` – [SnowflakeTarget](#aws-glue-api-visual-job-api-SnowflakeTarget) 物件。
指定寫入 Snowflake 資料來源的目標。
+ `ConnectorDataSource` – [ConnectorDataSource](#aws-glue-api-visual-job-api-ConnectorDataSource) 物件。
指定使用標準連線選項產生的來源。
+ `ConnectorDataTarget` – [ConnectorDataTarget](#aws-glue-api-visual-job-api-ConnectorDataTarget) 物件。
指定使用標準連線選項產生的目標。
+ `S3CatalogIcebergSource` – [S3CatalogIcebergSource](#aws-glue-api-visual-job-api-S3CatalogIcebergSource) 物件。
指定在 AWS Glue Data Catalog 中註冊的 Apache Iceberg 資料來源。Iceberg 資料來源必須存放在其中 Amazon S3。
+ `CatalogIcebergSource` – [CatalogIcebergSource](#aws-glue-api-visual-job-api-CatalogIcebergSource) 物件。
指定在 AWS Glue Data Catalog 中註冊的 Apache Iceberg 資料來源。
+ `S3IcebergCatalogTarget` – [S3IcebergCatalogTarget](#aws-glue-api-visual-job-api-S3IcebergCatalogTarget) 物件。
指定 Apache Iceberg 目錄目標，將資料寫入 Amazon S3 資料並在 AWS Glue Data Catalog 中註冊資料表。
+ `S3IcebergDirectTarget` – [S3IcebergDirectTarget](#aws-glue-api-visual-job-api-S3IcebergDirectTarget) 物件。
定義將資料作為 Apache Iceberg 資料表寫入 Amazon S3 的組態參數。
+ `S3ExcelSource` – [S3ExcelSource](#aws-glue-api-visual-job-api-S3ExcelSource) 物件。
定義從 Amazon S3 讀取 Excel 檔案的組態參數。
+ `S3HyperDirectTarget` – [S3HyperDirectTarget](#aws-glue-api-visual-job-api-S3HyperDirectTarget) 物件。
定義使用 HyperDirect 最佳化將資料寫入 Amazon S3 的組態參數。
+ `DynamoDBELTConnectorSource` – [DynamoDBELTConnectorSource](#aws-glue-api-visual-job-api-DynamoDBELTConnectorSource) 物件。
指定用於從 DynamoDB 資料表擷取資料的 DynamoDB ELT 連接器來源。
## JDBCConnectorOptions 結構
連接器的其他連接選項。
**欄位**
+ `FilterPredicate` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
額外條件子句，用於篩選來源的資料。例如：
`BillingCity='Mountain View'`
當您使用查詢，而不是資料表名稱，您應該驗證查詢是否適用於指定的 `filterPredicate`。
+ `PartitionColumn` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
用於分割的整數資料行名稱。此選項僅適用於包含在 `lowerBound`、`upperBound` 以及 `numPartitions` 中。此選項的運作方式與 Spark SQL JDBC 讀取器相同。
+ `LowerBound` – 數字 (long)，不可大於 None (無)。
用來決定分割區步幅的 `partitionColumn` 最小值。
+ `UpperBound` – 數字 (long)，不可大於 None (無)。
用來決定分割區步幅的 `partitionColumn` 最大值。
+ `NumPartitions` – 數字 (long)，不可大於 None (無)。
分割區數。這個值，搭配 `lowerBound` (包含) 及 `upperBound` (不含)，形成用於分割 `partitionColumn` 而產生之 `WHERE` 子句表達式的分割區步幅。
+ `JobBookmarkKeys` – UTF-8 字串陣列。
用於排序之任務書籤索引鍵的名稱。
+ `JobBookmarkKeysSortOrder` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定升冪或降冪排序順序。
+ `DataTypeMapping` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串 (有效值：`ARRAY` \$1 `BIGINT` \$1 `BINARY` \$1 `BIT` \$1 `BLOB` \$1 `BOOLEAN` \$1 `CHAR` \$1 `CLOB` \$1 `DATALINK` \$1 `DATE` \$1 `DECIMAL` \$1 `DISTINCT` \$1 `DOUBLE` \$1 `FLOAT` \$1 `INTEGER` \$1 `JAVA_OBJECT` \$1 `LONGNVARCHAR` \$1 `LONGVARBINARY` \$1 `LONGVARCHAR` \$1 `NCHAR` \$1 `NCLOB` \$1 `NULL` \$1 `NUMERIC` \$1 `NVARCHAR` \$1 `OTHER` \$1 `REAL` \$1 `REF` \$1 `REF_CURSOR` \$1 `ROWID` \$1 `SMALLINT` \$1 `SQLXML` \$1 `STRUCT` \$1 `TIME` \$1 `TIME_WITH_TIMEZONE` \$1 `TIMESTAMP` \$1 `TIMESTAMP_WITH_TIMEZONE` \$1 `TINYINT` \$1 `VARBINARY` \$1 `VARCHAR`)。
每個值都是 UTF-8 字串 (有效值：`DATE` \$1 `STRING` \$1 `TIMESTAMP` \$1 `INT` \$1 `FLOAT` \$1 `LONG` \$1 `BIGDECIMAL` \$1 `BYTE` \$1 `SHORT` \$1 `DOUBLE` )。
自訂資料類型映射，用於建置從 JDBC 資料類型到 AWS Glue 資料類型的映射。例如， 選項會透過呼叫驅動程式的 `ResultSet.getString()`方法，將 JDBC 類型的資料欄位`"dataTypeMapping":{"FLOAT":"STRING"}`映射`FLOAT`至 Java `String`類型，並使用它來建置 AWS Glue 記錄。`ResultSet` 物件是由每個驅動程式實作，因此行為是特定於您使用的驅動程式。請參閱 JDBC 驅動程式的文件，瞭解驅動程式如何執行轉換。
## StreamingDataPreviewOptions 結構
指定與資料預覽相關的選項，以檢視資料範例。
**欄位**
+ `PollingTime` – 數字 (長)，至少為 10。
輪詢時間 (以毫秒為單位)。
+ `RecordPollingLimit` – 數字 (長)，至少為 1。
輪詢的記錄數上限。
## AthenaConnectorSource 結構
指定 Amazon Athena 資料來源的連接器。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料來源的名稱。
+ `ConnectionName` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
與連接器相關聯之連線的名稱。
+ `ConnectorName` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
連接器的名稱，可協助存取 AWS Glue Studio 中的資料存放區。
+ `ConnectionType` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
連線類型，例如 marketplace.athena 或 custom.athena，指定連線到 Amazon Athena 資料存放區。
+ `ConnectionTable` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
資料來源中的資料表名稱。
+ `SchemaName` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取的 CloudWatch 日誌群組名稱。例如 `/aws-glue/jobs/output`。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定自訂 Athena 來源的資料結構描述。
## JDBCConnectorSource 結構
指定 JDBC 資料來源的連接器。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料來源的名稱。
+ `ConnectionName` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
與連接器相關聯之連線的名稱。
+ `ConnectorName` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
連接器的名稱，可協助存取 AWS Glue Studio 中的資料存放區。
+ `ConnectionType` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
連線類型，例如 marketplace.jdbc 或 custom.jdbc，同時指定與 JDBC 資料存放區的連線。
+ `AdditionalOptions` – [JDBCConnectorOptions](#aws-glue-api-visual-job-api-JDBCConnectorOptions) 物件。
連接器的其他連接選項。
+ `ConnectionTable` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
資料來源中的資料表名稱。
+ `Query` – UTF-8 字串，需符合[Custom string pattern #62](aws-glue-api-common.md#regex_62)。
要從中取得資料的資料表或 SQL 查詢。您可以指定 `ConnectionTable` 或 `query`，但不能同時指定兩者。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定自訂 JDBC 來源的資料結構描述。
## SparkConnectorSource 結構
指定 Apache Spark 資料來源的連接器。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料來源的名稱。
+ `ConnectionName` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
與連接器相關聯之連線的名稱。
+ `ConnectorName` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
連接器的名稱，可協助存取 AWS Glue Studio 中的資料存放區。
+ `ConnectionType` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
連接的類型，如 marketplace.spark 或 custom.spark，指定 Apache Spark 資料存放區的連線。
+ `AdditionalOptions` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
連接器的其他連接選項。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定自訂 spark 來源的資料結構描述。
## CatalogSource 結構
指定 Data Catalog 中的 AWS Glue 資料存放區。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料存放區的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫中資料表的名稱。
+ `PartitionPredicate` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
滿足此述詞的分割區會被刪除。這些分割區中仍在保留期間內的檔案不會被刪除。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定目錄來源的資料結構描述。
## MySQLCatalogSource 結構
在 AWS Glue Data Catalog 中指定 MySQL 資料來源。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料來源的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫中資料表的名稱。
## PostgreSQLCatalogSource 結構
在 AWS Glue Data Catalog 中指定 PostgresSQL 資料來源。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料來源的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫中資料表的名稱。
## OracleSQLCatalogSource 結構
在 AWS Glue Data Catalog 中指定 Oracle 資料來源。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料來源的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫中資料表的名稱。
## MicrosoftSQLServerCatalogSource 結構
指定 AWS Glue Data Catalog 中的 Microsoft SQL 伺服器資料來源。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料來源的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫中資料表的名稱。
## CatalogKinesisSource 結構
在 AWS Glue Data Catalog 中指定 Kinesis 資料來源。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料來源的名稱。
+ `WindowSize` – 數字 (整數)，不可大於 None (無)。
處理每個微批次的時間量。
+ `DetectSchema` – 布林值。
是否自動從傳入資料確定結構描述。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫中資料表的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫的名稱。
+ `StreamingOptions` – [KinesisStreamingSourceOptions](#aws-glue-api-visual-job-api-KinesisStreamingSourceOptions) 物件。
Kinesis 串流資料來源的其他選項。
+ `DataPreviewOptions` – [StreamingDataPreviewOptions](#aws-glue-api-visual-job-api-StreamingDataPreviewOptions) 物件。
資料預覽的其他選項。
## DirectKinesisSource 結構
指定直接的 Amazon Kinesis 資料來源。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料來源的名稱。
+ `WindowSize` – 數字 (整數)，不可大於 None (無)。
處理每個微批次的時間量。
+ `DetectSchema` – 布林值。
是否自動從傳入資料確定結構描述。
+ `StreamingOptions` – [KinesisStreamingSourceOptions](#aws-glue-api-visual-job-api-KinesisStreamingSourceOptions) 物件。
Kinesis 串流資料來源的其他選項。
+ `DataPreviewOptions` – [StreamingDataPreviewOptions](#aws-glue-api-visual-job-api-StreamingDataPreviewOptions) 物件。
資料預覽的其他選項。
## KinesisStreamingSourceOptions 結構
Amazon Kinesis 串流資料來源的其他選項。
**欄位**
+ `EndpointUrl` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
Kinesis 端點的 URL。
+ `StreamName` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
Kinesis 資料串流的名稱。
+ `Classification` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
選擇性分類。
+ `Delimiter` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定分隔符號字元。
+ `StartingPosition` – UTF-8 字串 (有效值：`latest="LATEST"` \$1 `trim_horizon="TRIM_HORIZON"` \$1 `earliest="EARLIEST"` \$1 `timestamp="TIMESTAMP"`)。
Kinesis 資料串流中要從中讀取資料的起始位置。可能的值包括 `"latest"`、`"trim_horizon"`、`"earliest"` 或 `yyyy-mm-ddTHH:MM:SSZ` 模式中 UTC 格式的時間戳記字串 (其中 `Z` 代表以 \$1/- 表示的 UTC 時區偏移。例如："2023-04-04T08:00:00-04:00")。預設值為 `"latest"`。
注意：僅 4.0 AWS Glue 版或更新版本支援使用 "startingPosition" 的 UTC 格式時間戳記字串值。
+ `MaxFetchTimeInMs` – 數字 (long)，不可大於 None (無)。
任務執行器從 Kinesis 資料串流讀取目前批次記錄所花費的最長時間，以毫秒 (ms) 為單位指定。在此期間可以進行多次 `GetRecords` API 呼叫。預設值為 `1000`。
+ `MaxFetchRecordsPerShard` – 數字 (long)，不可大於 None (無)。
每個微批次的 Kinesis 資料串流中每個碎片要擷取的記錄數目上限。注意：如果串流任務已從 Kinesis 讀取額外的記錄 (在相同的 get-records 呼叫中)，用戶端可以超過此限制。如果 `MaxFetchRecordsPerShard` 需要嚴格控制，則其必須是 `MaxRecordPerRead` 的倍數。預設值為 `100000`。
+ `MaxRecordPerRead` – 數字 (long)，不可大於 None (無)。
要從每個 getRecords 操作的 Kinesis 資料串流中擷取的記錄數量上限。預設值為 `10000`。
+ `AddIdleTimeBetweenReads` – 布林值。
增加兩個連續 getRecords 操作之間的時間延遲。預設值為 `"False"`。此選項僅在 AWS Glue 2.0 及更高版本上才可設定。
+ `IdleTimeBetweenReadsInMs` – 數字 (long)，不可大於 None (無)。
連續兩個 getRecords 操作之間的最小延遲時間，以毫秒為單位指定。預設值為 `1000`。此選項僅適用於 2.0 版及更新 AWS Glue 版本。
+ `DescribeShardInterval` – 數字 (long)，不可大於 None (無)。
指令碼考慮重新分片之兩個 ListShards API 呼叫之間的最小時間間隔。預設值為 `1s`。
+ `NumRetries` – 數字 (整數)，不可大於 None (無)。
Kinesis Data Streams API 請求的重試數上限。預設值為 `3`。
+ `RetryIntervalMs` – 數字 (long)，不可大於 None (無)。
重試 Kinesis Data Streams API 呼叫之前的冷卻時間期間 (以毫秒為單位)。預設值為 `1000`。
+ `MaxRetryIntervalMs` – 數字 (long)，不可大於 None (無)。
Kinesis Data Streams API 呼叫之兩次重試之間的最大冷卻時間期間 (以毫秒為單位)。預設值為 `10000`。
+ `AvoidEmptyBatches` – 布林值。
避免建立空白微批次任務，方法是在批次開始之前檢查 Kinesis 資料串流中是否有未讀取的資料。預設值為 `"False"`。
+ `StreamArn` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
Kinesis 資料串流的 Amazon Resource Name (ARN)。
+ `RoleArn` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
使用 AWS Security Token Service (AWS STS) 擔任之角色的 Amazon Resource Name (ARN)。此角色必須具有描述或讀取 Kinesis 資料串流記錄操作的許可。存取不同帳戶中的資料串流時，您必須使用此參數。搭配 `"awsSTSSessionName"` 使用。
+ `RoleSessionName` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
使用 AWS STS 擔任角色之工作階段的識別符。存取不同帳戶中的資料串流時，您必須使用此參數。搭配 `"awsSTSRoleARN"` 使用。
+ `AddRecordTimestamp` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
當此選項設定為 'true' 時，資料輸出將包含一個名為 "\$1\$1src\$1timestamp" 的額外資料欄，其指示串流收到相應記錄的時間。預設值為 'false'。4.0 AWS Glue 版或更新版本支援此選項。
+ `EmitConsumerLagMetrics` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
當此選項設定為 'true' 時，每個批次都會在串流接收的最舊記錄到送達 AWS Glue CloudWatch 的時間之間發出指標。指標的名稱為 "glue.driver.streaming.maxConsumerLagInMs"。預設值為 'false'。在 AWS Glue 4.0 版或更新版中支援此選項。
+ `StartingTimestamp` – UTF-8 字串。
Kinesis 資料串流中開始讀取資料之記錄的時間戳記。可能的值是 `yyyy-mm-ddTHH:MM:SSZ` 模式的 UTC 格式的時間戳記字串 (其中 Z 代表以 \$1/- 表示的 UTC 時區偏移。例如："2023-04-04T08:00:00\$108:00")。
+ `FanoutConsumerARN` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
Kinesis Data Streams 增強型展開傳送消費者的 Amazon Resource Name (ARN)。指定時，會針對專用輸送量啟用增強型展開傳送，並降低延遲資料取用。
## CatalogKafkaSource 結構
指定 Data Catalog 中的 Apache Kafka 資料存放區。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料存放區的名稱。
+ `WindowSize` – 數字 (整數)，不可大於 None (無)。
處理每個微批次的時間量。
+ `DetectSchema` – 布林值。
是否自動從傳入資料確定結構描述。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫中資料表的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫的名稱。
+ `StreamingOptions` – [KafkaStreamingSourceOptions](#aws-glue-api-visual-job-api-KafkaStreamingSourceOptions) 物件。
指定串流選項。
+ `DataPreviewOptions` – [StreamingDataPreviewOptions](#aws-glue-api-visual-job-api-StreamingDataPreviewOptions) 物件。
指定與資料預覽相關的選項，以檢視資料範例。
## DirectKafkaSource 結構
指定 Apache Kafka 資料存放區。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料存放區的名稱。
+ `StreamingOptions` – [KafkaStreamingSourceOptions](#aws-glue-api-visual-job-api-KafkaStreamingSourceOptions) 物件。
指定串流選項。
+ `WindowSize` – 數字 (整數)，不可大於 None (無)。
處理每個微批次的時間量。
+ `DetectSchema` – 布林值。
是否自動從傳入資料確定結構描述。
+ `DataPreviewOptions` – [StreamingDataPreviewOptions](#aws-glue-api-visual-job-api-StreamingDataPreviewOptions) 物件。
指定與資料預覽相關的選項，以檢視資料範例。
## KafkaStreamingSourceOptions 結構
其他串流選項。
**欄位**
+ `BootstrapServers` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
自舉伺服器 URL 的清單，例如 `b-1.vpc-test-2.o4q88o.c6.kafka.us-east-1.amazonaws.com:9094`。此選項必須在 API 呼叫中指定，或在 Data Catalog 的資料表中繼資料中定義。
+ `SecurityProtocol` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
用來與代理程式通訊的協定。可能的值為 `"SSL"` 或 `"PLAINTEXT"`。
+ `ConnectionName` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
連線的名稱。
+ `TopicName` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
在 Apache Kafka 中指定的主題名稱。您必須指定至少 1 個 `"topicName"`、`"assign"` 或 `"subscribePattern"`。
+ `Assign` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要取用的特定 `TopicPartitions`。您必須指定至少 1 個 `"topicName"`、`"assign"` 或 `"subscribePattern"`。
+ `SubscribePattern` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
識別要訂閱的主題清單的 Java regex 字串。您必須指定至少 1 個 `"topicName"`、`"assign"` 或 `"subscribePattern"`。
+ `Classification` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
選擇性分類。
+ `Delimiter` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定分隔符號字元。
+ `StartingOffsets` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要從中讀取資料的 Kafka 主題的起始位置。可能的值為 `"earliest"` 或 `"latest"`。預設值為 `"latest"`。
+ `EndingOffsets` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
批次查詢結束時的終點。可能值為 `"latest"` 或指定每個 `TopicPartition` 結束偏移的 JSON 字串。
+ `PollTimeoutMs` – 數字 (long)，不可大於 None (無)。
在 Spark 任務執行器中從 Kafka 輪詢資料的逾時 (以毫秒為單位)。預設值為 `512`。
+ `NumRetries` – 數字 (整數)，不可大於 None (無)。
擷取 Kafka 位移失敗之前，要重試的次數。預設值為 `3`。
+ `RetryIntervalMs` – 數字 (long)，不可大於 None (無)。
重試擷取 Kafka 偏移量之前等待的時間 (毫秒)。預設值為 `10`。
+ `MaxOffsetsPerTrigger` – 數字 (long)，不可大於 None (無)。
每個觸發程序間隔所處理之偏移數目上限的速率限制。指定的偏移總數會按比例跨 `topicPartitions` 或不同磁碟區而分割。預設值為 null，這表示消費者讀取所有偏移，直到已知的最新偏移。
+ `MinPartitions` – 數字 (整數)，不可大於 None (無)。
從 Kafka 讀取所需的分割區最小數量。預設值為 null，這表示 Spark 分割區的數量等於 Kafka 分割區的數量。
+ `IncludeHeaders` – 布林值。
是否包括 Kafka 標頭。當選項設定為「true」時，資料輸出將包含一個名為「glue\$1streaming\$1kafka\$1headers」的額外欄，其類型為 `Array[Struct(key: String, value: String)]`。預設值為 "false"。此選項僅適用於 3.0 AWS Glue 版或更新版本。
+ `AddRecordTimestamp` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
當此選項設定為 'true' 時，資料輸出將包含一個名為 "\$1\$1src\$1timestamp" 的額外資料欄，其指示主題收到相應記錄的時間。預設值為 'false'。4.0 AWS Glue 版或更新版本支援此選項。
+ `EmitConsumerLagMetrics` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
當此選項設定為「true」時，每個批次都會在主題接收的最舊記錄到送達 AWS Glue CloudWatch 的時間之間發出指標。指標的名稱為 "glue.driver.streaming.maxConsumerLagInMs"。預設值為 'false'。在 AWS Glue 4.0 版或更新版中支援此選項。
+ `StartingTimestamp` – UTF-8 字串。
Kafka 主題中開始讀取資料之記錄的時間戳記。可能的值是 `yyyy-mm-ddTHH:MM:SSZ` 模式的 UTC 格式的時間戳記字串 (其中 Z 代表以 \$1/- 表示的 UTC 時區偏移。例如："2023-04-04T08:00:00\$108:00")。
只能設定 `StartingTimestamp` 或 `StartingOffsets`。
## RedshiftSource 結構
指定 Amazon Redshift 資料存放區。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
Amazon Redshift 資料存放區的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取的資料庫。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取的資料庫資料表。
+ `RedshiftTmpDir` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
從資料庫複製時，可用來暫存臨時資料的 Amazon S3 路徑。
+ `TmpDirIAMRole` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
具有許可的 IAM 角色。
## AmazonRedshiftSource 結構
指定 Amazon Redshift 來源。
**欄位**
+ `Name` – UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
Amazon Redshift 來源的名稱。
+ `Data` – [AmazonRedshiftNodeData](#aws-glue-api-visual-job-api-AmazonRedshiftNodeData) 物件。
指定 Amazon Reshift 來源節點的資料。
## AmazonRedshiftNodeData 結構
指定 Amazon Redshift 節點。
**欄位**
+ `AccessType` – UTF-8 字串，需符合[Custom string pattern #60](aws-glue-api-common.md#regex_60)。
Redshift 連線的存取類型。可以是直接連線或目錄連線。
+ `SourceType` – UTF-8 字串，需符合[Custom string pattern #60](aws-glue-api-common.md#regex_60)。
用來指定特定資料表是來源還是自訂查詢的來源類型。
+ `Connection` – [選項](#aws-glue-api-visual-job-api-Option) 物件。
Redshift 叢集的 AWS Glue 連線。
+ `Schema` – [選項](#aws-glue-api-visual-job-api-Option) 物件。
使用直接連線時的 Redshift 結構描述名稱。
+ `Table` – [選項](#aws-glue-api-visual-job-api-Option) 物件。
使用直接連線時的 Redshift 資料表名稱。
+ `CatalogDatabase` – [選項](#aws-glue-api-visual-job-api-Option) 物件。
使用 AWS Glue 資料目錄時 Data Catalog 資料庫的名稱。
+ `CatalogTable` – [選項](#aws-glue-api-visual-job-api-Option) 物件。
使用 AWS Glue 資料目錄時的資料目錄資料表名稱。
+ `CatalogRedshiftSchema` – UTF-8 字串。
使用資料目錄時的 Redshift 結構描述名稱。
+ `CatalogRedshiftTable` – UTF-8 字串。
要讀取的資料庫資料表。
+ `TempDir` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
從資料庫複製時，可用來暫存臨時資料的 Amazon S3 路徑。
+ `IamRole` – [選項](#aws-glue-api-visual-job-api-Option) 物件。
選用。連線到 S3 時使用的角色名稱。當保留空白時，IAM 角色預設為任務上的角色。
+ `AdvancedOptions` – 一個 [AmazonRedshiftAdvancedOption](#aws-glue-api-visual-job-api-AmazonRedshiftAdvancedOption) 物件陣列。
連線至 Redshift 叢集時的選用值。
+ `SampleQuery` – UTF-8 字串。
當 SourceType 為「查詢」時，用於從 Redshift 來源擷取資料的 SQL。
+ `PreAction` – UTF-8 字串。
執行帶有 upsert 的 MERGE 或 APPEND 之前使用的 SQL。
+ `PostAction` – UTF-8 字串。
執行帶有 upsert 的 MERGE 或 APPEND 之前使用的 SQL。
+ `Action` – UTF-8 字串。
指定寫入 Redshift 叢集的方式。
+ `TablePrefix` – UTF-8 字串，需符合[Custom string pattern #60](aws-glue-api-common.md#regex_60)。
指定資料表的字首。
+ `Upsert` – 布林值。
執行 APPEND 時，對 Redshift 接收器使用的動作。
+ `MergeAction` – UTF-8 字串，需符合[Custom string pattern #60](aws-glue-api-common.md#regex_60)。
確定如何處理 Redshift 接收器中的 MERGE 時使用的動作。
+ `MergeWhenMatched` – UTF-8 字串，需符合[Custom string pattern #60](aws-glue-api-common.md#regex_60)。
當現有記錄與新記錄相符時，確定如何處理 Redshift 接收器中的 MERGE 時使用的動作。
+ `MergeWhenNotMatched` – UTF-8 字串，需符合[Custom string pattern #60](aws-glue-api-common.md#regex_60)。
當現有記錄與新記錄不符時，確定如何處理 Redshift 接收器中的 MERGE 時使用的動作。
+ `MergeClause` – UTF-8 字串。
在自訂合併中用於處理相符記錄的 SQL。
+ `CrawlerConnection` – UTF-8 字串。
指定與所用目錄資料表相關聯的連線名稱。
+ `TableSchema` – 一個 [選項](#aws-glue-api-visual-job-api-Option) 物件陣列。
指定節點的結構描述輸出陣列。
+ `StagingTable` – UTF-8 字串。
執行帶有 upsert 的 MERGE 或 APPEND 時使用的臨時暫存資料表名稱。
+ `SelectedColumns` – 一個 [選項](#aws-glue-api-visual-job-api-Option) 物件陣列。
當執行帶有 upsert 的 MERGE 或 APPEND 時，用於確定相符記錄的資料欄名稱清單。
## AmazonRedshiftAdvancedOption 結構
連線至 Redshift 叢集時指定選用值。
**欄位**
+ `Key` – UTF-8 字串。
其他連線選項的金鑰。
+ `Value` – UTF-8 字串。
其他連線選項的值。
## 選項結構
指定選項值。
**欄位**
+ `Value` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定選項的值。
+ `Label` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定選項的標籤。
+ `Description` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定選項的描述。
## S3CatalogSource 結構
在 Data Catalog 中指定 Amazon S3 AWS Glue 資料存放區。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料存放區的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取的資料庫。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取的資料庫資料表。
+ `PartitionPredicate` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
滿足此述詞的分割區會被刪除。這些分割區中仍在保留期間內的檔案不會被刪除。設定為 `""` – 預設為空值。
+ `AdditionalOptions` – [S3SourceAdditionalOptions](#aws-glue-api-visual-job-api-S3SourceAdditionalOptions) 物件。
指定其他連接選項。
## S3SourceAdditionalOptions 結構
指定 Amazon S3 資料存放區的其他連線選項。
**欄位**
+ `BoundedSize` – 數字 (long)。
設定要處理之資料集的目標大小上限 (以位元組為單位)。
+ `BoundedFiles` – 數字 (long)。
設定要處理的檔案目標數目的上限。
## S3CsvSource 結構
指定存放在 Amazon S3 中的命令分隔值 (CSV) 資料存放區。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料存放區的名稱。
+ `Paths` – *必要：*UTF-8 字串陣列。
要讀取的 Amazon S3 路徑清單。
+ `CompressionType` – UTF-8 字串 (有效值：`gzip="GZIP"` \$1 `bzip2="BZIP2"`)。
指定資料的壓縮方式。一般來說，如果資料具有標準副檔名，則不需要此項目。可能值為 `"gzip"` 和 `"bzip"`。
+ `Exclusions` – UTF-8 字串陣列。
包含要排除之 Unix 樣式 glob 模式 JSON 清單的字串。例如，"[\$1"\$1\$1.pdf\$1"]" 會排除所有 PDF 檔案。
+ `GroupSize` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
目標群組大小 (以位元組為單位)。系統會根據輸入資料大小和叢集大小來計算預設值。當輸入檔案數少於 50,000 個時，`"groupFiles"` 必須設定為 `"inPartition"` 才能讓此設定生效。
+ `GroupFiles` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
當輸入含有超過 50,000 個檔案時，預設會開啟分組檔案。若要在少於 50,000 個檔案時開啟分組，請將此參數設定為 "inPartition"。若要在超過 50,000 個檔案時停用分組，請將此參數設定為 `"none"`。
+ `Recurse` – 布林值。
如果設定為 True，則會遞迴讀取指定路徑下所有子目錄中的檔案。
+ `MaxBand` – 數字 (整數)，不可大於 None (無)。
此選項可控制 s3 清單可能會在多長時間 (以毫秒為單位) 後變得一致。使用 JobBookmarks 來考量 Amazon S3 最終一致性時，會特別追蹤修改時間戳記落在最後 maxBand 毫秒內的檔案。使用者大多不需要設定此選項。預設值為 900000 毫秒或 15 分鐘。
+ `MaxFilesInBand` – 數字 (整數)，不可大於 None (無)。
此選項會指定從最後 maxBand 秒內所要儲存的檔案數上限。如果超過此數量，系統就會略過額外的檔案，等下一個任務執行到來再處理。
+ `AdditionalOptions` – [S3DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions) 物件。
指定其他連接選項。
+ `Separator` – *必要*：UTF-8 字串 (有效值：`comma="COMMA"` \$1 `ctrla="CTRLA"` \$1 `pipe="PIPE"` \$1 `semicolon="SEMICOLON"` \$1 `tab="TAB"`)。
指定分隔符號字元。預設值為逗號：","，但您仍可指定任何其他字元。
+ `Escaper` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定用於逸出的字元。只有在讀取 CSV 檔案時，才會使用此選項。預設值為 `none`。若啟用，後面緊接的字元會維持現狀，除了一小組眾所皆知的逸出字元 (`\n`、`\r`、`\t` 與 `\0`) 以外。
+ `QuoteChar` – *必要：*UTF-8 字串 (有效值：`quote="QUOTE"` \$1 `quillemet="QUILLEMET"` \$1 `single_quote="SINGLE_QUOTE"` \$1 `disabled="DISABLED"`)。
指定用於引用的字元。預設為雙引號：`'"'`。將之設為 `-1` 可完全關閉引用功能。
+ `Multiline` – 布林值。
布林值，用以指定單項記錄是否可以跨越多行。當欄位內含引用的新行字元時，可能就會發生這種情況。若有任何記錄跨越多行，請務必將此選項設為 True。預設值為 `False`，如此在剖析時會更加積極地分割檔案。
+ `WithHeader` – 布林值。
布林值，指定是否要將第一行做為標頭。預設值為 `False`。
+ `WriteHeader` – 布林值。
布林值，指定是否要將標頭寫入輸入之中。預設值為 `True`。
+ `SkipFirst` – 布林值。
布林值，指定是否要略過第一個資料行。預設值為 `False`。
+ `OptimizePerformance` – 布林值。
指定是否要使用進階 SIMD CSV 讀取器，以及 Apache Arrow 為基礎的直欄式記憶體格式。僅適用於 3.0 AWS Glue 版。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定自訂 S3 CSV 來源的資料結構描述。
## DirectJDBCSource 結構
指定直接 JDBC 來源連線。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
JDBC 來源連線的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
JDBC 來源連線的資料庫。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
JDBC 來源連線的資料表。
+ `ConnectionName` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
JDBC 來源的連線名稱。
+ `ConnectionType` – *必要*：UTF-8 字串 (有效值：`sqlserver` \$1 `mysql` \$1 `oracle` \$1 `postgresql` \$1 `redshift`)。
JDBC 來源的連線類型。
+ `RedshiftTmpDir` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
JDBC Redshift 來源的暫存目錄。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定直接 JDBC 來源的資料結構描述。
## S3DirectSourceAdditionalOptions 結構
指定 Amazon S3 資料存放區的其他連線選項。
**欄位**
+ `BoundedSize` – 數字 (long)。
設定要處理之資料集的目標大小上限 (以位元組為單位)。
+ `BoundedFiles` – 數字 (long)。
設定要處理的檔案目標數目的上限。
+ `EnableSamplePath` – 布林值。
設定選項啟用範例路徑。
+ `SamplePath` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
如果啟用，則會指定範例路徑。
## S3JsonSource 結構
指定儲存在 Amazon S3 中的 JSON 資料存放區。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料存放區的名稱。
+ `Paths` – *必要：*UTF-8 字串陣列。
要讀取的 Amazon S3 路徑清單。
+ `CompressionType` – UTF-8 字串 (有效值：`gzip="GZIP"` \$1 `bzip2="BZIP2"`)。
指定資料的壓縮方式。一般來說，如果資料具有標準副檔名，則不需要此項目。可能值為 `"gzip"` 和 `"bzip"`。
+ `Exclusions` – UTF-8 字串陣列。
包含要排除之 Unix 樣式 glob 模式 JSON 清單的字串。例如，"[\$1"\$1\$1.pdf\$1"]" 會排除所有 PDF 檔案。
+ `GroupSize` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
目標群組大小 (以位元組為單位)。系統會根據輸入資料大小和叢集大小來計算預設值。當輸入檔案數少於 50,000 個時，`"groupFiles"` 必須設定為 `"inPartition"` 才能讓此設定生效。
+ `GroupFiles` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
當輸入含有超過 50,000 個檔案時，預設會開啟分組檔案。若要在少於 50,000 個檔案時開啟分組，請將此參數設定為 "inPartition"。若要在超過 50,000 個檔案時停用分組，請將此參數設定為 `"none"`。
+ `Recurse` – 布林值。
如果設定為 True，則會遞迴讀取指定路徑下所有子目錄中的檔案。
+ `MaxBand` – 數字 (整數)，不可大於 None (無)。
此選項可控制 s3 清單可能會在多長時間 (以毫秒為單位) 後變得一致。使用 JobBookmarks 來考量 Amazon S3 最終一致性時，會特別追蹤修改時間戳記落在最後 maxBand 毫秒內的檔案。使用者大多不需要設定此選項。預設值為 900000 毫秒或 15 分鐘。
+ `MaxFilesInBand` – 數字 (整數)，不可大於 None (無)。
此選項會指定從最後 maxBand 秒內所要儲存的檔案數上限。如果超過此數量，系統就會略過額外的檔案，等下一個任務執行到來再處理。
+ `AdditionalOptions` – [S3DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions) 物件。
指定其他連接選項。
+ `JsonPath` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
定義 JSON 資料的 JsonPath 字串。
+ `Multiline` – 布林值。
布林值，用以指定單項記錄是否可以跨越多行。當欄位內含引用的新行字元時，可能就會發生這種情況。若有任何記錄跨越多行，請務必將此選項設為 True。預設值為 `False`，如此在剖析時會更加積極地分割檔案。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定自訂 S3 JSON 來源的資料結構描述。
## S3ParquetSource 結構
指定存放在 Amazon S3 中的 Apache Parquet 資料存放區。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料存放區的名稱。
+ `Paths` – *必要：*UTF-8 字串陣列。
要讀取的 Amazon S3 路徑清單。
+ `CompressionType` – UTF-8 字串 (有效值：`snappy="SNAPPY"` \$1 `lzo="LZO"` \$1 `gzip="GZIP"` \$1 `brotli="BROTLI"` \$1 `lz4="LZ4"` \$1 `uncompressed="UNCOMPRESSED"` \$1 `none="NONE"`)。
指定資料的壓縮方式。一般來說，如果資料具有標準副檔名，則不需要此項目。可能值為 `"gzip"` 和 `"bzip"`。
+ `Exclusions` – UTF-8 字串陣列。
包含要排除之 Unix 樣式 glob 模式 JSON 清單的字串。例如，"[\$1"\$1\$1.pdf\$1"]" 會排除所有 PDF 檔案。
+ `GroupSize` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
目標群組大小 (以位元組為單位)。系統會根據輸入資料大小和叢集大小來計算預設值。當輸入檔案數少於 50,000 個時，`"groupFiles"` 必須設定為 `"inPartition"` 才能讓此設定生效。
+ `GroupFiles` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
當輸入含有超過 50,000 個檔案時，預設會開啟分組檔案。若要在少於 50,000 個檔案時開啟分組，請將此參數設定為 "inPartition"。若要在超過 50,000 個檔案時停用分組，請將此參數設定為 `"none"`。
+ `Recurse` – 布林值。
如果設定為 True，則會遞迴讀取指定路徑下所有子目錄中的檔案。
+ `MaxBand` – 數字 (整數)，不可大於 None (無)。
此選項可控制 s3 清單可能會在多長時間 (以毫秒為單位) 後變得一致。使用 JobBookmarks 來考量 Amazon S3 最終一致性時，會特別追蹤修改時間戳記落在最後 maxBand 毫秒內的檔案。使用者大多不需要設定此選項。預設值為 900000 毫秒或 15 分鐘。
+ `MaxFilesInBand` – 數字 (整數)，不可大於 None (無)。
此選項會指定從最後 maxBand 秒內所要儲存的檔案數上限。如果超過此數量，系統就會略過額外的檔案，等下一個任務執行到來再處理。
+ `AdditionalOptions` – [S3DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions) 物件。
指定其他連接選項。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定自訂 S3 Parquet 來源的資料結構描述。
## S3DeltaSource 結構
指定存放於 的 Delta Lake 資料來源 Amazon S3。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
Delta Lake 來源的名稱。
+ `Paths` – *必要：*UTF-8 字串陣列。
要讀取的 Amazon S3 路徑清單。
+ `AdditionalDeltaOptions` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定其他連接選項。
+ `AdditionalOptions` – [S3DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions) 物件。
指定連接器的其他選項。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定 Delta Lake 來源的資料結構描述。
## S3CatalogDeltaSource 結構
指定在 AWS Glue Data Catalog 中註冊的 Delta Lake 資料來源。資料來源必須存放在其中 Amazon S3。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
Delta Lake 資料來源的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫中資料表的名稱。
+ `AdditionalDeltaOptions` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定其他連接選項。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定 Delta Lake 來源的資料結構描述。
## CatalogDeltaSource 結構
指定在 AWS Glue Data Catalog 中註冊的 Delta Lake 資料來源。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
Delta Lake 資料來源的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫中資料表的名稱。
+ `AdditionalDeltaOptions` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定其他連接選項。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定 Delta Lake 來源的資料結構描述。
## S3HudiSource 結構
指定存放於 的 Hudi 資料來源 Amazon S3。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
Hudi 來源的名稱。
+ `Paths` – *必要：*UTF-8 字串陣列。
要讀取的 Amazon S3 路徑清單。
+ `AdditionalHudiOptions` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定其他連接選項。
+ `AdditionalOptions` – [S3DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions) 物件。
指定連接器的其他選項。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定 Hudi 來源的資料結構描述。
## S3CatalogHudiSource 結構
指定在 AWS Glue Data Catalog 中註冊的 Hudi 資料來源。Hudi 資料來源必須存放在其中 Amazon S3。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
Hudi 資料來源的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫中資料表的名稱。
+ `AdditionalHudiOptions` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定其他連接選項。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定 Hudi 來源的資料結構描述。
## S3ExcelSource 結構
指定 S3 Excel 資料來源。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
S3 Excel 資料來源的名稱。
+ `Paths` – *必要：*UTF-8 字串陣列。
Excel 檔案所在的 S3 路徑。
+ `CompressionType` – UTF-8 字串 (有效值：`snappy="SNAPPY"` \$1 `lzo="LZO"` \$1 `gzip="GZIP"` \$1 `brotli="BROTLI"` \$1 `lz4="LZ4"` \$1 `uncompressed="UNCOMPRESSED"` \$1 `none="NONE"`)。
用於 Excel 檔案的壓縮格式。
+ `Exclusions` – UTF-8 字串陣列。
從處理中排除特定檔案或路徑的模式。
+ `GroupSize` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
定義用於批次處理的檔案群組大小。
+ `GroupFiles` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定應如何分組檔案以進行處理。
+ `Recurse` – 布林值。
指示是否以遞迴方式處理子型錄。
+ `MaxBand` – 數字 (整數)，不可大於 None (無)。
要使用的處理頻段數目上限。
+ `MaxFilesInBand` – 數字 (整數)，不可大於 None (無)。
每個頻段中要處理的檔案數目上限。
+ `AdditionalOptions` – [S3DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions) 物件。
S3 直接來源處理的其他組態選項。
+ `NumberRows` – 數字 (long)。
從每個 Excel 檔案處理的資料列數。
+ `SkipFooter` – 數字 (整數)，不可大於 None (無)。
每個 Excel 檔案結尾要略過的資料列數。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
要套用至已處理資料的 AWS Glue 結構描述。
## CatalogHudiSource 結構
指定在 AWS Glue Data Catalog 中註冊的 Hudi 資料來源。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
Hudi 資料來源的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫中資料表的名稱。
+ `AdditionalHudiOptions` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定其他連接選項。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定 Hudi 來源的資料結構描述。
## DynamoDBCatalogSource 結構
在 AWS Glue Data Catalog 中指定 DynamoDB 資料來源。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料來源的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫中資料表的名稱。
+ `PitrEnabled` – 布林值。
指定是否為 DynamoDB 資料表啟用時間點復原 (PITR)。設定為 `true` 時，允許從特定時間點讀取。預設值為 `false`。
+ `AdditionalOptions` – [DDBELTCatalogAdditionalOptions](#aws-glue-api-visual-job-api-DDBELTCatalogAdditionalOptions) 物件。
指定 DynamoDB 資料來源的其他連線選項。
## RelationalCatalogSource 結構
指定 AWS Glue Data Catalog 中的關聯式資料庫資料來源。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料來源的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫中資料表的名稱。
## JDBCConnectorTarget 結構
指定以 Apache Parquet 直欄式儲存寫入 Amazon S3 的資料目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料目標的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
輸入到資料目標的節點。
+ `ConnectionName` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
與連接器相關聯之連線的名稱。
+ `ConnectionTable` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
資料目標中的資料表名稱。
+ `ConnectorName` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
將要使用的連接器名稱。
+ `ConnectionType` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
連線類型，例如 marketplace.jdbc 或 custom.jdbc，指定與 JDBC 資料目標的連線。
+ `AdditionalOptions` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
連接器的其他連接選項。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定 JDBC 目標的資料結構描述。
## SparkConnectorTarget 結構
指定使用 Apache Spark 連接器的目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料目標的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
輸入到資料目標的節點。
+ `ConnectionName` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
Apache Spark 連接器的連線名稱。
+ `ConnectorName` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
Apache Spark 連接器的名稱。
+ `ConnectionType` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
連接的類型，如 marketplace.spark 或 custom.spark，指定 Apache Spark 資料存放區的連線。
+ `AdditionalOptions` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
連接器的其他連接選項。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定自訂 spark 目標的資料結構描述。
## BasicCatalogTarget 結構
指定使用 AWS Glue Data Catalog 資料表的目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料目標的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
輸入到資料目標的節點。
+ `PartitionKeys` – UTF-8 字串陣列。
分區索引鍵，用於根據特定索引鍵或一組索引鍵，將資料分散到多個分區或碎片。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
從清單中選擇包含要用作目標之資料表的資料庫。此資料庫必須存在於 Data Catalog 中。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
定義輸出資料結構描述的資料表。此資料表必須已存在於 Data Catalog 中。
## MySQLCatalogTarget 結構
指定使用 MySQL 的目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料目標的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
輸入到資料目標的節點。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫中資料表的名稱。
## PostgreSQLCatalogTarget 結構
指定使用 Postgres SQL 的目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料目標的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
輸入到資料目標的節點。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫中資料表的名稱。
## OracleSQLCatalogTarget 結構
指定使用 Oracle SQL 的目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料目標的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
輸入到資料目標的節點。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫中資料表的名稱。
## MicrosoftSQLServerCatalogTarget 結構
指定使用 Microsoft SQL 的目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料目標的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
輸入到資料目標的節點。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫中資料表的名稱。
## RedshiftTarget 結構
指定使用 Amazon Redshift 的目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料目標的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
輸入到資料目標的節點。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫中資料表的名稱。
+ `RedshiftTmpDir` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
從資料庫複製時，可用來暫存臨時資料的 Amazon S3 路徑。
+ `TmpDirIAMRole` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
具有許可的 IAM 角色。
+ `UpsertRedshiftOptions` – [UpsertRedshiftTargetOptions](#aws-glue-api-visual-job-api-UpsertRedshiftTargetOptions) 物件。
寫入 Redshift 目標時設定 upsert 操作的選項集。
## AmazonRedshiftTarget 結構
指定 Amazon Redshift 目標。
**欄位**
+ `Name` – UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
Amazon Redshift 目標的名稱。
+ `Data` – [AmazonRedshiftNodeData](#aws-glue-api-visual-job-api-AmazonRedshiftNodeData) 物件。
指定 Amazon Redshift 目標節點的資料。
+ `Inputs`：UTF-8 字串陣列，不可小於 1，也不可超過 1 個字串。
輸入到資料目標的節點。
## UpsertRedshiftTargetOptions 結構
寫入 Redshift 目標時設定 upsert 操作的選項。
**欄位**
+ `TableLocation` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
Redshift 資料表的實體位置。
+ `ConnectionName` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
用來寫入 Redshift 的連線名稱。
+ `UpsertKeys` – UTF-8 字串陣列。
用於確定是執行更新還是插入的金鑰。
## S3CatalogTarget 結構
指定使用 Data Catalog 寫入 Amazon S3 AWS Glue 的資料目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料目標的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
輸入到資料目標的節點。
+ `PartitionKeys` – UTF-8 字串陣列。
指定使用一系列索引鍵的原生分割。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫中資料表的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫的名稱。
+ `SchemaChangePolicy` – [CatalogSchemaChangePolicy](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy) 物件。
可以針對爬蟲程式指定更新行為的政策。
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 物件。
指定是否自動啟用 S3 目錄目標的資料品質評估。設為 `true` 時，會在寫入操作期間自動執行資料品質檢查。
## S3GlueParquetTarget 結構
指定以 Apache Parquet 直欄式儲存寫入 Amazon S3 的資料目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料目標的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
輸入到資料目標的節點。
+ `PartitionKeys` – UTF-8 字串陣列。
指定使用一系列索引鍵的原生分割。
+ `Path` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入的單一 Amazon S3 路徑。
+ `Compression` – UTF-8 字串 (有效值：`snappy="SNAPPY"` \$1 `lzo="LZO"` \$1 `gzip="GZIP"` \$1 `brotli="BROTLI"` \$1 `lz4="LZ4"` \$1 `uncompressed="UNCOMPRESSED"` \$1 `none="NONE"`)。
指定資料的壓縮方式。一般來說，如果資料具有標準副檔名，則不需要此項目。可能值為 `"gzip"` 和 `"bzip"`。
+ `NumberTargetPartitions` – UTF-8 字串。
指定使用 AWS Glue寫入 Amazon S3 時 Parquet 檔案的目標分區數目。
+ `SchemaChangePolicy` – [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy) 物件。
可以針對爬蟲程式指定更新行為的政策。
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 物件。
指定是否自動啟用 S3 AWS Glue Parquet 目標的資料品質評估。設為 `true` 時，會在寫入操作期間自動執行資料品質檢查。
## CatalogSchemaChangePolicy 結構
可以針對爬蟲程式指定更新行為的政策。
**欄位**
+ `EnableUpdateCatalog` – 布林值。
爬蟲程式找到變更的結構描述時是否使用指定的更新行為。
+ `UpdateBehavior` – UTF-8 字串 (有效值：`UPDATE_IN_DATABASE` \$1 `LOG`)。
爬蟲程式找到變更結構描述時的更新行為。
## S3DirectTarget 結構
指定寫入 Amazon S3 的資料目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料目標的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
輸入到資料目標的節點。
+ `PartitionKeys` – UTF-8 字串陣列。
指定使用一系列索引鍵的原生分割。
+ `Path` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入的單一 Amazon S3 路徑。
+ `Compression` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定資料的壓縮方式。一般來說，如果資料具有標準副檔名，則不需要此項目。可能值為 `"gzip"` 和 `"bzip"`。
+ `NumberTargetPartitions` – UTF-8 字串。
指定將資料直接寫入 Amazon S3 時的目標分區數目。
+ `Format` – *必要：*UTF-8 字串 (有效值：`json="JSON"` \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` \$1 `iceberg="ICEBERG"` \$1 `hyper="HYPER"` \$1 `xml="XML"`)。
指定目標的資料輸出格式。
+ `SchemaChangePolicy` – [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy) 物件。
可以針對爬蟲程式指定更新行為的政策。
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 物件。
指定是否自動啟用 S3 直接目標的資料品質評估。設為 `true` 時，會在寫入操作期間自動執行資料品質檢查。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定 S3 直接目標的資料結構描述。
## S3HudiCatalogTarget 結構
指定在 AWS Glue Data Catalog 中寫入 Hudi 資料來源的目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料目標的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
輸入到資料目標的節點。
+ `PartitionKeys` – UTF-8 字串陣列。
指定使用一系列索引鍵的原生分割。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫中資料表的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫的名稱。
+ `AdditionalOptions` – *必要：*金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定連接器的其他連接選項。
+ `SchemaChangePolicy` – [CatalogSchemaChangePolicy](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy) 物件。
可以針對爬蟲程式指定更新行為的政策。
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 物件。
指定是否自動啟用 S3 Hudi 目錄目標的資料品質評估。設為 `true` 時，會在寫入操作期間自動執行資料品質檢查。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定 S3 Hudi 目錄目標的資料結構描述。
## S3HudiDirectTarget 結構
指定寫入 Hudi 資料來源的目標 Amazon S3。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料目標的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
輸入到資料目標的節點。
+ `Path` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入 Hudi 資料來源的 Amazon S3 路徑。
+ `Compression` – *必要：*UTF-8 字串 (有效值：`gzip="GZIP"` \$1 `lzo="LZO"` \$1 `uncompressed="UNCOMPRESSED"` \$1 `snappy="SNAPPY"`)。
指定資料的壓縮方式。一般來說，如果資料具有標準副檔名，則不需要此項目。可能值為 `"gzip"` 和 `"bzip"`。
+ `NumberTargetPartitions` – UTF-8 字串。
指定跨 Amazon S3 分佈 Hudi 資料集檔案的目標分區數目。
+ `PartitionKeys` – UTF-8 字串陣列。
指定使用一系列索引鍵的原生分割。
+ `Format` – *必要：*UTF-8 字串 (有效值：`json="JSON"` \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` \$1 `iceberg="ICEBERG"` \$1 `hyper="HYPER"` \$1 `xml="XML"`)。
指定目標的資料輸出格式。
+ `AdditionalOptions` – *必要：*金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定連接器的其他連接選項。
+ `SchemaChangePolicy` – [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy) 物件。
可以針對爬蟲程式指定更新行為的政策。
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 物件。
指定是否自動啟用 S3 Hudi 直接目標的資料品質評估。設為 `true` 時，會在寫入操作期間自動執行資料品質檢查。
## S3DeltaCatalogTarget 結構
指定在 AWS Glue Data Catalog 中寫入 Delta Lake 資料來源的目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料目標的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
輸入到資料目標的節點。
+ `PartitionKeys` – UTF-8 字串陣列。
指定使用一系列索引鍵的原生分割。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫中資料表的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫的名稱。
+ `AdditionalOptions` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定連接器的其他連接選項。
+ `SchemaChangePolicy` – [CatalogSchemaChangePolicy](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy) 物件。
可以針對爬蟲程式指定更新行為的政策。
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 物件。
指定是否自動啟用 S3 Delta 目錄目標的資料品質評估。設為 `true` 時，會在寫入操作期間自動執行資料品質檢查。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定 S3 Delta 目錄目標的資料結構描述。
## S3DeltaDirectTarget 結構
指定寫入 Delta Lake 資料來源的目標 Amazon S3。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料目標的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
輸入到資料目標的節點。
+ `PartitionKeys` – UTF-8 字串陣列。
指定使用一系列索引鍵的原生分割。
+ `Path` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入 Delta Lake 資料來源的 Amazon S3 路徑。
+ `Compression` – *必要：*UTF-8 字串 (有效值：`uncompressed="UNCOMPRESSED"` \$1 `snappy="SNAPPY"`)。
指定資料的壓縮方式。一般來說，如果資料具有標準副檔名，則不需要此項目。可能值為 `"gzip"` 和 `"bzip"`。
+ `NumberTargetPartitions` – UTF-8 字串。
指定跨 Amazon S3 分佈 Delta Lake 資料集檔案的目標分區數目。
+ `Format` – *必要：*UTF-8 字串 (有效值：`json="JSON"` \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` \$1 `iceberg="ICEBERG"` \$1 `hyper="HYPER"` \$1 `xml="XML"`)。
指定目標的資料輸出格式。
+ `AdditionalOptions` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定連接器的其他連接選項。
+ `SchemaChangePolicy` – [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy) 物件。
可以針對爬蟲程式指定更新行為的政策。
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 物件。
指定是否自動啟用 S3 Delta 直接目標的資料品質評估。設為 `true` 時，會在寫入操作期間自動執行資料品質檢查。
## S3HyperDirectTarget 結構
指定寫入 Amazon S3 的 HyperDirect 資料目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
HyperDirect 目標節點的唯一識別碼。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
指定 HyperDirect 目標的輸入來源。
+ `Format` – UTF-8 字串 (有效值：`json="JSON"` \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` \$1 `iceberg="ICEBERG"` \$1 `hyper="HYPER"` \$1 `xml="XML"`)。
指定 HyperDirect 目標的資料輸出格式。
+ `PartitionKeys` – UTF-8 字串陣列。
定義輸出資料的分區策略。
+ `Path` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
將寫入輸出資料的 S3 位置。
+ `Compression` – UTF-8 字串 (有效值：`uncompressed="UNCOMPRESSED"`)。
要套用至輸出資料的壓縮類型。
+ `SchemaChangePolicy` – [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy) 物件。
定義寫入操作期間如何處理結構描述變更。
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 物件。
指定是否自動啟用 S3 Hyper 直接目標的資料品質評估。設為 `true` 時，會在寫入操作期間自動執行資料品質檢查。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定 S3 Hyper 直接目標的資料結構描述。
## S3IcebergDirectTarget 結構
指定在 Amazon S3中寫入 Iceberg 資料來源的目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
指定資料管道中 Iceberg 目標節點的唯一識別碼。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
定義將資料提供給此 Iceberg 目標的單一輸入來源。
+ `PartitionKeys` – UTF-8 字串陣列。
指定用於分區 S3 中 Iceberg 資料表資料的資料欄。
+ `Path` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
定義將在其中儲存 Iceberg 資料表資料的 S3 位置。
+ `Format` – *必要：*UTF-8 字串 (有效值：`json="JSON"` \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` \$1 `iceberg="ICEBERG"` \$1 `hyper="HYPER"` \$1 `xml="XML"`)。
指定用於儲存 Iceberg 資料表資料的檔案格式 (例如 Parquet、ORC)。
+ `AdditionalOptions` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
提供用於自訂 Iceberg 資料表行為的其他組態選項。
+ `SchemaChangePolicy` – [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy) 物件。
定義將資料寫入 Iceberg 資料表時如何處理結構描述變更。
+ `Compression` – *必要：*UTF-8 字串 (有效值：`gzip="GZIP"` \$1 `lzo="LZO"` \$1 `uncompressed="UNCOMPRESSED"` \$1 `snappy="SNAPPY"`)。
指定用於 S3 中 Iceberg 資料表檔案的編解碼器。
+ `NumberTargetPartitions` – UTF-8 字串。
設定跨 S3 分佈 Iceberg 資料表檔案的目標分區數目。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定 S3 Iceberg 直接目標的資料結構描述。
## DirectSchemaChangePolicy 結構
可以針對爬蟲程式指定更新行為的政策。
**欄位**
+ `EnableUpdateCatalog` – 布林值。
爬蟲程式找到變更的結構描述時是否使用指定的更新行為。
+ `UpdateBehavior` – UTF-8 字串 (有效值：`UPDATE_IN_DATABASE` \$1 `LOG`)。
爬蟲程式找到變更結構描述時的更新行為。
+ `Table` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定資料庫中套用結構描述變更政策的資料表。
+ `Database` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定套用結構描述變更政策的資料庫。
## ApplyMapping 結構
指定將資料來源中的資料屬性索引鍵映射至資料目標中資料屬性索引鍵的轉換。您可以重新命名索引鍵、修改索引鍵的資料類型，以及選擇要從資料集中捨棄哪些索引鍵。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
由其節點名稱識別的資料輸入。
+ `Mapping` – *必要：*一個 [映射](#aws-glue-api-visual-job-api-Mapping) 物件。
將資料來源中的資料屬性索引鍵映射至資料目標中的資料屬性索引鍵。
## Mapping 結構
指定資料屬性索引鍵的映射。
**欄位**
+ `ToKey` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
套用映射之後，資料行應具備的名稱。可以與 `FromPath` 相同。
+ `FromPath` – UTF-8 字串陣列。
要修改的資料表或資料行。
+ `FromType` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要修改之資料的類型。
+ `ToType` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要修改資料的資料類型。
+ `Dropped` – 布林值。
若此值為 true，則移除資料行。
+ `Children` – 一個 [映射](#aws-glue-api-visual-job-api-Mapping) 物件陣列。
僅適用於巢套資料結構。如果要變更父結構，同時變更其某個子結構，則可以填寫此資料結構。它也是 `Mapping`，但其 `FromPath` 將是父結構的 `FromPath`，再加上來自此結構的 `FromPath`。
對於子部件，假設您的結構如下：
`{ "FromPath": "OuterStructure", "ToKey": "OuterStructure", "ToType": "Struct", "Dropped": false, "Chidlren": [{ "FromPath": "inner", "ToKey": "inner", "ToType": "Double", "Dropped": false, }] }`
您可以指定看起來類似如下的 `Mapping`：
`{ "FromPath": "OuterStructure", "ToKey": "OuterStructure", "ToType": "Struct", "Dropped": false, "Chidlren": [{ "FromPath": "inner", "ToKey": "inner", "ToType": "Double", "Dropped": false, }] }`
## SelectFields 結構
指定選擇要保留之資料屬性索引鍵的轉換。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
由其節點名稱識別的資料輸入。
+ `Paths` – *必要：*UTF-8 字串陣列。
資料結構中變數的 JSON 路徑。
## DropFields 結構
指定選擇要捨棄之資料屬性索引鍵的轉換。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
由其節點名稱識別的資料輸入。
+ `Paths` – *必要：*UTF-8 字串陣列。
資料結構中變數的 JSON 路徑。
## RenameField 結構
指定重新命名單一資料屬性索引鍵的轉換。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
由其節點名稱識別的資料輸入。
+ `SourcePath` – *必要：*UTF-8 字串陣列。
來源資料的資料結構中變數的 JSON 路徑。
+ `TargetPath` – *必要：*UTF-8 字串陣列。
目標資料的資料結構中變數的 JSON 路徑。
## Spigot 結構
指定將資料範例寫入 Amazon S3 儲存貯體的轉換。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
由其節點名稱識別的資料輸入。
+ `Path` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
Amazon S3 中的路徑，其中轉換會將記錄子集從資料集寫入 Amazon S3 儲存貯體中的 JSON 檔案。
+ `Topk` – 數字 (整數)，不可大於 100。
指定要從資料集開始寫入的記錄數目。
+ `Prob` – 數字 (雙字)，不可大於 1。
挑選任何給定記錄的概率 (最大值為 1 的小數值)。值 1 表示從資料集讀取的每一列應包含在範例輸出中。
## Join 結構
使用指定資料屬性索引鍵上的比較片語，將兩個資料集聯結為一個資料集。可以使用內、外、左、右、左半、左反聯結。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 2 或超過 2 個字串。
由其節點名稱識別的資料輸入。
+ `JoinType` – *必要：*UTF-8 字串 (有效值：`equijoin="EQUIJOIN"` \$1 `left="LEFT"` \$1 `right="RIGHT"` \$1 `outer="OUTER"` \$1 `leftsemi="LEFT_SEMI"` \$1 `leftanti="LEFT_ANTI"`)。
指定要在資料集上執行的聯結類型。
+ `Columns` – *必要：*[JoinColumn](#aws-glue-api-visual-job-api-JoinColumn) 物件陣列，不小於 2 個結構，也不大於 2 個結構。
要聯結的兩個資料行的清單。
## JoinColumn 結構
指定要聯結的資料行。
**欄位**
+ `From` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要接合的資料行。
+ `Keys` – *必要：*UTF-8 字串陣列。
要聯結之資料行的索引鍵。
## SplitFields 結構
指定將資料屬性索引鍵分割成兩個 `DynamicFrames` 的轉換。輸出是 `DynamicFrames` 的集合：一個具有所選資料屬性索引鍵，另一個具有其餘資料屬性索引鍵。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
由其節點名稱識別的資料輸入。
+ `Paths` – *必要：*UTF-8 字串陣列。
資料結構中變數的 JSON 路徑。
## SelectFromCollection 結構
指定從 `DynamicFrames` 的集合選擇一個 `DynamicFrame` 的轉換。輸出為所選的 `DynamicFrame`。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
由其節點名稱識別的資料輸入。
+ `Index` – *必要：*數字 (整數)，不可大於 None (無)。
要選取的 DynamicFrame 的索引。
## FillMissingValues 結構
指定如下轉換：尋找遺失值之資料集中的記錄，並新增具有由插補決定值的新欄位。輸入資料集會用於訓練機器學習模型，以決定遺失值應該是什麼。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
由其節點名稱識別的資料輸入。
+ `ImputedPath` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
輸入資料集的資料結構中變數的 JSON 路徑。
+ `FilledPath` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
填充資料集之資料結構中變數的 JSON 路徑。
## Filter 結構
指定根據篩選條件將資料集分割成兩個的轉換。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
由其節點名稱識別的資料輸入。
+ `LogicalOperator` – *必要：*UTF-8 字串 (有效值：`AND` \$1 `OR`)。
透過比較索引鍵值與指定值來篩選列的運算子。
+ `Filters` – *必要：*一個 [FilterExpression](#aws-glue-api-visual-job-api-FilterExpression) 物件。
指定篩選條件表達式。
## FilterExpression 結構
指定篩選條件表達式。
**欄位**
+ `Operation` – *必要：*UTF-8 字串 (有效值：`EQ` \$1 `LT` \$1 `GT` \$1 `LTE` \$1 `GTE` \$1 `REGEX` \$1 `ISNULL`)。
要在表達式中執行的操作類型。
+ `Negated` – 布林值。
表達式是否被否定。
+ `Values` – *必要：*一個 [FilterValue](#aws-glue-api-visual-job-api-FilterValue) 物件。
篩選條件值清單。
## FilterValue 結構
代表在 `FilterExpression` 的值清單中的單一項目。
**欄位**
+ `Type` – *必要：*UTF-8 字串 (有效值：`COLUMNEXTRACTED` \$1 `CONSTANT`)。
篩選條件值的類型。
+ `Value` – *必要：*UTF-8 字串陣列。
要關聯的值。
## CustomCode 結構
指定使用您提供的自訂程式碼來執行資料轉換的轉換。輸出是 DynamicFrames 的集合。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，至少要有 1 個字串。
由其節點名稱識別的資料輸入。
+ `Code` – *必要：*UTF-8 字串，需符合[Custom string pattern #54](aws-glue-api-common.md#regex_54)。
用來執行資料轉換的自訂程式碼。
+ `ClassName` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
為自訂程式碼節點類別定義的名稱。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定自訂代碼轉換的資料結構描述。
## SparkSQL 結構
指定轉換，其中輸入使用 Spark SQL 語法的 SQL 查詢來轉換資料。輸出是單個 `DynamicFrame`。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，至少要有 1 個字串。
由其節點名稱識別的資料輸入。您可以將表名與 SQL 查詢中使用的每個輸入節點相關聯。您選擇的名稱必須符合 Spark SQL 命名限制。
+ `SqlQuery` – *必要：*UTF-8 字串，需符合[Custom string pattern #62](aws-glue-api-common.md#regex_62)。
必須使用 Spark SQL 語法並返回單個資料集的 SQL 查詢。
+ `SqlAliases` – *必要：*一個 [SqlAlias](#aws-glue-api-visual-job-api-SqlAlias) 物件。
別名清單。別名允許您指定要在 SQL 中為給定輸入使用的名稱。例如，您有名為 "MyDataSource" 的資料來源。如果您指定 `From` 為 MyDataSource，以及指定 `Alias` 為 SqlName，則在 SQL 中可以執行如下操作：
`select * from SqlName`
並從 MyDataSource 取得資料。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定 SparkSQL 轉換的資料結構描述。
## SqlAlias 結構
代表在 `SqlAliases` 的值清單中的單一項目。
**欄位**
+ `From` – *必要：*UTF-8 字串，需符合[Custom string pattern #60](aws-glue-api-common.md#regex_60)。
資料表或其中的資料行。
+ `Alias` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
提供給資料表或其中之資料行的暫時名稱。
## DropNullFields 結構
指定轉換，如果資料行中的所有值都為「null」(空)，則從資料集中刪除此行。根據預設， AWS Glue Studio 會辨識 null 物件，但一些值，例如空字串、「null」字串、-1 整數或其他預留位置，例如零，則不會自動辨識為 null。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
由其節點名稱識別的資料輸入。
+ `NullCheckBoxList` – [NullCheckBoxList](#aws-glue-api-visual-job-api-NullCheckBoxList) 物件。
表示某些值是否被識別為空值以進行移除的結構。
+ `NullTextList` – [NullValueField](#aws-glue-api-visual-job-api-NullValueField) 物件陣列，不可超過 50 個結構。
指定 NullValueField 結構清單的結構，該結構代表自訂的空值，例如零或作為資料集唯一的空預留位置使用的其他值。
此 `DropNullFields` 轉換只會在空預留位置和資料類型的值都符合資料時才移除自訂的空值。
## NullCheckBoxList 結構
表示某些值是否被識別為空值以進行移除。
**欄位**
+ `IsEmpty` – 布林值。
指定一個空字串被視為空值。
+ `IsNullString` – 布林值。
指定拼寫為單字 null 的值被視為空值。
+ `IsNegOne` – 布林值。
指定 -1 的整數值被視為空值。
## NullValueField 結構
代表自訂的空值，例如零或用作資料集唯一的空預留位置的其他值。
**欄位**
+ `Value` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
空預留位置的值。
+ `Datatype` – *必要：*[Datatype](#aws-glue-api-visual-job-api-Datatype) 物件。
值的資料類型。
## Datatype 結構
代表該值的資料類型的結構。
**欄位**
+ `Id` – *必要：*UTF-8 字串，需符合[Custom string pattern #60](aws-glue-api-common.md#regex_60)。
值的資料類型。
+ `Label` – *必要：*UTF-8 字串，需符合[Custom string pattern #60](aws-glue-api-common.md#regex_60)。
指派給資料類型的標籤。
## Merge 結構
指定根據指定的主索引鍵來合併此 `DynamicFrame` 與暫存 `DynamicFrame` 以識別記錄的轉換。重複的記錄 (具有相同主索引鍵的記錄) 不會被刪除重複資料。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 2 或超過 2 個字串。
由其節點名稱識別的資料輸入。
+ `Source` – *必要：*UTF-8 字串，需符合[Custom string pattern #60](aws-glue-api-common.md#regex_60)。
來源 `DynamicFrame`，它將與暫存 `DynamicFrame` 合併。
+ `PrimaryKeys` – *必要：*UTF-8 字串陣列。
要從來源和暫存動態影格比對記錄的主索引鍵欄位清單。
## Union 結構
指定將兩個或多個資料集中的列合併為單一結果的轉換。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 2 或超過 2 個字串。
輸入到轉換的節點 ID。
+ `UnionType` – *必要：*UTF-8 字串 (有效值：`ALL` \$1 `DISTINCT`)。
指示 Union 轉換的類型。
指定 `ALL` 以將資料來源中的所有列聯結至產生的 DynamicFrame。產生的聯集不會移除重複的資料列。
指定 `DISTINCT` 以刪除產生的 DynamicFrame 中的重複列。
## PIIDetection 結構
指定用於標識、刪除或遮罩 PII 資料的轉換。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
輸入到轉換的節點 ID。
+ `PiiType` – *必要：*UTF-8 字串 (有效值：`RowAudit` \$1 `RowHashing` \$1 `RowMasking` \$1 `RowPartialMasking` \$1 `ColumnAudit` \$1 `ColumnHashing` \$1 `ColumnMasking`)。
指示 PIIDetection 轉換的類型。
+ `EntityTypesToDetect` – *必要：*UTF-8 字串陣列。
指示 PIIDetection 轉換將標識為 PII 資料的實體類型。
PII 類型實體包括：PERSON\$1NAME、DATE、USA\$1SNN、EMAIL、USA\$1ITIN、USA\$1PASSPORT\$1NUMBER、PHONE\$1NUMBER、BANK\$1ACCOUNT、IP\$1ADDRESS、MAC\$1ADDRESS、USA\$1CPT\$1CODE、USA\$1HCPCS\$1CODE、USA\$1NATIONAL\$1DRUG\$1CODE、USA\$1MEDICARE\$1BENEFICIARY\$1IDENTIFIER、USA\$1HEALTH\$1INSURANCE\$1CLAIM\$1NUMBER,CREDIT\$1CARD、USA\$1NATIONAL\$1PROVIDER\$1IDENTIFIER、USA\$1DEA\$1NUMBER,USA\$1DRIVING\$1LICENSE
+ `OutputColumnName` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
針對將在行內包含偵測到的任何實體類型，指示輸出列名。
+ `SampleFraction` – 數字 (雙字)，不可大於 1。
指示掃描 PII 實體時要採樣的資料部分。
+ `ThresholdFraction` – 數字 (雙字)，不可大於 1。
針對要將列標識為 PII 資料時，指示必須滿足的資料部分。
+ `MaskValue` – UTF-8 字串，長度不可超過 256 個位元組，且需符合 [Custom string pattern #58](aws-glue-api-common.md#regex_58)。
針對偵測到的實體指示替換值。
+ `RedactText` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定是否修訂偵測到的 PII 文字。設定為 `true` 時，PII 內容會取代為修訂字元。
+ `RedactChar` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
啟用修訂時用於取代偵測到的 PII 內容的字元。預設修訂字元為 `*`。
+ `MatchPattern` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
規則表達式模式，用於識別標準偵測演算法以外的其他 PII 內容。
+ `NumLeftCharsToExclude` – 數字 (整數)，不可大於 None (無)。
在偵測到的 PII 內容左側從修訂中排除的字元數。這允許保留敏感資料的相關內容。
+ `NumRightCharsToExclude` – 數字 (整數)，不可大於 None (無)。
在偵測到的 PII 內容右側從修訂中排除的字元數。這允許保留敏感資料的相關內容。
+ `DetectionParameters` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
用於設定 PII 偵測行為和敏感度設定的其他參數。
+ `DetectionSensitivity` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
PII 偵測的敏感度等級。較高的敏感度等級可偵測更多潛在的 PII，但可能會導致更多誤報。
## Aggregate 結構
指定轉換，依照所選欄位來分組行，並依照指定函數計算彙總值。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
指定欄位和行作為彙總轉換輸入。
+ `Groups` – *必要：*UTF-8 字串陣列。
指定分組所依據的欄位。
+ `Aggs` – *必要：*[AggregateOperation](#aws-glue-api-visual-job-api-AggregateOperation) 物件陣列，不小於 1 個結構，也不大於 30 個結構。
指定要在指定欄位執行的彙總函數。
## DropDuplicates 結構
指定用於從資料集刪除重複資料行的轉換。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
轉換節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
由其節點名稱識別的資料輸入。
+ `Columns` – UTF-8 字串陣列。
重複時要合併或刪除的列名。
## GovernedCatalogTarget 結構
指定使用 Data Catalog 寫入 Amazon S3 AWS Glue 的資料目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料目標的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
輸入到資料目標的節點。
+ `PartitionKeys` – UTF-8 字串陣列。
指定使用一系列索引鍵的原生分割。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫中資料表的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫的名稱。
+ `SchemaChangePolicy` – [CatalogSchemaChangePolicy](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy) 物件。
可以針對受管目錄指定更新行為的政策。
## GovernedCatalogSource 結構
指定受管 Data Catalog 中的 AWS Glue 資料存放區。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料存放區的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取的資料庫。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取的資料庫資料表。
+ `PartitionPredicate` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
滿足此述詞的分割區會被刪除。這些分割區中仍在保留期間內的檔案不會被刪除。設定為 `""` – 預設為空值。
+ `AdditionalOptions` – [S3SourceAdditionalOptions](#aws-glue-api-visual-job-api-S3SourceAdditionalOptions) 物件。
指定其他連接選項。
## AggregateOperation 結構
指定執行彙總轉換中彙總所需的參數集。
**欄位**
+ `Column` – *必要：*UTF-8 字串陣列。
指定要套用彙總函數的資料集上的資料欄。
+ `AggFunc`–*必要：*UTF-8 字串 (有效值：`avg` \$1 `countDistinct` \$1 `count` \$1 `first` \$1 `last` \$1 `kurtosis` \$1 `max` \$1 `min` \$1 `skewness` \$1 `stddev_samp` \$1 `stddev_pop` \$1 `sum` \$1 `sumDistinct` \$1 `var_samp` \$1 `var_pop`)。
指定要套用的彙總函數。
可能的彙總函數包括：avg countDistinct、count、first、last、kurtosis、max、min、skewness、stddev\$1samp、stddev\$1pop、sum、sumDistinct、var\$1samp、var\$1pop
## GlueSchema 結構
當無法由 AWS Glue決定架構時，指定使用者定義的架構。
**欄位**
+ `Columns` – 一個 [GlueStudioSchemaColumn](#aws-glue-api-visual-job-api-GlueStudioSchemaColumn) 物件陣列。
指定組成 AWS Glue 結構描述的資料欄定義。
## GlueStudioSchemaColumn 結構
指定 AWS Glue 結構描述定義中的單一資料欄。
**欄位**
+ `Name` – *必要：*UTF-8 字串，長度不可超過 1024 個位元組，且需符合 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。
AWS Glue Studio 結構描述中的資料欄名稱。
+ `Type` – UTF-8 字串，長度不可超過 131072 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。
AWS Glue Studio 結構描述中此欄的 hive 類型。
+ `GlueStudioType` – UTF-8 字串，長度不可超過 131072 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。
Studio 中定義的資料欄資料類型 AWS Glue 。
## GlueStudioColumn 結構
指定 AWS Glue Studio 中的單一資料欄。
**欄位**
+ `Key` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
AWS Glue Studio 中資料欄的索引鍵。
+ `FullPath` – *必要：*UTF-8 字串陣列。
TThe中資料欄的完整 URL。 AWS Glue
+ `Type` – *必要：*UTF-8 字串 (有效值：`array="ARRAY"` \$1 `bigint="BIGINT"` \$1 `bigint array="BIGINT_ARRAY"` \$1 `binary="BINARY"` \$1 `binary array="BINARY_ARRAY"` \$1 `boolean="BOOLEAN"` \$1 `boolean array="BOOLEAN_ARRAY"` \$1 `byte="BYTE"` \$1 `byte array="BYTE_ARRAY"` \$1 `char="CHAR"` \$1 `char array="CHAR_ARRAY"` \$1 `choice="CHOICE"` \$1 `choice array="CHOICE_ARRAY"` \$1 `date="DATE"` \$1 `date array="DATE_ARRAY"` \$1 `decimal="DECIMAL"` \$1 `decimal array="DECIMAL_ARRAY"` \$1 `double="DOUBLE"` \$1 `double array="DOUBLE_ARRAY"` \$1 `enum="ENUM"` \$1 `enum array="ENUM_ARRAY"` \$1 `float="FLOAT"` \$1 `float array="FLOAT_ARRAY"` \$1 `int="INT"` \$1 `int array="INT_ARRAY"` \$1 `interval="INTERVAL"` \$1 `interval array="INTERVAL_ARRAY"` \$1 `long="LONG"` \$1 `long array="LONG_ARRAY"` \$1 `object="OBJECT"` \$1 `short="SHORT"` \$1 `short array="SHORT_ARRAY"` \$1 `smallint="SMALLINT"` \$1 `smallint array="SMALLINT_ARRAY"` \$1 `string="STRING"` \$1 `string array="STRING_ARRAY"` \$1 `timestamp="TIMESTAMP"` \$1 `timestamp array="TIMESTAMP_ARRAY"` \$1 `tinyint="TINYINT"` \$1 `tinyint array="TINYINT_ARRAY"` \$1 `varchar="VARCHAR"` \$1 `varchar array="VARCHAR_ARRAY"` \$1 `null="NULL"` \$1 `unknown="UNKNOWN"` \$1 `unknown array="UNKNOWN_ARRAY"`)。
TThe中資料欄的類型。 AWS Glue
+ `Children` – 結構的陣列。
TThe中父欄的子項。 AWS Glue
+ `GlueStudioType` – UTF-8 字串 (有效值：`array="ARRAY"` \$1 `bigint="BIGINT"` \$1 `bigint array="BIGINT_ARRAY"` \$1 `binary="BINARY"` \$1 `binary array="BINARY_ARRAY"` \$1 `boolean="BOOLEAN"` \$1 `boolean array="BOOLEAN_ARRAY"` \$1 `byte="BYTE"` \$1 `byte array="BYTE_ARRAY"` \$1 `char="CHAR"` \$1 `char array="CHAR_ARRAY"` \$1 `choice="CHOICE"` \$1 `choice array="CHOICE_ARRAY"` \$1 `date="DATE"` \$1 `date array="DATE_ARRAY"` \$1 `decimal="DECIMAL"` \$1 `decimal array="DECIMAL_ARRAY"` \$1 `double="DOUBLE"` \$1 `double array="DOUBLE_ARRAY"` \$1 `enum="ENUM"` \$1 `enum array="ENUM_ARRAY"` \$1 `float="FLOAT"` \$1 `float array="FLOAT_ARRAY"` \$1 `int="INT"` \$1 `int array="INT_ARRAY"` \$1 `interval="INTERVAL"` \$1 `interval array="INTERVAL_ARRAY"` \$1 `long="LONG"` \$1 `long array="LONG_ARRAY"` \$1 `object="OBJECT"` \$1 `short="SHORT"` \$1 `short array="SHORT_ARRAY"` \$1 `smallint="SMALLINT"` \$1 `smallint array="SMALLINT_ARRAY"` \$1 `string="STRING"` \$1 `string array="STRING_ARRAY"` \$1 `timestamp="TIMESTAMP"` \$1 `timestamp array="TIMESTAMP_ARRAY"` \$1 `tinyint="TINYINT"` \$1 `tinyint array="TINYINT_ARRAY"` \$1 `varchar="VARCHAR"` \$1 `varchar array="VARCHAR_ARRAY"` \$1 `null="NULL"` \$1 `unknown="UNKNOWN"` \$1 `unknown array="UNKNOWN_ARRAY"`)。
Studio 中定義的資料欄資料類型 AWS Glue 。
## DynamicTransform 結構
指定執行動態轉換所需的參數集。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定動態轉換的名稱。
+ `TransformName` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定在 AWS Glue Studio 視覺化編輯器中顯示的動態轉換名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
指定所需動態轉換的輸入。
+ `Parameters` – 一個 [TransformConfigParameter](#aws-glue-api-visual-job-api-TransformConfigParameter) 物件陣列。
指定動態轉換的參數。
+ `FunctionName` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定動態轉換的函數名稱。
+ `Path` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定動態轉換來源檔案和組態檔案的路徑。
+ `Version` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
此欄位未使用，且會在未來版本中移除。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定動態轉換的資料結構描述。
## TransformConfigParameter 結構
指定動態轉換組態檔案的參數。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定動態轉換組態檔案的參數名稱。
+ `Type` – *必要：*UTF-8 字串 (有效值：`str="STR"` \$1 `int="INT"` \$1 `float="FLOAT"` \$1 `complex="COMPLEX"` \$1 `bool="BOOL"` \$1 `list="LIST"` \$1 `null="NULL"`)。
指定動態轉換組態檔案的參數類型。
+ `ValidationRule` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定動態轉換組態檔案的驗證規則。
+ `ValidationMessage` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定動態轉換組態檔案的驗證訊息。
+ `Value` – UTF-8 字串陣列。
指定動態轉換組態檔案的參數值。
+ `ListType` – UTF-8 字串 (有效值：`str="STR"` \$1 `int="INT"` \$1 `float="FLOAT"` \$1 `complex="COMPLEX"` \$1 `bool="BOOL"` \$1 `list="LIST"` \$1 `null="NULL"`)。
指定動態轉換組態檔案的參數類型清單。
+ `IsOptional` – 布林值。
指定參數是否為選用或未在動態轉換組態檔案中。
## EvaluateDataQuality 結構
指定資料品質評估標準。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料品質評估的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
資料品質評估的輸入。
+ `Ruleset` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 65536 個位元組，且需符合[Custom string pattern #59](aws-glue-api-common.md#regex_59)。
資料品質評估的規則集。
+ `Output` – UTF-8 字串 (有效值：`PrimaryInput` \$1 `EvaluationResults`)。
資料品質評估的是輸出。
+ `PublishingOptions` – [DQResultsPublishingOptions](#aws-glue-api-visual-job-api-DQResultsPublishingOptions) 物件。
設定結果發佈方式的選項。
+ `StopJobOnFailureOptions` – [DQStopJobOnFailureOptions](#aws-glue-api-visual-job-api-DQStopJobOnFailureOptions) 物件。
設定資料品質評估失敗時如何停止任務的選項。
## DQResultsPublishingOptions 結構
設定資料品質評估結果發佈方式的選項。
**欄位**
+ `EvaluationContext` – UTF-8 字串，需符合[Custom string pattern #60](aws-glue-api-common.md#regex_60)。
評估的內容。
+ `ResultsS3Prefix` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
附加到結果前面的 Amazon S3 字首。
+ `CloudWatchMetricsEnabled` – 布林值。
啟用資料品質結果的指標。
+ `ResultsPublishingEnabled` – 布林值。
啟用發佈資料品質結果。
## DQStopJobOnFailureOptions 結構
設定資料品質評估失敗時如何停止任務的選項。
**欄位**
+ `StopJobOnFailureTiming` – UTF-8 字串 (有效值：`Immediate` \$1 `AfterDataLoad`)。
資料品質評估失敗時停止任務的時機。選項包括 Immediate (立即) 或 AfterDataLoad (載入資料後)。
## EvaluateDataQualityMultiFrame 結構
指定資料品質評估標準。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
資料品質評估的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，至少要有 1 個字串。
資料品質評估的輸入。此清單中的第一個輸入是主資料來源。
+ `AdditionalDataSources` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #63](aws-glue-api-common.md#regex_63)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
除主資料來源以外的所有資料來源的別名。
+ `Ruleset` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 65536 個位元組，且需符合[Custom string pattern #59](aws-glue-api-common.md#regex_59)。
資料品質評估的規則集。
+ `PublishingOptions` – [DQResultsPublishingOptions](#aws-glue-api-visual-job-api-DQResultsPublishingOptions) 物件。
設定結果發佈方式的選項。
+ `AdditionalOptions` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串 (有效值：`performanceTuning.caching="CacheOption"` \$1 `observations.scope="ObservationsOption"` \$1 `compositeRuleEvaluation.method="CompositeOption"`)。
每個值都是 UTF-8 字串。
設定轉換執行期行為的選項。
+ `StopJobOnFailureOptions` – [DQStopJobOnFailureOptions](#aws-glue-api-visual-job-api-DQStopJobOnFailureOptions) 物件。
設定資料品質評估失敗時如何停止任務的選項。
## 配方結構
在 AWS Glue 任務中使用 AWS Glue DataBrew 配方的 AWS Glue Studio 節點。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
AWS Glue Studio 節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
作為配方節點輸入的節點，由 ID 識別。
+ `RecipeReference` – [RecipeReference](#aws-glue-api-visual-job-api-RecipeReference) 物件。
節點使用的 DataBrew 配方參考。
+ `RecipeSteps` – 一個 [RecipeStep](#aws-glue-api-visual-job-api-RecipeStep) 物件陣列。
轉換配方節點中使用的步驟。
## RecipeReference 結構
AWS Glue DataBrew 配方的參考。
**欄位**
+ `RecipeArn` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
DataBrew 配方的 ARN。
+ `RecipeVersion` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 16 個位元組。
DataBrew 配方的 RecipeVersion。
## SnowflakeNodeData 結構
指定 AWS Glue Studio 中 Snowflake 節點的組態。
**欄位**
+ `SourceType` – UTF-8 字串，需符合[Custom string pattern #60](aws-glue-api-common.md#regex_60)。
指定如何指定擷取的資料。有效值：`"table"`、` "query"`。
+ `Connection` – [選項](#aws-glue-api-visual-job-api-Option) 物件。
指定 Snowflake 端點 AWS Glue 的資料型錄連線。
+ `Schema` – UTF-8 字串。
指定節點使用的 Snowflake 資料庫結構描述。
+ `Table` – UTF-8 字串。
指定節點使用的 Snowflake 資料表。
+ `Database` – UTF-8 字串。
指定節點使用的 Snowflake 資料庫。
+ `TempDir` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
目前未使用。
+ `IamRole` – [選項](#aws-glue-api-visual-job-api-Option) 物件。
目前未使用。
+ `AdditionalOptions` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定傳遞至 Snowflake 連接器的其他選項。如果在此節點的其他位置指定了選項，這會具有優先順序。
+ `SampleQuery` – UTF-8 字串。
SQL 字串，用於擷取具有 `query` sourcetype 的資料。
+ `PreAction` – UTF-8 字串。
SQL 字串會在 Snowflake 連接器執行其標準動作之前執行。
+ `PostAction` – UTF-8 字串。
SQL 字串會在 Snowflake 連接器執行其標準動作之後執行。
+ `Action` – UTF-8 字串。
指定在使用預先存在的資料寫入資料表時要採取的動作。有效值：` append`、`merge`、`truncate`、`drop`。
+ `Upsert` – 布林值。
當動作為 `append` 時使用。指定資料列已存在時的解析行為。如果為 true，將更新預先存在的資料列。如果為 false，將插入這些資料列。
+ `MergeAction` – UTF-8 字串，需符合[Custom string pattern #60](aws-glue-api-common.md#regex_60)。
指定合併動作。有效值：`simple`、`custom`。如果為簡單，合併行為由 `MergeWhenMatched` 和 ` MergeWhenNotMatched` 定義。如果為自訂，由 `MergeClause` 定義。
+ `MergeWhenMatched` – UTF-8 字串，需符合[Custom string pattern #60](aws-glue-api-common.md#regex_60)。
指定合併時如何解析與預先存在的資料相符的記錄。有效值：` update`、`delete`。
+ `MergeWhenNotMatched` – UTF-8 字串，需符合[Custom string pattern #60](aws-glue-api-common.md#regex_60)。
指定合併時如何處理與預先存在的資料不相符的記錄。有效值：`insert`、`none`。
+ `MergeClause` – UTF-8 字串。
指定自訂合併行為的 SQL 陳述式。
+ `StagingTable` – UTF-8 字串。
執行 `merge` 或 upsert `append` 動作時使用的暫存資料表名稱。資料會寫入此資料表，然後由產生的後置動作移至 `table`。
+ `SelectedColumns` – 一個 [選項](#aws-glue-api-visual-job-api-Option) 物件陣列。
在偵測合併和更新插入相符項時，指定合併起來用於識別記錄的資料欄。具有 `value`、`label` 和 ` description` 金鑰的結構清單。每個結構都描述了一個資料欄。
+ `AutoPushdown` – 布林值。
指定是否啟用自動查詢下推。如果下推已啟用，則在 Spark 上執行查詢時，若查詢的一部分可以「向下推」到 Snowflake 伺服器，它便會被下推。這可改善某些查詢的效能。
+ `TableSchema` – 一個 [選項](#aws-glue-api-visual-job-api-Option) 物件陣列。
手動定義節點的目標結構描述。具有 `value`、`label` 和 `description` 金鑰的結構清單。每個結構都定義了一個資料欄。
## SnowflakeSource 結構
指定 Snowflake 資料來源。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
Snowflake 資料來源的名稱。
+ `Data` – *必要：*[SnowflakeNodeData](#aws-glue-api-visual-job-api-SnowflakeNodeData) 物件。
Snowflake 資料來源的組態。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定輸出資料的使用者定義結構描述。
## SnowflakeTarget 結構
指定 Snowflake 目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
Snowflake 目標的名稱。
+ `Data` – *必要：*[SnowflakeNodeData](#aws-glue-api-visual-job-api-SnowflakeNodeData) 物件。
指定 Snowflake 目標節點的資料。
+ `Inputs`：UTF-8 字串陣列，不可小於 1，也不可超過 1 個字串。
輸入到資料目標的節點。
## ConnectorDataSource 結構
指定使用標準連線選項產生的來源。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
此來源節點的名稱。
+ `ConnectionType` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
`connectionType`提供給基礎 AWS Glue 程式庫的 。此節點類型支援下列連線類型：
+ `opensearch`
+ `azuresql`
+ `azurecosmos`
+ `bigquery`
+ `saphana`
+ `teradata`
+ `vertica`
+ `Data` – *必要：*金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串。
每個值都是 UTF-8 字串。
針對節點指定連線選項的對應。您可以在 AWS Glue 文件的連線[參數](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-connect.html)區段中找到對應連線類型的標準連線選項。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定此來源的資料結構描述。
## ConnectorDataTarget 結構
指定使用標準連線選項產生的目標。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
此目標節點的名稱。
+ `ConnectionType` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
`connectionType`提供給基礎 AWS Glue 程式庫的 。此節點類型支援下列連線類型：
+ `opensearch`
+ `azuresql`
+ `azurecosmos`
+ `bigquery`
+ `saphana`
+ `teradata`
+ `vertica`
+ `Data` – *必要：*金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串。
每個值都是 UTF-8 字串。
針對節點指定連線選項的對應。您可以在 AWS Glue 文件的連線[參數](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-connect.html)區段中找到對應連線類型的標準連線選項。
+ `Inputs`：UTF-8 字串陣列，不可小於 1，也不可超過 1 個字串。
輸入到資料目標的節點。
## RecipeStep 結構
AWS Glue Studio 資料準備配方節點中使用的配方步驟。
**欄位**
+ `Action` – *必要：*[RecipeAction](#aws-glue-api-visual-job-api-RecipeAction) 物件。
配方步驟的轉換動作。
+ `ConditionExpressions` – 一個 [ConditionExpression](#aws-glue-api-visual-job-api-ConditionExpression) 物件陣列。
配方步驟的條件表達式。
## RecipeAction 結構
AWS Glue Studio 資料準備配方節點中定義的動作。
**欄位**
+ `Operation` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組，且需符合 [Custom string pattern #56](aws-glue-api-common.md#regex_56)。
配方動作的操作。
+ `Parameters` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組，需符合 [Custom string pattern #57](aws-glue-api-common.md#regex_57)。
每個值均為 UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 32,768 個位元組。
配方動作的參數。
## ConditionExpression 結構
AWS Glue Studio 資料準備配方節點中定義的條件表達式。
**欄位**
+ `Condition` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組，且需符合 [Custom string pattern #56](aws-glue-api-common.md#regex_56)。
條件表達式的條件。
+ `Value` – UTF-8 字串，長度不可超過 1024 個位元組。
條件表達式的值。
+ `TargetColumn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 1024 個位元組。
條件表達式的目標資料欄。
## S3CatalogIcebergSource 結構
指定在 AWS Glue Data Catalog 中註冊的 Apache Iceberg 資料來源。Iceberg 資料來源必須存放在其中 Amazon S3。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
Iceberg 資料來源的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫中資料表的名稱。
+ `AdditionalIcebergOptions` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定 Iceberg 資料來源的其他連線選項。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定 Iceberg 來源的資料結構描述。
## CatalogIcebergSource 結構
指定在 AWS Glue Data Catalog 中註冊的 Apache Iceberg 資料來源。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
Iceberg 資料來源的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫的名稱。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要讀取之資料庫中資料表的名稱。
+ `AdditionalIcebergOptions` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定 Iceberg 資料來源的其他連線選項。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定 Iceberg 來源的資料結構描述。
## S3IcebergCatalogTarget 結構
指定 Apache Iceberg 目錄目標，將資料寫入 ， Amazon S3 並在 AWS Glue Data Catalog 中註冊資料表。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
Iceberg 目錄目標的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
Iceberg 目錄目標的輸入連線。
+ `PartitionKeys` – UTF-8 字串陣列。
Iceberg 資料表的分區索引鍵清單。
+ `Table` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入目錄的資料表的名稱。
+ `Database` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要寫入之資料庫的名稱。
+ `AdditionalOptions` – 金鑰值對的映射陣列。
每個金鑰都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
每個值都是 UTF-8 字串，需符合 [Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定 Iceberg 目錄目標的其他連線選項。
+ `SchemaChangePolicy` – [CatalogSchemaChangePolicy](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy) 物件。
處理目錄目標中結構描述變更的政策。
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 物件。
指定是否自動啟用 S3 Iceberg 目錄目標的資料品質評估。設為 `true` 時，會在寫入操作期間自動執行資料品質檢查。
## DynamoDBELTConnectorSource 結構
指定用於從 DynamoDB 資料表擷取資料的 DynamoDB ELT 連接器來源。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
DynamoDB ELT 連接器來源的名稱。
+ `ConnectionOptions` – [DDBELTConnectionOptions](#aws-glue-api-visual-job-api-DDBELTConnectionOptions) 物件。
DynamoDB ELT 連接器來源的連線選項。
+ `OutputSchemas` – 一個 [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 物件陣列。
指定 DynamoDB ELT 連接器來源的資料結構描述。
## DDBELTConnectionOptions 結構
指定 DynamoDB ELT (擷取、載入、轉換) 操作的連線選項。此結構包含組態參數，用於使用 ELT 連接器從 DynamoDB 資料表連接和擷取資料。
**欄位**
+ `DynamodbExport` – UTF-8 字串 (有效值：`ddb` \$1 `s3`)。
指定 DynamoDB 資料擷取的匯出類型。此參數決定如何在 ELT 程序期間從 DynamoDB 資料表匯出資料。
+ `DynamodbUnnestDDBJson` – 布林值。
布林值，指定是否要在資料擷取期間取消巢狀 DynamoDB JSON 格式。設定為 `true` 時，連接器會從 DynamoDB 項目平面化巢狀 JSON 結構。設為 `false` 時，會保留原始 DynamoDB JSON 結構。
+ `DynamodbTableArn` – *必要：*UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
要從中擷取資料的 DynamoDB 資料表的 Amazon Resource Name (ARN)。此參數指定 ELT 操作的來源資料表。
+ `DynamodbS3Bucket` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
在 DynamoDB ELT 程序期間用於中繼儲存的 Amazon S3 儲存貯體名稱。此儲存貯體用於暫時儲存匯出的 DynamoDB 資料，然後再由 ELT 任務處理。
+ `DynamodbS3Prefix` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
在 DynamoDB ELT 程序期間，儲存在中繼 S3 儲存貯體中的檔案的 S3 物件金鑰字首。此字首有助於整理和識別在資料擷取期間建立的暫時檔案。
+ `DynamodbS3BucketOwner` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
中指定之 S3 儲存貯體擁有者 AWS 的帳戶 ID`DynamodbS3Bucket`。當 S3 儲存貯體擁有的帳戶與執行 ELT 任務 AWS 的帳戶不同時，需要此參數，以便跨帳戶存取中繼儲存貯體。
+ `DynamodbStsRoleArn` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
在 ELT 操作期間存取 DynamoDB 和 S3 資源時，要擔任之 AWS 安全字符服務 (STS) 角色的 Amazon Resource Name (ARN)。此角色必須具有從 DynamoDB 資料表讀取和寫入中繼 S3 儲存貯體的必要許可。
## DDBELTCatalogAdditionalOptions 結構
指定 DynamoDB ELT 目錄操作的其他選項。
**欄位**
+ `DynamodbExport` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
指定 ELT 操作的 DynamoDB 匯出組態。
+ `DynamodbUnnestDDBJson` – 布林值。
指定是否要解除巢狀化 DynamoDB JSON 格式。設定為 `true` 時，DynamoDB 項目中的巢狀 JSON 結構會平面化。
## 路由結構
指定路由節點，根據定義的篩選條件將資料導向不同的輸出路徑。
**欄位**
+ `Name` – *必要：*UTF-8 字串，需符合[Custom string pattern #63](aws-glue-api-common.md#regex_63)。
路由節點的名稱。
+ `Inputs` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 1 個字串。
路由節點的輸入連線。
+ `GroupFiltersList` – *必要：*一個 [GroupFilters](#aws-glue-api-visual-job-api-GroupFilters) 物件。
群組篩選條件清單，用於定義將資料導向不同輸出路徑的路由條件和標準。
## GroupFilters 結構
指定具有邏輯運算子的篩選條件群組，該邏輯運算子決定如何組合篩選條件來評估路由條件。
**欄位**
+ `GroupName` – *必要：*UTF-8 字串，需符合[Custom string pattern #60](aws-glue-api-common.md#regex_60)。
篩選條件群組的名稱。
+ `Filters` – *必要：*一個 [FilterExpression](#aws-glue-api-visual-job-api-FilterExpression) 物件。
定義此群組條件的篩選條件表達式清單。
+ `LogicalOperator` – *必要：*UTF-8 字串 (有效值：`AND` \$1 `OR`)。
用於合併此群組中篩選條件的邏輯運算子。決定所有篩選條件都必須相符 (AND) 還是任何篩選條件都必須相符 (OR)。
## AutoDataQuality 結構
指定 AWS Glue 任務中自動資料品質評估的組態選項。此結構可在 ETL 操作期間啟用自動化資料品質檢查和監控，有助於確保資料完整性和可靠性，而無需手動介入。
**欄位**
+ `IsEnabled` – 布林值。
指定是否啟用自動資料品質評估。設為 `true` 時，會自動執行資料品質檢查。
+ `EvaluationContext` – UTF-8 字串，需符合[Custom string pattern #61](aws-glue-api-common.md#regex_61)。
自動資料品質檢查的評估內容。這會定義資料品質評估的範圍和參數。