Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Jenis Koneksi API Connection Type API menjelaskan AWS Glue API untuk mendaftarkan, menjelaskan, menghapus, dan mencantumkan jenis koneksi. ## API manajemen koneksi + [RegisterConnectionType tindakan (Python: register\_connection\_type)](#aws-glue-api-catalog-connections-connections-type-RegisterConnectionType) + [DeleteConnectionType tindakan (Python: delete\_connection\_type)](#aws-glue-api-catalog-connections-connections-type-DeleteConnectionType) + [DescribeConnectionType tindakan (Python: describe\_connection\_type)](#aws-glue-api-catalog-connections-connections-type-DescribeConnectionType) + [ListConnectionTypes tindakan (Python: list\_connection\_types)](#aws-glue-api-catalog-connections-connections-type-ListConnectionTypes) + [ConnectionTypeBrief struktur](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief) + [ConnectionTypeVariant struktur](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant) ## RegisterConnectionType tindakan (Python: register\_connection\_type) Mendaftarkan jenis koneksi khusus AWS Glue berdasarkan konfigurasi yang disediakan. Operasi ini memungkinkan pelanggan untuk mengonfigurasi konektor khusus untuk sumber data apa pun dengan REST-based API, menghilangkan kebutuhan untuk membangun Lambda konektor khusus. Jenis koneksi terdaftar menyimpan detail tentang bagaimana permintaan dan respons ditafsirkan oleh sumber REST, termasuk properti koneksi, konfigurasi otentikasi, dan konfigurasi REST dengan definisi entitas. Setelah terdaftar, pelanggan dapat membuat koneksi menggunakan jenis koneksi ini dan bekerja dengannya dengan cara yang sama seperti AWS Glue konektor yang didukung secara asli. Mendukung beberapa jenis otentikasi termasuk Basic, OAuth2 (KredenSIAL Klien, Pembawa JWT, Kode Otorisasi), dan konfigurasi Auth Kustom. **Permintaan** + `ConnectionType`- * Diperlukan: * UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama jenis koneksi. Harus antara 1 dan 255 karakter dan harus diawali dengan “REST-” untuk menunjukkan itu adalah a REST-based connector. + `IntegrationType`- * Diperlukan: * UTF-8 string (nilai valid:`REST`). Jenis integrasi untuk koneksi. Saat ini hanya protokol “REST” yang didukung. + `Description`— UTF-8 string, tidak lebih dari 1024 byte panjangnya. Deskripsi jenis koneksi. Dapat hingga 2048 karakter dan memberikan rincian tentang tujuan dan fungsionalitas jenis koneksi. + `ConnectionProperties` — *Wajib:* Sebuah objek [ConnectionPropertiesConfiguration](#aws-glue-api-catalog-connections-connections-type-ConnectionPropertiesConfiguration). Mendefinisikan URL dasar dan parameter permintaan tambahan yang diperlukan selama pembuatan koneksi untuk jenis koneksi ini. + `ConnectorAuthenticationConfiguration` — *Wajib:* Sebuah objek [ConnectorAuthenticationConfiguration](#aws-glue-api-catalog-connections-connections-type-ConnectorAuthenticationConfiguration). Mendefinisikan jenis otentikasi yang didukung dan properti yang diperlukan untuk jenis koneksi ini, termasuk metode otentikasi Dasar, OAuth2, dan Kustom. + `RestConfiguration` — *Wajib:* Sebuah objek [RestConfiguration](#aws-glue-api-catalog-connections-connections-type-RestConfiguration). Mendefinisikan konfigurasi permintaan dan respons HTTP, titik akhir validasi, dan konfigurasi entitas untuk interaksi REST API. + `Tags` — Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 50 pasang. Setiap kunci adalah UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Setiap nilai adalah UTF-8 string, panjangnya tidak lebih dari 256 byte. Tag yang Anda tetapkan untuk jenis koneksi. **Respons** Berisi Nama Sumber Daya Amazon (ARN) dari jenis koneksi yang baru terdaftar. + `ConnectionTypeArn`— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 10240 byte, cocok dengan. [Custom string pattern #47](aws-glue-api-common.md#regex_47) Nama Sumber Daya Amazon (ARN) dari jenis koneksi terdaftar. Pengidentifikasi unik ini dapat digunakan untuk mereferensikan jenis koneksi dalam AWS Glue operasi lain. **Kesalahan** + `AlreadyExistsException` + `InvalidInputException` + `OperationTimeoutException` + `ResourceNumberLimitExceededException` + `InternalServiceException` ## DeleteConnectionType tindakan (Python: delete\_connection\_type) Menghapus jenis koneksi khusus di AWS Glue. Jenis koneksi harus ada dan terdaftar sebelum dapat dihapus. Operasi ini mendukung pembersihan sumber daya jenis koneksi dan membantu mempertahankan manajemen siklus hidup yang tepat dari jenis koneksi kustom. **Permintaan** + `ConnectionType`- * Diperlukan: * UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama jenis koneksi yang akan dihapus. Harus mereferensikan jenis koneksi terdaftar yang ada. **Respons** + *Tidak ada parameter Respons. * **Kesalahan** + `EntityNotFoundException` + `InvalidInputException` + `OperationTimeoutException` + `InternalServiceException` + `AccessDeniedException` ## DescribeConnectionType tindakan (Python: describe\_connection\_type) `DescribeConnectionType`API memberikan rincian lengkap opsi yang didukung untuk jenis koneksi tertentu di AWS Glue. Respons mencakup detail konfigurasi otentikasi yang menunjukkan jenis dan properti otentikasi yang didukung, dan RestConfiguration untuk jenis REST-based koneksi khusus yang terdaftar melalui`RegisterConnectionType`. Lihat juga:`ListConnectionTypes`,`RegisterConnectionType`, `DeleteConnectionType` **Permintaan** + `ConnectionType`- * Diperlukan: * UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama jenis koneksi yang akan dijelaskan. **Respons** + `ConnectionType`— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama jenis koneksi. + `Description`— UTF-8 string, tidak lebih dari 1024 byte panjangnya. Deskripsi jenis koneksi. + `Capabilities` — Sebuah objek [Kemampuan](#aws-glue-api-catalog-connections-connections-type-Capabilities). Jenis otentikasi yang didukung, jenis antarmuka data (lingkungan komputasi), dan operasi data dari connector. + `ConnectionProperties` – Susunan peta pasangan nilai kunci. Setiap kunci adalah UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A. Properti koneksi yang umum di seluruh lingkungan komputasi. + `ConnectionOptions` – Susunan peta pasangan nilai kunci. Setiap kunci adalah UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A. Mengembalikan properti yang dapat diatur saat membuat koneksi di`ConnectionInput.ConnectionProperties`. `ConnectionOptions`mendefinisikan parameter yang dapat diatur dalam skrip Spark ETL di peta opsi koneksi yang diteruskan ke kerangka data. + `AuthenticationConfiguration` — Sebuah objek [AuthConfiguration](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration). Jenis otentikasi yang digunakan untuk koneksi. + `ComputeEnvironmentConfigurations` – Susunan peta pasangan nilai kunci. Setiap kunci adalah UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Setiap nilai adalah sebuah objek [ComputeEnvironmentConfiguration](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration) A. Lingkungan komputasi yang didukung oleh koneksi. + `PhysicalConnectionRequirements` – Susunan peta pasangan nilai kunci. Setiap kunci adalah UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A. Persyaratan fisik untuk koneksi, seperti spesifikasi VPC, Subnet, dan Grup Keamanan. + `AthenaConnectionProperties` – Susunan peta pasangan nilai kunci. Setiap kunci adalah UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A. Properti koneksi khusus untuk lingkungan Athena komputasi. + `PythonConnectionProperties` – Susunan peta pasangan nilai kunci. Setiap kunci adalah UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A. Properti koneksi khusus untuk lingkungan komputasi Python. + `SparkConnectionProperties` – Susunan peta pasangan nilai kunci. Setiap kunci adalah UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A. Properti koneksi khusus untuk lingkungan komputasi Spark. + `RestConfiguration` — Sebuah objek [RestConfiguration](#aws-glue-api-catalog-connections-connections-type-RestConfiguration). Konfigurasi permintaan dan respons HTTP, titik akhir validasi, dan konfigurasi entitas untuk sumber data berbasis REST. **Kesalahan** + `ValidationException` + `InvalidInputException` + `InternalServiceException` ## ListConnectionTypes tindakan (Python: list\_connection\_types) `ListConnectionTypes`API menyediakan mekanisme penemuan untuk mempelajari jenis koneksi yang tersedia di AWS Glue. Respons berisi daftar jenis koneksi dengan detail tingkat tinggi tentang apa yang didukung untuk setiap jenis koneksi, termasuk jenis koneksi bawaan dan jenis koneksi khusus yang terdaftar melalui`RegisterConnectionType`. Jenis koneksi yang tercantum adalah kumpulan opsi yang didukung untuk `ConnectionType` nilai di `CreateConnection` API. Lihat juga:`DescribeConnectionType`,`RegisterConnectionType`, `DeleteConnectionType` **Permintaan** + `MaxResults` — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 1000. Jumlah hasil maksimum yang akan dikembalikan. + `NextToken`— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 2048 byte, cocok dengan[Custom string pattern #11](aws-glue-api-common.md#regex_11). Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan. **Respons** + `ConnectionTypes` – Susunan objek [ConnectionTypeBrief](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief). Daftar `ConnectionTypeBrief` objek yang berisi informasi singkat tentang jenis koneksi yang didukung. + `NextToken`— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 2048 byte, cocok dengan[Custom string pattern #11](aws-glue-api-common.md#regex_11). Token lanjutan, jika segmen daftar saat ini bukan yang terakhir. **Kesalahan** + `InternalServiceException` ## ConnectionTypeBrief struktur Informasi singkat tentang jenis koneksi yang didukung dikembalikan oleh `ListConnectionTypes` API. **Bidang** + `ConnectionType`— UTF-8 string (nilai yang valid: `JDBC` \| `SFTP` \| `MONGODB` \| `KAFKA` \| `NETWORK` \| `MARKETPLACE` \| `CUSTOM` \| `SALESFORCE` \| `VIEW_VALIDATION_REDSHIFT` \| \| `VIEW_VALIDATION_ATHENA` \| `GOOGLEADS` \| `GOOGLESHEETS` \| `GOOGLEANALYTICS4` \| `SERVICENOW` \| `MARKETO` \| `SAPODATA` \| `ZENDESK` \| `JIRACLOUD` \| `NETSUITEERP` \| \| `HUBSPOT` \| `FACEBOOKADS` \| `INSTAGRAMADS` \| `ZOHOCRM` \| `SALESFORCEPARDOT` \| `SALESFORCEMARKETINGCLOUD` \| `ADOBEANALYTICS` \| `SLACK` \| `LINKEDIN` \| `MIXPANEL` \| \| `ASANA` \| `STRIPE` \| `SMARTSHEET` \| `DATADOG` \| `WOOCOMMERCE` \| `INTERCOM`\| \| \| `SNAPCHATADS` \| \| `PAYPAL` \| \| `QUICKBOOKS` \| \| `FACEBOOKPAGEINSIGHTS` \| \| `FRESHDESK` \| \| `TWILIO` \| \| `DOCUSIGNMONITOR` \| \| `FRESHSALES` \| \| `ZOOM` \| \| `GOOGLESEARCHCONSOLE` \| \| `SALESFORCECOMMERCECLOUD` \| \| `SAPCONCUR` \| \| \| `DYNATRACE` \| \| `MICROSOFTDYNAMIC365FINANCEANDOPS` \| \| `MICROSOFTTEAMS` \| \| `BLACKBAUDRAISEREDGENXT` \| \| `MAILCHIMP` \| \| `GITLAB` \| \| `PENDO` \| \| `PRODUCTBOARD` \| \| `CIRCLECI` \| \| `PIPEDIVE` \| \| `SENDGRID` \| \| `AZURECOSMOS` \| \| \| `AZURESQL` \| \| `BIGQUERY` \| \| `BLACKBAUD` \| \| `CLOUDERAHIVE` \| \| `CLOUDERAIMPALA` \| \| `CLOUDWATCH` \| \| `CLOUDWATCHMETRICS` \| \| `CMDB` \| \| `DATALAKEGEN2` \| \| `DB2` \| \| `DB2AS400` \| \| `DOCUMENTDB` \| \| `DOMO` \| \| `DYNAMODB`\| `GOOGLECLOUDSTORAGE` \| `HBASE` \| `KUSTOMER` \| `MICROSOFTDYNAMICS365CRM` \| `MONDAY` \| `MYSQL` \| `OKTA` \| `OPENSEARCH` \| `ORACLE` \| `PIPEDRIVE` \| `POSTGRESQL` \| `SAPHANA` \| `SQLSERVER` \| `SYNAPSE` \| `TERADATA` \| `TERADATANOS` \| `TIMESTREAM` \| `TPCDS` \|`VERTICA`). Nama jenis koneksi. + `DisplayName`— UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Nama yang dapat dibaca manusia untuk jenis koneksi yang ditampilkan di AWS Glue konsol. + `Vendor`— UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Nama vendor atau penyedia yang membuat atau memelihara jenis koneksi ini. + `Description`— UTF-8 string, tidak lebih dari 1024 byte panjangnya. Deskripsi jenis koneksi. + `Categories`— Sebuah array UTF-8 string. Daftar kategori yang dimiliki jenis koneksi ini. Kategori membantu pengguna memfilter dan menemukan jenis koneksi yang sesuai berdasarkan kasus penggunaan mereka. + `Capabilities` — Sebuah objek [Kemampuan](#aws-glue-api-catalog-connections-connections-type-Capabilities). Jenis otentikasi yang didukung, jenis antarmuka data (lingkungan komputasi), dan operasi data dari connector. + `LogoUrl`— UTF-8 tali. URL logo yang terkait dengan jenis koneksi. + `ConnectionTypeVariants` – Susunan objek [ConnectionTypeVariant](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant). Daftar varian yang tersedia untuk jenis koneksi ini. Varian yang berbeda dapat menyediakan konfigurasi khusus untuk kasus penggunaan tertentu atau implementasi dari jenis koneksi umum yang sama. ## ConnectionTypeVariant struktur Merupakan varian dari jenis koneksi di AWS Glue. Varian tipe koneksi menyediakan konfigurasi dan perilaku spesifik untuk implementasi yang berbeda dari jenis koneksi umum yang sama. **Bidang** + `ConnectionTypeVariantName`— UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Pengidentifikasi unik untuk varian tipe koneksi. Nama ini digunakan secara internal untuk mengidentifikasi varian spesifik dari jenis koneksi. + `DisplayName`— UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Nama yang dapat dibaca manusia untuk varian jenis koneksi yang ditampilkan di AWS Glue konsol. + `Description`— UTF-8 string, tidak lebih dari 1024 byte panjangnya. Penjelasan rinci tentang varian jenis koneksi, termasuk tujuannya, kasus penggunaan, dan persyaratan konfigurasi tertentu. + `LogoUrl`— UTF-8 tali. URL logo yang terkait dengan varian jenis koneksi. ## tipe data + [Struktur validasi](#aws-glue-api-catalog-connections-connections-type-Validation) + [AuthConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration) + [Struktur kemampuan](#aws-glue-api-catalog-connections-connections-type-Capabilities) + [Struktur properti](#aws-glue-api-catalog-connections-connections-type-Property) + [AllowedValue struktur](#aws-glue-api-catalog-connections-connections-type-AllowedValue) + [ComputeEnvironmentConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration) ## Struktur validasi Mendefinisikan bagaimana validasi dilakukan pada properti koneksi. **Bidang** + `ValidationType`— * Diperlukan: * UTF-8 string (nilai valid: `REGEX` \|`RANGE`). Jenis validasi yang akan dilakukan, seperti`REGEX`. + `Patterns`— Sebuah array UTF-8 string. Daftar pola yang berlaku untuk validasi. + `Description`- * Diperlukan: * UTF-8 string, tidak kurang dari 1 atau lebih dari 1024 byte panjangnya. Deskripsi untuk validasi. + `MaxLength` — Nomor (bilangan bulat). Panjang maksimum untuk properti koneksi string. + `Maximum` — Nomor (bilangan bulat). Nilai maksimum saat menentukan `RANGE` jenis validasi. + `Minimum` — Nomor (bilangan bulat). Nilai minimum saat menentukan `RANGE` jenis validasi. ## AuthConfiguration struktur Konfigurasi otentikasi untuk koneksi yang dikembalikan oleh `DescribeConnectionType` API. **Bidang** + `AuthenticationType` — *Wajib:* Sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property). Jenis otentikasi untuk koneksi. + `SecretArn` — Sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property). Nama Sumber Daya Amazon (ARN) untuk Manajer Rahasia. + `OAuth2Properties` – Susunan peta pasangan nilai kunci. Setiap kunci adalah UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A. Peta pasangan kunci-nilai untuk properti OAuth2. Setiap nilai adalah sebuah `Property` objek. + `BasicAuthenticationProperties` – Susunan peta pasangan nilai kunci. Setiap kunci adalah UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A. Peta pasangan kunci-nilai untuk properti OAuth2. Setiap nilai adalah sebuah `Property` objek. + `CustomAuthenticationProperties` – Susunan peta pasangan nilai kunci. Setiap kunci adalah UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A. Peta pasangan kunci-nilai untuk properti otentikasi kustom. Setiap nilai adalah sebuah `Property` objek. ## Struktur kemampuan Menentukan jenis otentikasi yang didukung dikembalikan oleh `DescribeConnectionType` API. **Bidang** + `SupportedAuthenticationTypes`- * Diperlukan: * Array UTF-8 string. Daftar jenis otentikasi yang didukung. + `SupportedDataOperations`- * Diperlukan: * Array UTF-8 string. Daftar operasi data yang didukung. + `SupportedComputeEnvironments`- * Diperlukan: * Array UTF-8 string. Daftar lingkungan komputasi yang didukung. ## Struktur properti Objek yang mendefinisikan tipe koneksi untuk lingkungan komputasi. **Bidang** + `Name`- * Diperlukan: * UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Nama properti. + `Description`- * Diperlukan: * UTF-8 string, panjangnya tidak lebih dari 1024 byte. Deskripsi properti. + `Required` – *Wajib:* Boolean. Menunjukkan apakah properti diperlukan. + `DefaultValue`— UTF-8 tali. Nilai default untuk properti. + `PropertyTypes`- * Diperlukan: * Array UTF-8 string. Menjelaskan jenis properti. + `AllowedValues` – Susunan objek [AllowedValue](#aws-glue-api-catalog-connections-connections-type-AllowedValue). Daftar `AllowedValue` objek yang mewakili nilai yang diizinkan untuk properti. + `DataOperationScopes`— Sebuah array UTF-8 string. Menunjukkan operasi data mana yang berlaku untuk properti. + `KeyOverride`— UTF-8 tali. Nama kunci yang digunakan saat mengirim properti ini dalam permintaan API, jika berbeda dari nama tampilan. + `PropertyLocation`— UTF-8 string (nilai valid: `HEADER` \| `BODY` \| `QUERY_PARAM` \|`PATH`). Menentukan di mana properti ini harus disertakan dalam permintaan REST, seperti di header, parameter kueri, atau badan permintaan. ## AllowedValue struktur Objek yang mewakili nilai yang diizinkan untuk properti. **Bidang** + `Description`— UTF-8 string, tidak lebih dari 1024 byte panjangnya. Deskripsi nilai yang diizinkan. + `Value`- * Diperlukan: * UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Nilai yang diizinkan untuk properti. ## ComputeEnvironmentConfiguration struktur Objek yang berisi konfigurasi untuk lingkungan komputasi (seperti Spark, Python atau Athena) dikembalikan oleh API. `DescribeConnectionType` **Bidang** + `Name`- * Diperlukan: * UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Nama untuk konfigurasi lingkungan komputasi. + `Description`- * Diperlukan: * UTF-8 string, panjangnya tidak lebih dari 1024 byte. Deskripsi lingkungan komputasi. + `ComputeEnvironment`— * Diperlukan: * UTF-8 string (nilai valid: `SPARK` \| `ATHENA` \|`PYTHON`). Tipe lingkungan komputasi. + `SupportedAuthenticationTypes`- * Diperlukan: * Array UTF-8 string. Jenis otentikasi yang didukung untuk lingkungan komputasi. + `ConnectionOptions` – *Wajib:* Susunan peta pasangan nilai kunci. Setiap kunci adalah UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A. Parameter yang digunakan sebagai opsi koneksi untuk lingkungan komputasi. + `ConnectionPropertyNameOverrides` – *Wajib:* Susunan peta pasangan nilai kunci. Setiap kunci adalah UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Setiap nilai adalah UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Nama properti koneksi diganti untuk lingkungan komputasi. + `ConnectionOptionNameOverrides` – *Wajib:* Susunan peta pasangan nilai kunci. Setiap kunci adalah UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Setiap nilai adalah UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Nama opsi koneksi diganti untuk lingkungan komputasi. + `ConnectionPropertiesRequiredOverrides`- * Diperlukan: * Array UTF-8 string. Properti koneksi yang diperlukan sebagai penggantian untuk lingkungan komputasi. + `PhysicalConnectionPropertiesRequired` – Boolean. Menunjukkan `PhysicalConnectionProperties` apakah diperlukan untuk lingkungan komputasi. ## Jenis data konektor khusus + [ConnectionPropertiesConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-ConnectionPropertiesConfiguration) + [ConnectorAuthenticationConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-ConnectorAuthenticationConfiguration) + [ConnectorProperty struktur](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty) + [RestConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-RestConfiguration) + [SourceConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-SourceConfiguration) + [EntityConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-EntityConfiguration) + [ResponseConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-ResponseConfiguration) + [ResponseExtractionMapping struktur](#aws-glue-api-catalog-connections-connections-type-ResponseExtractionMapping) + [PaginationConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-PaginationConfiguration) + [CursorConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-CursorConfiguration) + [OffsetConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-OffsetConfiguration) + [ExtractedParameter struktur](#aws-glue-api-catalog-connections-connections-type-ExtractedParameter) + [FieldDefinition struktur](#aws-glue-api-catalog-connections-connections-type-FieldDefinition) + [ConnectorOAuth2Properties struktur](#aws-glue-api-catalog-connections-connections-type-ConnectorOAuth2Properties) + [ClientCredentialsProperties struktur](#aws-glue-api-catalog-connections-connections-type-ClientCredentialsProperties) + [JWTBearerProperties struktur](#aws-glue-api-catalog-connections-connections-type-JWTBearerProperties) + [ConnectorAuthorizationCodeProperties struktur](#aws-glue-api-catalog-connections-connections-type-ConnectorAuthorizationCodeProperties) + [BasicAuthenticationProperties struktur](#aws-glue-api-catalog-connections-connections-type-BasicAuthenticationProperties) + [CustomAuthenticationProperties struktur](#aws-glue-api-catalog-connections-connections-type-CustomAuthenticationProperties) + [FilterConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-FilterConfiguration) + [FilterOverrides struktur](#aws-glue-api-catalog-connections-connections-type-FilterOverrides) + [BetweenConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-BetweenConfiguration) + [FilterStringConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-FilterStringConfiguration) ## ConnectionPropertiesConfiguration struktur Konfigurasi yang mendefinisikan URL dasar dan parameter permintaan tambahan yang diperlukan selama pembuatan koneksi. **Bidang** + `Url` — Sebuah objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). URL instance dasar untuk titik akhir yang akan dihubungkan oleh jenis koneksi ini. + `AdditionalRequestParameters` – Susunan objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Key-value pasangan parameter permintaan tambahan yang mungkin diperlukan selama pembuatan koneksi, seperti versi API atau opsi konfigurasi khusus layanan. ## ConnectorAuthenticationConfiguration struktur Konfigurasi yang mendefinisikan jenis otentikasi yang didukung dan properti yang diperlukan untuk jenis koneksi. **Bidang** + `AuthenticationTypes`- * Diperlukan: * Array UTF-8 string. Daftar jenis otentikasi yang didukung oleh jenis koneksi ini, seperti Basic, OAuth2, atau metode otentikasi Kustom. ## ConnectorProperty struktur Mendefinisikan konfigurasi properti untuk jenis koneksi, nilai default, dan di mana properti harus digunakan dalam permintaan. **Bidang** + `Name`- * Diperlukan: * UTF-8 string, tidak kurang dari 1 atau lebih dari 128 byte panjangnya. Nama properti. + `KeyOverride`— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 128 byte, cocok dengan[Custom string pattern #15](aws-glue-api-common.md#regex_15). Nama kunci yang digunakan saat mengirim properti ini dalam permintaan API, jika berbeda dari nama tampilan. + `Required` – *Wajib:* Boolean. Menunjukkan apakah properti diperlukan. + `DefaultValue`— UTF-8 tali. Nilai default untuk properti. + `AllowedValues`— Sebuah array UTF-8 string. Daftar `AllowedValue` objek yang mewakili nilai-nilai yang diizinkan untuk properti. + `PropertyLocation`— UTF-8 string (nilai valid: `HEADER` \| `BODY` \| `QUERY_PARAM` \|`PATH`). Menentukan di mana properti ini harus disertakan dalam permintaan REST, seperti di header, parameter kueri, atau badan permintaan. + `PropertyType`— * Diperlukan: * UTF-8 string (nilai valid: `USER_INPUT` \| `SECRET` \| `READ_ONLY` \| `UNUSED` \|`SECRET_OR_USER_INPUT`). Tipe data properti ini + `Format`— UTF-8 tali. Template format untuk nilai properti yang menentukan bagaimana nilai harus diformat sebelum mengirimkannya dalam permintaan API. Gunakan `{value}` sebagai placeholder untuk nilai properti aktual (misalnya,`SSWS {value}`). ## RestConfiguration struktur Konfigurasi yang mendefinisikan permintaan HTTP dan penanganan respons, titik akhir validasi, dan konfigurasi entitas untuk interaksi REST API. **Bidang** + `GlobalSourceConfiguration` — Sebuah objek [SourceConfiguration](#aws-glue-api-catalog-connections-connections-type-SourceConfiguration). Setelan konfigurasi global yang berlaku untuk semua permintaan REST API untuk jenis koneksi ini, termasuk metode permintaan umum, jalur, dan parameter. + `ValidationEndpointConfiguration` — Sebuah objek [SourceConfiguration](#aws-glue-api-catalog-connections-connections-type-SourceConfiguration). Konfigurasi untuk titik akhir yang digunakan untuk memvalidasi kredentif koneksi dan menguji konektivitas selama pembuatan koneksi. + `EntityConfigurations` – Susunan peta pasangan nilai kunci. Setiap kunci adalah UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 128 byte, cocok dengan[Custom string pattern #12](aws-glue-api-common.md#regex_12). Setiap nilai adalah sebuah objek [EntityConfiguration](#aws-glue-api-catalog-connections-connections-type-EntityConfiguration). Peta konfigurasi entitas yang menentukan cara berinteraksi dengan entitas data yang berbeda yang tersedia melalui REST API, termasuk skema dan pola aksesnya. ## SourceConfiguration struktur Konfigurasi yang mendefinisikan cara membuat permintaan ke titik akhir, termasuk metode permintaan, jalur, parameter, dan penanganan respons. **Bidang** + `RequestMethod`— UTF-8 string (nilai valid: `GET` \|`POST`). Metode HTTP yang digunakan untuk permintaan ke titik akhir ini, seperti GET, POST. + `RequestPath`— UTF-8 string, tidak kurang dari 1 atau lebih dari 512 byte panjang, cocok dengan[Custom string pattern #14](aws-glue-api-common.md#regex_14). Jalur URL untuk titik akhir REST, yang mungkin menyertakan placeholder parameter yang akan diganti dengan nilai aktual selama permintaan. + `RequestParameters` – Susunan objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Konfigurasi untuk parameter permintaan yang harus disertakan dalam panggilan API, seperti parameter kueri, header, atau isi isi. + `ResponseConfiguration` — Sebuah objek [ResponseConfiguration](#aws-glue-api-catalog-connections-connections-type-ResponseConfiguration). Konfigurasi yang menentukan cara mengurai dan mengekstrak data dari respons API, termasuk keberhasilan dan penanganan kesalahan. + `PaginationConfiguration` — Sebuah objek [PaginationConfiguration](#aws-glue-api-catalog-connections-connections-type-PaginationConfiguration). Konfigurasi untuk menangani respons berpaginasi dari REST API, mendukung strategi pagination berbasis kursor dan offset. + `FilterConfiguration` — Sebuah objek [FilterConfiguration](#aws-glue-api-catalog-connections-connections-type-FilterConfiguration). Konfigurasi untuk menerapkan pushdown filter ke permintaan REST API, menentukan bagaimana predikat filter diterjemahkan ke dalam parameter kueri atau string filter. ## EntityConfiguration struktur Konfigurasi yang mendefinisikan cara berinteraksi dengan entitas data tertentu melalui REST API, termasuk pola akses dan definisi skema. **Bidang** + `SourceConfiguration` — Sebuah objek [SourceConfiguration](#aws-glue-api-catalog-connections-connections-type-SourceConfiguration). Konfigurasi sumber yang mendefinisikan cara membuat permintaan untuk mengakses data entitas ini melalui REST API. + `Schema` – Susunan peta pasangan nilai kunci. Setiap kunci adalah UTF-8 string, setidaknya 1 byte panjangnya. Setiap nilai adalah sebuah objek [FieldDefinition](#aws-glue-api-catalog-connections-connections-type-FieldDefinition) A. Definisi skema untuk entitas ini, termasuk nama bidang, tipe, dan metadata lain yang menjelaskan struktur data. ## ResponseConfiguration struktur Konfigurasi yang mendefinisikan cara mengurai respons JSON dari panggilan REST API, termasuk jalur ke data hasil dan informasi kesalahan. **Bidang** + `ResultPath`- * Diperlukan: * UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 512 byte, cocok dengan[Custom string pattern #10](aws-glue-api-common.md#regex_10). Ekspresi jalur JSON yang mengidentifikasi di mana data hasil aktual berada dalam respons API. + `ErrorPath`— UTF-8 string, tidak kurang dari 1 atau lebih dari 512 byte panjang, cocok dengan[Custom string pattern #10](aws-glue-api-common.md#regex_10). Ekspresi jalur JSON yang mengidentifikasi lokasi informasi kesalahan dalam respons API saat permintaan gagal. ## ResponseExtractionMapping struktur Konfigurasi yang mendefinisikan cara mengekstrak nilai dari konten respon HTTP atau header untuk digunakan dalam permintaan berikutnya atau pemetaan parameter. **Bidang** + `ContentPath`— UTF-8 string, tidak kurang dari 1 atau lebih dari 512 byte panjang, cocok dengan[Custom string pattern #10](aws-glue-api-common.md#regex_10). Ekspresi jalur JSON yang menentukan cara mengekstrak nilai dari konten badan respons. + `HeaderKey`— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 128 byte, cocok dengan[Custom string pattern #15](aws-glue-api-common.md#regex_15). Nama header respons HTTP untuk mengekstrak nilainya. ## PaginationConfiguration struktur Konfigurasi yang mendefinisikan cara menangani respons berpaginasi dari REST API, mendukung strategi pagination berbeda yang digunakan oleh berbagai layanan. **Bidang** + `CursorConfiguration` — Sebuah objek [CursorConfiguration](#aws-glue-api-catalog-connections-connections-type-CursorConfiguration). Konfigurasi untuk paginasi berbasis kursor, di mana API menyediakan kursor atau token untuk mengambil halaman hasil berikutnya. + `OffsetConfiguration` — Sebuah objek [OffsetConfiguration](#aws-glue-api-catalog-connections-connections-type-OffsetConfiguration). Konfigurasi untuk paginasi berbasis offset, di mana API menggunakan offset numerik dan batas untuk mengontrol hasil mana yang dikembalikan. ## CursorConfiguration struktur Cursor-based konfigurasi pagination yang mendefinisikan cara menangani pagination menggunakan token kursor atau pengidentifikasi halaman berikutnya. **Bidang** + `NextPage` — *Wajib:* Sebuah objek [ExtractedParameter](#aws-glue-api-catalog-connections-connections-type-ExtractedParameter). Nama parameter atau jalur JSON yang berisi kursor atau token untuk mengambil halaman hasil berikutnya. + `LimitParameter` — Sebuah objek [ExtractedParameter](#aws-glue-api-catalog-connections-connections-type-ExtractedParameter). Nama parameter yang digunakan untuk menentukan jumlah maksimum hasil yang akan dikembalikan per halaman. ## OffsetConfiguration struktur Offset-based konfigurasi pagination yang mendefinisikan bagaimana menangani pagination menggunakan offset numerik dan batas. **Bidang** + `OffsetParameter` — *Wajib:* Sebuah objek [ExtractedParameter](#aws-glue-api-catalog-connections-connections-type-ExtractedParameter). Nama parameter yang digunakan untuk menentukan posisi awal atau offset untuk mengambil hasil. + `LimitParameter` — *Wajib:* Sebuah objek [ExtractedParameter](#aws-glue-api-catalog-connections-connections-type-ExtractedParameter). Nama parameter yang digunakan untuk menentukan jumlah maksimum hasil yang akan dikembalikan per halaman. ## ExtractedParameter struktur Konfigurasi ekstraksi parameter yang mendefinisikan cara mengekstrak dan memetakan nilai dari respons API ke parameter permintaan. **Bidang** + `Key`— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 128 byte, cocok dengan[Custom string pattern #15](aws-glue-api-common.md#regex_15). Nama kunci parameter yang akan digunakan dalam permintaan berikutnya. + `DefaultValue`— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 1024 byte, cocok dengan[Custom string pattern #16](aws-glue-api-common.md#regex_16). Nilai default untuk digunakan jika parameter tidak dapat diekstraksi dari respons. + `PropertyLocation`— UTF-8 string (nilai valid: `HEADER` \| `BODY` \| `QUERY_PARAM` \|`PATH`). Menentukan di mana parameter yang diekstraksi ini harus ditempatkan dalam permintaan berikutnya, seperti di header, parameter kueri, atau badan permintaan. + `Value` — Sebuah objek [ResponseExtractionMapping](#aws-glue-api-catalog-connections-connections-type-ResponseExtractionMapping). Jalur JSON atau pemetaan ekstraksi yang mendefinisikan cara mengekstrak nilai parameter dari respons API. ## FieldDefinition struktur Mendefinisikan bidang dalam skema entitas untuk sumber data konektor REST, menentukan nama bidang dan tipe data. **Bidang** + `Name`- * Diperlukan: * UTF-8 string. Nama bidang dalam skema entitas. + `FieldDataType`— * Diperlukan: * UTF-8 string (nilai yang valid: `INT` `SMALLINT` \| `BIGINT` \| `FLOAT` \| `LONG` \| `DATE` \| `BOOLEAN` \| `MAP` \| `ARRAY` \| `STRING` \| `TIMESTAMP` \| `DECIMAL` \| \| `BYTE` \| `SHORT` \| `DOUBLE` \| `STRUCT` \| `BINARY` \|`UNION`). Jenis data bidang. + `ResponseDateFormat`— UTF-8 tali. Pola format untuk mengurai nilai tanggal dari respons API. Diperlukan saat API menggunakan non- ISO-8601 format. `DateTimeFormatter`Menerima pola Java (misalnya,`EEE, d MMM yyyy HH:mm:ss Z`), `EPOCH_SECONDS` untuk detik zaman Unix, atau `EPOCH_MILLIS` untuk milidetik zaman Unix. + `IsPartitionable` – Boolean. Menunjukkan apakah bidang ini dapat digunakan untuk mempartisi kueri ke sumber data. + `IsNullable` – Boolean. Menunjukkan apakah bidang ini dapat berisi nilai null. + `IsQueryable` – Boolean. Menunjukkan apakah bidang ini dapat digunakan dalam predikat filter saat menanyakan data. + `IsOrderable` – Boolean. Menunjukkan apakah bidang ini dapat digunakan untuk mengurutkan hasil. + `FilterOverrides` — Sebuah objek [FilterOverrides](#aws-glue-api-catalog-connections-connections-type-FilterOverrides). Per-field mengganti perilaku filter, memungkinkan penyesuaian bagaimana filter diterapkan ke bidang khusus ini. ## ConnectorOAuth2Properties struktur Wadah konfigurasi OAuth2 yang mendefinisikan properti otentikasi dan konfigurasi aliran spesifik untuk koneksi. OAuth2-based **Bidang** + `OAuth2GrantType`— * Diperlukan: * UTF-8 string (nilai valid: `CLIENT_CREDENTIALS` \| `JWT_BEARER` \|`AUTHORIZATION_CODE`). Jenis pemberian OAuth2 untuk digunakan untuk otentikasi, seperti CLIENT\_CREDENTIALS, JWT\_BEARER, atau AUTHORIZATION\_CODE. + `ClientCredentialsProperties` — Sebuah objek [ClientCredentialsProperties](#aws-glue-api-catalog-connections-connections-type-ClientCredentialsProperties). Properti konfigurasi khusus untuk aliran jenis pemberian Kredensi Klien OAuth2. + `JWTBearerProperties` — Sebuah objek [JWTBearerProperties](#aws-glue-api-catalog-connections-connections-type-JWTBearerProperties). Properti konfigurasi khusus untuk aliran jenis hibah OAuth2 JWT Bearer. + `AuthorizationCodeProperties` — Sebuah objek [ConnectorAuthorizationCodeProperties](#aws-glue-api-catalog-connections-connections-type-ConnectorAuthorizationCodeProperties). Properti konfigurasi khusus untuk aliran jenis pemberian Kode Ootorisasi OAuth2. ## ClientCredentialsProperties struktur Konfigurasi kredenSIAL klien OAuth2 yang mendefinisikan properti yang diperlukan untuk aliran jenis pemberian Kredensi Klien. **Bidang** + `TokenUrl` — Sebuah objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). URL titik akhir token tempat klien akan meminta token akses menggunakan kredenSIAL klien. + `RequestMethod`— UTF-8 string (nilai valid: `GET` \|`POST`). Metode HTTP yang digunakan saat membuat permintaan token, biasanya POST. + `ContentType`— UTF-8 string (nilai valid: `APPLICATION_JSON` \|`URL_ENCODED`). Jenis konten yang digunakan untuk permintaan token, seperti application/x -www-form-urlencoded atau. application/json + `ClientId` — Sebuah objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Pengidentifikasi klien OAuth2 disediakan oleh server otorisasi. + `ClientSecret` — Sebuah objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Rahasia klien OAuth2 disediakan oleh server otorisasi. + `Scope` — Sebuah objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Cakupan OAuth2 yang mendefinisikan tingkat akses yang diminta untuk alur kredenSIAL klien. + `TokenUrlParameters` – Susunan objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Parameter tambahan untuk disertakan dalam permintaan URL token sebagai pasangan kunci-nilai. ## JWTBearerProperties struktur Konfigurasi token pembawa JWT yang mendefinisikan properti yang diperlukan untuk aliran jenis hibah JWT Bearer. **Bidang** + `TokenUrl` — Sebuah objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). URL titik akhir token tempat token pembawa JWT akan ditukar dengan token akses. + `RequestMethod`— UTF-8 string (nilai valid: `GET` \|`POST`). Metode HTTP yang digunakan saat membuat permintaan token pembawa JWT, biasanya POST. + `ContentType`— UTF-8 string (nilai valid: `APPLICATION_JSON` \|`URL_ENCODED`). Jenis konten yang digunakan untuk permintaan token pembawa JWT, seperti application/x -www-form-urlencoded atau. application/json + `JwtToken` — Sebuah objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Token JWT yang akan digunakan dalam aliran hibah token pembawa untuk otentikasi. + `TokenUrlParameters` – Susunan objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Parameter tambahan untuk disertakan dalam permintaan URL token sebagai pasangan kunci-nilai. ## ConnectorAuthorizationCodeProperties struktur Konfigurasi kode otorisasi OAuth2 yang mendefinisikan properti yang diperlukan untuk aliran jenis pemberian Kode Otorisasi. **Bidang** + `AuthorizationCodeUrl` — Sebuah objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). URL titik akhir otorisasi tempat pengguna akan diarahkan untuk memberikan otorisasi. + `AuthorizationCode` — Sebuah objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Kode otorisasi diterima dari server otorisasi setelah persetujuan pengguna. + `RedirectUri` — Sebuah objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). URI pengalihan yang harus cocok dengan URI yang terdaftar dengan server otorisasi. + `TokenUrl` — Sebuah objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). URL titik akhir token tempat kode otorisasi akan ditukar dengan token akses. + `RequestMethod`— UTF-8 string (nilai valid: `GET` \|`POST`). Metode HTTP yang digunakan saat membuat permintaan pertukaran token, biasanya POST. + `ContentType`— UTF-8 string (nilai valid: `APPLICATION_JSON` \|`URL_ENCODED`). Jenis konten yang digunakan untuk permintaan pertukaran token, seperti application/x -www-form-urlencoded atau. application/json + `ClientId` — Sebuah objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Pengidentifikasi klien OAuth2 disediakan oleh server otorisasi. + `ClientSecret` — Sebuah objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Rahasia klien OAuth2 disediakan oleh server otorisasi. + `Scope` — Sebuah objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Cakupan OAuth2 yang mendefinisikan tingkat akses yang diminta untuk aliran kode otorisasi. + `Prompt` — Sebuah objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Parameter prompt OAuth2 yang mengontrol perilaku server otorisasi selama otentikasi pengguna. + `TokenUrlParameters` – Susunan objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Parameter tambahan untuk disertakan dalam permintaan URL token sebagai pasangan kunci-nilai. ## BasicAuthenticationProperties struktur Konfigurasi otentikasi dasar yang mendefinisikan properti nama pengguna dan kata sandi untuk otentikasi dasar HTTP. **Bidang** + `Username` — Sebuah objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Nama properti username yang akan digunakan untuk kredentif otentikasi Dasar. + `Password` — Sebuah objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Nama properti kata sandi yang akan digunakan untuk kredentif otentikasi Dasar. ## CustomAuthenticationProperties struktur Konfigurasi otentikasi khusus yang memungkinkan mekanisme otentikasi fleksibel di luar aliran Basic dan OAuth2 standar. **Bidang** + `AuthenticationParameters` – *Wajib:* Susunan objek [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Peta parameter otentikasi khusus yang menentukan mekanisme otentikasi spesifik dan properti yang diperlukan. ## FilterConfiguration struktur Konfigurasi yang mendefinisikan bagaimana predikat filter diterapkan ke permintaan REST API, mendukung parameter kueri dan strategi string filter. **Bidang** + `FilterMode`— * Diperlukan: * UTF-8 string (nilai valid: `QUERY_PARAMS` \|`FILTER_STRING`). Strategi untuk menerapkan filter ke permintaan. Gunakan `QUERY_PARAMS` untuk meneruskan filter sebagai parameter kueri individu, atau `FILTER_STRING` untuk membangun string ekspresi filter tunggal. + `OperatorMappings` – Susunan peta pasangan nilai kunci. Setiap kunci adalah UTF-8 string. Setiap nilai adalah UTF-8 string. Peta operator filter logis ke representasi API-specific string mereka. Kunci operator yang didukung adalah: `EQUAL_TO` `NOT_EQUAL_TO``LESS_THAN`,,`GREATER_THAN`,`LESS_THAN_OR_EQUAL_TO`,`GREATER_THAN_OR_EQUAL_TO`,`CONTAINS`,`BETWEEN`,`AND`, dan`OR`. + `DateTimeFormat`— UTF-8 tali. Format tanggal dan waktu global untuk ekspresi filter. `DateTimeFormatter`Menerima pola Java (misalnya,`EEE, d MMM yyyy HH:mm:ss Z`), `EPOCH_SECONDS` untuk detik zaman Unix, atau `EPOCH_MILLIS` untuk milidetik zaman Unix. Jika tidak ditentukan, nilai diteruskan apa adanya dalam ISO-8601 format. + `StripQuotes` – Boolean. Menunjukkan apakah tanda kutip ganda di sekitarnya harus dilucuti dari nilai filter sebelum diproses. + `BetweenConfiguration` — Sebuah objek [BetweenConfiguration](#aws-glue-api-catalog-connections-connections-type-BetweenConfiguration). Konfigurasi untuk menangani operasi filter rentang BETWEEN. + `FilterStringConfiguration` — Sebuah objek [FilterStringConfiguration](#aws-glue-api-catalog-connections-connections-type-FilterStringConfiguration). Konfigurasi untuk membangun ekspresi filter ketika `FilterMode` disetel ke`FILTER_STRING`. ## FilterOverrides struktur Konfigurasi yang mendefinisikan penggantian per bidang untuk perilaku filter, memungkinkan masing-masing bidang menyesuaikan cara operasi filter diterapkan. **Bidang** + `FieldName`— UTF-8 tali. Penggantian nama bidang yang akan digunakan dalam ekspresi filter, jika berbeda dari nama bidang skema. + `OperatorMappings` – Susunan peta pasangan nilai kunci. Setiap kunci adalah UTF-8 string. Setiap nilai adalah UTF-8 string. Peta operator filter logis ke representasi API khusus bidang mereka, mengesampingkan pemetaan operator global. Kunci operator yang didukung adalah: `EQUAL_TO` `NOT_EQUAL_TO``LESS_THAN`,,`GREATER_THAN`,`LESS_THAN_OR_EQUAL_TO`,`GREATER_THAN_OR_EQUAL_TO`,`CONTAINS`,`BETWEEN`,`AND`, dan`OR`. + `BetweenConfiguration` — Sebuah objek [BetweenConfiguration](#aws-glue-api-catalog-connections-connections-type-BetweenConfiguration). Field-specific konfigurasi untuk menangani operasi filter rentang ANTARA. + `DateTimeFormat`— UTF-8 tali. Format tanggal dan waktu untuk ekspresi filter pada bidang ini, mengesampingkan global`DateTimeFormat`. `DateTimeFormatter`Menerima pola Java (misalnya,`EEE, d MMM yyyy HH:mm:ss Z`), `EPOCH_SECONDS` untuk detik zaman Unix, atau `EPOCH_MILLIS` untuk milidetik zaman Unix. ## BetweenConfiguration struktur Konfigurasi yang mendefinisikan bagaimana operasi filter rentang BETWEEN diterjemahkan ke dalam parameter permintaan REST API. **Bidang** + `LowBoundKey`— UTF-8 tali. Nama parameter yang digunakan untuk nilai batas bawah dalam operasi filter BETWEEN. + `HighBoundKey`— UTF-8 tali. Nama parameter yang digunakan untuk nilai batas atas dalam operasi filter BETWEEN. + `Template`— UTF-8 tali. String template untuk membangun ekspresi filter BETWEEN. ## FilterStringConfiguration struktur Konfigurasi untuk membangun string ekspresi filter saat menggunakan mode `FILTER_STRING` filter. **Bidang** + `QueryParameterName`- * Diperlukan: * UTF-8 string. Nama parameter kueri yang digunakan untuk mengirim string ekspresi filter yang dibangun dalam permintaan API. + `QuoteStringValues` – Boolean. Menunjukkan apakah nilai string dan tanggal harus dibungkus dengan karakter kutipan dalam ekspresi filter. + `QuoteCharacter`— UTF-8 tali. Karakter yang digunakan untuk mengutip nilai ketika `QuoteStringValues` benar. Defaultnya adalah tanda kutip ganda jika tidak ditentukan.