Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Membuat konektor sumber data Anda dapat membuat konektor sumber data Amazon Kendra untuk menghubungkan dan mengindeks dokumen Anda. Amazon Kendra dapat terhubung ke Microsoft SharePoint, Google Drive, dan banyak penyedia lainnya. Saat Anda membuat konektor sumber data, Anda memberikan informasi konfigurasi Amazon Kendra yang diperlukan untuk terhubung ke repositori sumber Anda. Tidak seperti menambahkan dokumen langsung ke indeks, Anda dapat memindai sumber data secara berkala untuk memperbarui indeks. Misalnya, katakanlah Anda memiliki gudang dokumen pajak yang disimpan dalam ember. Amazon S3 Dari waktu ke waktu, dokumen yang ada diubah dan dokumen baru ditambahkan ke repositori. Jika Anda menambahkan repositori Amazon Kendra sebagai sumber data, Anda dapat memperbarui indeks Anda dengan mengatur sinkronisasi berkala antara sumber data dan indeks Anda. Anda dapat memilih untuk memperbarui indeks secara manual menggunakan konsol atau [StartDataSourceSyncJob](https://docs.aws.amazon.com/kendra/latest/APIReference/API_StartDataSourceSyncJob.html)API. Jika tidak, Anda mengatur jadwal untuk memperbarui indeks dan menyinkronkannya dengan sumber data Anda. Indeks dapat memiliki lebih dari satu sumber data. Setiap sumber data dapat memiliki jadwal pembaruannya sendiri. Misalnya, Anda dapat memperbarui indeks dokumen kerja Anda setiap hari, atau bahkan per jam, sembari memperbarui dokumen yang diarsipkan secara manual kapan pun arsip berubah. [Jika Anda ingin mengubah metadata dokumen atau atribut dan konten selama proses konsumsi dokumen, lihat Pengayaan Dokumen Kustom.Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html) **catatan** Setiap ID dokumen harus unik per indeks. Anda tidak dapat membuat sumber data untuk mengindeks dokumen Anda dengan IDs keunikannya dan kemudian menggunakan `BatchPutDocument` API untuk mengindeks dokumen yang sama, atau sebaliknya. Anda dapat menghapus sumber data dan kemudian menggunakan `BatchPutDocument` API untuk mengindeks dokumen yang sama, atau sebaliknya. Menggunakan `BatchPutDocument` dan `BatchDeleteDocument` APIs dalam kombinasi dengan konektor sumber Amazon Kendra data untuk kumpulan dokumen yang sama dapat menyebabkan ketidakkonsistenan dengan data Anda. Sebagai gantinya, sebaiknya gunakan [konektor sumber data Amazon Kendra khusus](https://docs.aws.amazon.com/kendra/latest/dg/data-source-custom.html). **catatan** File yang ditambahkan ke indeks harus dalam pengaliran byte yang dikodekan dengan UTF-8. Untuk informasi selengkapnya tentang dokumen di Amazon Kendra, lihat [Dokumen](https://docs.aws.amazon.com/kendra/latest/dg/hiw-documents.html). ## Mengatur jadwal pembaruan Konfigurasikan sumber data Anda untuk diperbarui secara berkala dengan konsol tersebut atau menggunakan parameter `Schedule` saat membuat atau memperbarui sumber data. Isi parameter adalah string yang menyimpan string jadwal `cron` -format atau string kosong untuk menunjukkan bahwa indeks diperbarui sesuai permintaan. Untuk format ekspresi cron, lihat [Menjadwalkan Ekspresi untuk Aturan](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html) di *Panduan Amazon CloudWatch Events Pengguna*. Amazon Kendra hanya mendukung ekspresi cron. Itu tidak mendukung ekspresi tingkat. ## Mengatur bahasa Anda dapat mengindeks semua dokumen Anda dalam sumber data dalam bahasa yang didukung. Anda menentukan kode bahasa untuk semua dokumen Anda di sumber data Anda saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Jika dokumen tidak memiliki kode bahasa yang ditentukan dalam bidang metadata, dokumen diindeks menggunakan kode bahasa yang ditentukan untuk semua dokumen di tingkat sumber data. Jika Anda tidak menentukan bahasa, Amazon Kendra indeks dokumen dalam sumber data dalam bahasa Inggris secara default. Untuk informasi selengkapnya tentang bahasa yang didukung, termasuk kodenya, lihat [Menambahkan dokumen dalam bahasa selain bahasa Inggris](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-languages.html). Anda mengindeks semua dokumen dalam sumber data dalam bahasa yang didukung menggunakan konsol. Buka **Sumber data** dan edit sumber data Anda atau **Tambahkan sumber data** jika Anda menambahkan sumber data baru. **Pada halaman **Tentukan detail sumber data**, pilih bahasa dari Bahasa tarik-turun.** Anda memilih **Perbarui** atau terus memasukkan informasi konfigurasi untuk terhubung ke sumber data Anda. # Konektor sumber data Bagian ini menunjukkan kepada Anda cara menghubungkan Amazon Kendra ke database yang didukung dan repositori sumber data menggunakan Amazon Kendra dalam dan file. Konsol Manajemen AWS Amazon Kendra APIs **Topics** + [Skema templat sumber data](ds-schemas.md) + [Adobe Experience Manager](data-source-aem.md) + [Alfresco](data-source-alfresco.md) + [Aurora(MySQL)](data-source-aurora-mysql.md) + [Aurora(PostgreSQL)](data-source-aurora-postgresql.md) + [Amazon FSx(Jendela)](data-source-fsx.md) + [Amazon FSx(NetApp ONTAP)](data-source-fsx-ontap.md) + [Amazon RDS/Aurora](data-source-database.md) + [Amazon RDS(Microsoft SQL Server)](data-source-rds-ms-sql-server.md) + [Amazon RDS(MySQL)](data-source-rds-mysql.md) + [Amazon RDS(Oracle)](data-source-rds-oracle.md) + [Amazon RDS(PostgreSQL)](data-source-rds-postgresql.md) + [Amazon S3](data-source-s3.md) + [Amazon Kendra Perayap Web](data-source-web-crawler.md) + [Box](data-source-box.md) + [Confluence](data-source-confluence.md) + [Konektor sumber data khusus](data-source-custom.md) + [Dropbox](data-source-dropbox.md) + [Drupal](data-source-drupal.md) + [GitHub](data-source-github.md) + [Gmail](data-source-gmail.md) + [Google Drive](data-source-google-drive.md) + [IBM DB2](data-source-ibm-db2.md) + [Jira](data-source-jira.md) + [Microsoft Exchange](data-source-exchange.md) + [Microsoft OneDrive](data-source-onedrive.md) + [Microsoft SharePoint](data-source-sharepoint.md) + [Microsoft SQL Server](data-source-ms-sql-server.md) + [Microsoft Teams](data-source-teams.md) + [Microsoft Yammer](data-source-yammer.md) + [MySQL](data-source-mysql.md) + [Oracle Database](data-source-oracle-database.md) + [PostgreSQL](data-source-postgresql.md) + [Quip](data-source-quip.md) + [Salesforce](data-source-salesforce.md) + [ServiceNow](data-source-servicenow.md) + [Slack](data-source-slack.md) + [Zendesk](data-source-zendesk.md) # Skema templat sumber data Berikut ini adalah skema template untuk sumber data di mana template didukung. **Topics** + [Adobe Experience Managerskema templat](#ds-aem-schema) + [Amazon FSx Skema templat (Windows)](#ds-fsx-windows-schema) + [Amazon FSx Skema templat (NetApp ONTAP)](#ds-fsx-ontap-schema) + [Alfrescoskema templat](#ds-alfresco-schema) + [Aurora Skema templat (MySQL)](#ds-aurora-mysql-schema) + [Aurora (PostgreSQL) skema templat](#ds-aurora-postgresql-schema) + [Amazon RDS Skema templat (Microsoft SQL Server)](#ds-rds-ms-sql-server-schema) + [Amazon RDS Skema templat (MySQL)](#ds-rds-mysql-schema) + [Amazon RDS Skema templat (Oracle)](#ds-rds-oracle-schema) + [Amazon RDS (PostgreSQL) skema templat](#ds-rds-postgresql-schema) + [Amazon S3 skema templat](#ds-s3-schema) + [Amazon Kendra Skema Templat Perayap Web](#ds-schema-web-crawler) + [Skema templat pertemuan](#ds-confluence-schema) + [Skema templat Dropbox](#ds-dropbox-schema) + [Skema template Drupal](#ds-drupal-schema) + [GitHub skema templat](#ds-github-schema) + [Skema template Gmail](#ds-gmail-schema) + [Skema templat Google Drive](#ds-googledrive-schema) + [Skema DB2 templat IBM](#ds-ibm-db2-schema) + [Skema templat Microsoft Exchange](#ds-msexchange-schema) + [OneDrive Skema templat Microsoft](#ds-onedrive-schema) + [SharePoint Skema templat Microsoft](#ds-schema-sharepoint) + [Skema templat Microsoft SQL Server](#ds-ms-sql-server-schema) + [Skema templat Microsoft Teams](#ds-msteams-schema) + [Skema templat Microsoft Yammer](#ds-schema-yammer) + [Skema templat MySQL](#ds-mysql-schema) + [Skema templat Oracle Database](#ds-oracle-database-schema) + [Skema Templat PostgreSQL](#ds-postgresql-schema) + [Skema templat Salesforce](#ds-salesforce-schema) + [ServiceNow skema templat](#ds-servicenow-schema) + [Skema template kendur](#ds-schema-slack) + [Skema template Zendesk](#ds-schema-zendesk) ## Adobe Experience Managerskema templat Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Anda memberikan URL Adobe Experience Manager host, jenis otentikasi, dan apakah Anda menggunakan Adobe Experience Manager (AEM) sebagai Layanan Cloud atau AEM On-Premise sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Juga, tentukan jenis sumber data sebagai`AEM`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Untuk informasi selengkapnya, lihat [Adobe Experience ManagerSkema JSON](#aem-json). Tabel berikut menjelaskan parameter skema AEM JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. | | AEMurl | URL Adobe Experience Manager host. Misalnya, jika Anda menggunakan AEM On-Premise, Anda menyertakan nama host dan port: https://hostname:port. Atau, jika Anda menggunakan AEM as a Layanan Cloud, Anda dapat menggunakan URL penulis: https://author-xxxxxx-xxxxxxx.adobeaemcloud.com. | | authType | Jenis otentikasi yang Anda gunakan, apakah Basic atauOAuth2. | | deploymentType | Jenis Adobe Experience Manager yang Anda gunakan, baik CLOUD atauON\$1PREMISE. | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar objek yang memetakan atribut atau nama bidang Adobe Experience Manager halaman dan aset Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. | | timeZoneId | Jika Anda menggunakan AEM On-Premise dan zona waktu server Anda berbeda dari zona waktu konektor atau indeks Amazon Kendra AEM, Anda dapat menentukan zona waktu server agar sejajar dengan konektor atau indeks AEM. Zona waktu default untuk AEM On-Premise adalah zona waktu konektor atau indeks Amazon Kendra AEM. Zona waktu default untuk AEM sebagai Layanan Cloud adalah Greenwich Mean Time. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar jalur root untuk halaman dan aset. Misalnya, jalur root untuk halaman bisa /content/sub dan jalur root untuk aset bisa jadi/1. content/sub/asset | | CrawlAssets | trueuntuk merayapi aset. | | CrawlPages | trueuntuk merayapi halaman. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk menyertakan halaman dan aset tertentu dalam sumber Adobe Experience Manager data Anda. Halaman dan aset yang cocok dengan pola disertakan dalam indeks. Halaman dan aset yang tidak cocok dengan pola dikecualikan dari indeks. Jika halaman atau aset cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan konten tidak disertakan dalam indeks. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk mengecualikan halaman dan aset tertentu di sumber Adobe Experience Manager data Anda. Halaman dan aset yang cocok dengan pola dikecualikan dari indeks. Halaman dan aset yang tidak cocok dengan pola disertakan dalam indeks. Jika halaman atau aset cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan konten tidak disertakan dalam indeks. | | PageComponents | Daftar nama untuk komponen halaman tertentu yang ingin Anda indeks. | | contentFragmentVariations | Daftar nama untuk variasi spesifik yang disimpan dari Fragmen Adobe Experience Manager Konten yang ingin Anda indeks. | | jenis | Jenis sumber data. Tentukan AEM sebagai tipe sumber data Anda. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang berisi pasangan kunci-nilai yang diperlukan untuk terhubung ke Adobe Experience Manager Anda. Untuk informasi tentang pasangan nilai kunci ini, lihat [Petunjuk koneksi untuk Adobe Experience Manager](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aem.html#data-source-procedure-aem). | | versi | Versi template ini yang saat ini didukung. | ### Adobe Experience ManagerSkema JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "aemUrl": { "type": "string", "pattern": "https:.*" }, "authType": { "type": "string", "enum": ["Basic", "OAuth2"] }, "deploymentType": { "type": "string", "enum": ["CLOUD","ON_PREMISE"] } }, "required": [ "aemUrl", "authType", "deploymentType" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "page": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "asset": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } } }, "additionalProperties": { "type": "object", "properties": { "timeZoneId": { "type": "string", "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Ciudad_Juarez", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Nuuk", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Kyiv", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT0", "Greenwich", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kanton", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROK", "Singapore", "SystemV/AST4", "SystemV/AST4ADT", "SystemV/CST6", "SystemV/CST6CDT", "SystemV/EST5", "SystemV/EST5EDT", "SystemV/HST10", "SystemV/MST7", "SystemV/MST7MDT", "SystemV/PST8", "SystemV/PST8PDT", "SystemV/YST9", "SystemV/YST9YDT", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu", "EST", "HST", "MST", "ACT", "AET", "AGT", "ART", "AST", "BET", "BST", "CAT", "CNT", "CST", "CTT", "EAT", "ECT", "IET", "IST", "JST", "MIT", "NET", "NST", "PLT", "PNT", "PRT", "PST", "SST", "VST" ] }, "pageRootPaths": { "type": "array", "items": { "type": "string" } }, "assetRootPaths": { "type": "array", "items": { "type": "string" } }, "crawlAssets": { "type": "boolean" }, "crawlPages": { "type": "boolean" }, "pagePathInclusionPatterns": { "type": "array", "items": { "type": "string" } }, "pagePathExclusionPatterns": { "type": "array", "items": { "type": "string" } }, "pageNameInclusionPatterns": { "type": "array", "items": { "type": "string" } }, "pageNameExclusionPatterns": { "type": "array", "items": { "type": "string" } }, "assetPathInclusionPatterns": { "type": "array", "items": { "type": "string" } }, "assetPathExclusionPatterns": { "type": "array", "items": { "type": "string" } }, "assetTypeInclusionPatterns": { "type": "array", "items": { "type": "string" } }, "assetTypeExclusionPatterns": { "type": "array", "items": { "type": "string" } }, "assetNameInclusionPatterns": { "type": "array", "items": { "type": "string" } }, "assetNameExclusionPatterns": { "type": "array", "items": { "type": "string" } }, "pageComponents": { "type": "array", "items": { "type": "object" } }, "contentFragmentVariations": { "type": "array", "items": { "type": "object" } }, "cugExemptedPrincipals": { "type": "array", "items": { "type": "string" } } }, "required": [] }, "type": { "type": "string", "pattern": "AEM" }, "enableIdentityCrawler": { "type": "boolean" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "secretArn": { "type": "string", "minLength": 20, "maxLength": 2048 } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## Amazon FSx Skema templat (Windows) Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda memberikan ID sistem file sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Anda juga harus menentukan jenis sumber data sebagai`FSX`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Amazon FSx (Windows) Skema JSON](#fsx-windows-json). Tabel berikut menjelaskan parameter skema JSON Amazon FSx (Windows). | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. | | fileSystemId | Pengidentifikasi sistem Amazon FSx file. Anda dapat menemukan ID sistem file Anda di dasbor Sistem File di Amazon FSx konsol. | | fileSystemType | Jenis sistem Amazon FSx file. Untuk digunakan Windows File Server sebagai jenis sistem file Anda, tentukanWINDOWS. | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | Semua | Daftar objek yang memetakan atribut atau nama bidang file Anda di sumber Amazon FSx data Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. | | isCrawlAcl | trueuntuk merayapi informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). | | Pola Inklusi | Daftar pola ekspresi reguler untuk menyertakan file tertentu dalam sumber Amazon FSx data Anda. File yang cocok dengan pola disertakan dalam indeks. File yang tidak cocok dengan pola dikecualikan dari indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan dan file tidak disertakan dalam indeks. | | Pola Pengecualian | Daftar pola ekspresi reguler untuk mengecualikan file tertentu di sumber Amazon FSx data Anda. File yang cocok dengan pola dikecualikan dari indeks. File yang tidak cocok dengan pola disertakan dalam indeks. Jika file cocok dengan pola pengecualian dan inklusi, pola pengecualian akan diutamakan dan file tidak disertakan dalam indeks. | | enableIdentityCrawler | trueuntuk menggunakan Amazon Kendra crawler identitas untuk menyinkronkan identity/principal informasi pada pengguna dan grup dengan akses ke dokumen tertentu. Jika perayap identitas dimatikan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | jenis | Jenis sumber data. Untuk sumber data sistem file Windows, tentukanFSX. | ### Amazon FSx (Windows) Skema JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "fileSystemId": { "type": "string", "pattern": "fs-.*" }, "fileSystemType": { "type": "string", "pattern": "WINDOWS" } }, "required": ["fileSystemId", "fileSystemType"] } } }, "repositoryConfigurations": { "type": "object", "properties": { "All": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": ["STRING", "STRING_LIST", "DATE"] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": ["fieldMappings"] } }, "required": ["All"] }, "additionalProperties": { "type": "object", "properties": { "isCrawlAcl": { "type": "boolean" }, "exclusionPatterns": { "type": "array", "items": { "type": "string" } }, "inclusionPatterns": { "type": "array", "items": { "type": "string" } } }, "required": [] }, "enableIdentityCrawler": { "type": "boolean" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL" ] }, "type" : { "type" : "string", "pattern": "FSX" } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "enableIdentityCrawler", "additionalProperties", "type" ] } ``` ## Amazon FSx Skema templat (NetApp ONTAP) Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda memberikan ID sistem file dan mesin virtual penyimpanan (SVM) sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Anda juga harus menentukan jenis sumber data sebagai`FSXONTAP`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Amazon FSx (NetApp ONTAP) Skema JSON](#fsx-ontap-json). Tabel berikut menjelaskan parameter skema JSON Amazon FSx (NetApp ONTAP). | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. | | fileSystemId | Pengidentifikasi sistem Amazon FSx file. Anda dapat menemukan ID sistem file Anda di dasbor Sistem File di Amazon FSx konsol. Untuk informasi tentang cara membuat sistem file di Amazon FSx konsol untuk NetApp ONTAP, lihat [Panduan Memulai untuk NetApp ONTAP di Panduan FSx for ONTAP](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/getting-started.html) Pengguna. | | fileSystemType | Jenis sistem Amazon FSx file. Untuk digunakan NetApp ONTAP sebagai jenis sistem file Anda, tentukanONTAP. | | SVMid | Pengidentifikasi mesin virtual penyimpanan (SVM) yang digunakan dengan sistem Amazon FSx file Anda untuk. NetApp ONTAP Anda dapat menemukan ID SVM Anda dengan membuka dasbor Sistem File di Amazon FSx konsol, memilih ID sistem file Anda, dan kemudian memilih mesin virtual Penyimpanan. Untuk informasi tentang cara membuat sistem file di Amazon FSx konsolNetApp ONTAP, lihat [Panduan Memulai NetApp ONTAP](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/getting-started.html) di Panduan FSx for ONTAP Pengguna. | | ProtocolType | Apakah Anda menggunakan protokol Common Internet File System (CIFS) untuk Windows, atau protokol Network File System (NFS) untuk Linux. | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | file | Daftar objek yang memetakan atribut atau nama bidang file Anda di sumber Amazon FSx data Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). Nama bidang sumber data harus ada di metadata kustom file Anda. | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. | | CrawlaCl | trueuntuk merayapi informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). | | Pola Inklusi | Daftar pola ekspresi reguler untuk menyertakan file tertentu dalam sumber Amazon FSx data Anda. File yang cocok dengan pola disertakan dalam indeks. File yang tidak cocok dengan pola dikecualikan dari indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan dan file tidak disertakan dalam indeks. | | Pola Pengecualian | Daftar pola ekspresi reguler untuk mengecualikan file tertentu di sumber Amazon FSx data Anda. File yang cocok dengan pola dikecualikan dari indeks. File yang tidak cocok dengan pola disertakan dalam indeks. Jika file cocok dengan pola pengecualian dan inklusi, pola pengecualian akan diutamakan dan file tidak disertakan dalam indeks. | | jenis | Jenis sumber data. Untuk sumber data sistem NetApp ONTAP file, tentukanFSXONTAP. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang berisi pasangan kunci-nilai yang diperlukan untuk terhubung ke sistem file Anda. Amazon FSx Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "username": "user@corp.example.com",
    "password": "password"
}
Jika Anda menggunakan protokol NFS untuk sistem Amazon FSx file Anda, rahasianya disimpan dalam struktur JSON dengan kunci berikut: 
{
    "leftId": "left ID",
    "rightId": "right ID",
    "preSharedKey": "pre-shared key"
}
| ### Amazon FSx (NetApp ONTAP) Skema JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "fileSystemId": { "type": "string", "pattern": "^(fs-[0-9a-f]{8,21})$" }, "fileSystemType": { "type": "string", "enum": ["ONTAP"] }, "svmId": { "type": "string", "pattern": "^(svm-[0-9a-f]{17,21})$" }, "protocolType": { "type": "string", "enum": [ "CIFS", "NFS" ] } }, "required": [ "fileSystemId", "fileSystemType" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "file": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string", "pattern": "^([a-zA-Z_]{1,20})$" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string", "pattern": "^([a-zA-Z_]{1,20})$" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ], "maxItems": 50 } }, "required": [ "fieldMappings" ] } }, "required": [ "file" ] }, "additionalProperties": { "type": "object", "properties": { "crawlAcl": { "type": "boolean" }, "inclusionPatterns": { "type": "array", "items": { "type": "string", "maxLength": 30 }, "maxItems": 100 }, "exclusionPatterns": { "type": "array", "items": { "type": "string", "maxLength": 30 }, "maxItems": 100 } } }, "type": { "type": "string", "pattern": "FSXONTAP" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL" ] }, "secretArn": { "type": "string", "pattern": "arn:aws:secretsmanager:.*" } }, "required": [ "connectionConfiguration", "repositoryConfigurations", "additionalProperties", "secretArn", "type" ] } ``` ## Alfrescoskema templat Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Anda memberikan ID Alfresco situs, URL repositori, URL antarmuka pengguna, jenis autentikasi, apakah Anda menggunakan cloud atau lokal, dan jenis konten yang ingin dirayapi. Anda memberikan ini sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Juga tentukan jenis sumber data sebagai`ALFRESCO`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [AlfrescoSkema JSON](#alfresco-json). Tabel berikut menjelaskan parameter skema Alfresco JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. | | SiteID | Pengidentifikasi situs Alfresco. | | Repourl | URL Alfresco repositori Anda. Anda bisa mendapatkan URL repositori dari administrator AndaAlfresco. Misalnya, jika Anda menggunakan Alfresco Cloud (PaaS), URL repositori bisa jadi. https://company.alfrescocloud.com Atau, jika Anda menggunakan Alfresco Lokal, URL repositori bisa jadi. https://company-alfresco-instance.company-domain.suffix:port | | webAppUrl | URL antarmuka Alfresco pengguna Anda. Anda bisa mendapatkan URL antarmuka Alfresco pengguna dari Alfresco administrator Anda. Misalnya, URL antarmuka pengguna dapat berupa https://example.com. | | repositoryAdditionalProperties | Properti tambahan untuk terhubung dengan titik akhir repository/data sumber. | | authType | Jenis otentikasi yang Anda gunakan, apakah OAuth2 atauBasic. | | jenis (penyebaran) | Jenis Alfresco yang Anda gunakan, apakah PAAS atauON-PREM. | | CrawlType | Jenis konten yang ingin dirayapi, baik ASPECT (konten yang ditandai dengan 'Aspek' diAlfresco), SITE\$1ID (konten dalam Alfresco situs tertentu), atau ALL\$1SITES (konten di semua Alfresco situs Anda). | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar objek yang memetakan atribut atau nama bidang dokumen Alfresco Anda dan komentar untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. | | AspectName | Nama 'Aspek' tertentu yang ingin Anda indeks. | | AspectProperties | Daftar properti konten 'Aspek' tertentu yang ingin Anda indeks. | | enableFineGrainedKontrol | `true`untuk merangkak 'Aspek'. | | isCrawlComment | `true`untuk merayapi komentar. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk menyertakan file tertentu dalam sumber Alfresco data Anda. File yang cocok dengan pola disertakan dalam indeks. File yang tidak cocok dengan pola dikecualikan dari indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan file tidak disertakan dalam indeks. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk mengecualikan file tertentu di sumber Alfresco data Anda. File yang cocok dengan pola dikecualikan dari indeks. File yang tidak cocok dengan pola disertakan dalam indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan file tidak disertakan dalam indeks. | | jenis | Jenis sumber data. Tentukan ALFRESCO sebagai tipe sumber data Anda. | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang berisi pasangan kunci-nilai yang diperlukan untuk terhubung ke Anda. Alfresco Rahasianya harus berisi struktur JSON dengan kunci berikut: Jika menggunakan otentikasi dasar: 
{
    "username": "user name",
    "password": "password"
}
Jika menggunakan otentikasi OAuth 2.0: 
{
    "clientId": "client ID",
    "clientSecret": "client secret",
    "tokenUrl": "token URL"
}
| | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | enableIdentityCrawler | trueuntuk menggunakan Amazon Kendra crawler identitas untuk menyinkronkan identity/principal informasi pada pengguna dan grup dengan akses ke dokumen tertentu. Jika perayap identitas dimatikan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup. | | versi | Versi template ini yang saat ini didukung. | ### AlfrescoSkema JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "siteId": { "type": "string" }, "repoUrl": { "type": "string" }, "webAppUrl": { "type": "string" }, "repositoryAdditionalProperties": { "type": "object", "properties": { "authType": { "type": "string", "enum": [ "OAuth2", "Basic" ] }, "type": { "type": "string", "enum": [ "PAAS", "ON_PREM" ] }, "crawlType": { "type": "string", "enum": [ "ASPECT", "SITE_ID", "ALL_SITES" ] } } } } } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "document": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE", "STRING_LIST", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] }, "comment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE", "STRING_LIST", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] } } }, "additionalProperties": { "type": "object", "properties": { "aspectName": { "type": "string" }, "aspectProperties": { "type": "array" }, "enableFineGrainedControl": { "type": "boolean" }, "isCrawlComment": { "type": "boolean" }, "inclusionFileNamePatterns": { "type": "array" }, "exclusionFileNamePatterns": { "type": "array" }, "inclusionFileTypePatterns": { "type": "array" }, "exclusionFileTypePatterns": { "type": "array" }, "inclusionFilePathPatterns": { "type": "array" }, "exclusionFilePathPatterns": { "type": "array" } } }, "type": { "type": "string", "pattern": "ALFRESCO" }, "secretArn": { "type": "string", "minLength": 20, "maxLength": 2048 }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL" ] }, "enableIdentityCrawler": { "type": "boolean" }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] } }, "required": [ "connectionConfiguration", "repositoryConfigurations", "additionalProperties", "type", "secretArn" ] } ``` ## Aurora Skema templat (MySQL) Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Tentukan jenis sumber data sebagai`JDBC`, tipe database sebagai`mysql`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Aurora (MySQL) skema JSON](#aurora-mysql-json). Tabel berikut menjelaskan parameter skema Aurora (MySQL) JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi konfigurasi yang diperlukan untuk menghubungkan sumber data Anda.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. Tentukan jenis sumber data dan ARN rahasia. | | dokumen | Daftar objek yang memetakan atribut atau nama bidang konten database Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. Gunakan untuk menyertakan atau mengecualikan konten tertentu dalam sumber data database Anda. | | PrimaryKey | Berikan kunci utama untuk tabel database. Detail ini mengidentifikasi tabel di dalam basis data Anda. | | Judul Kolom | Berikan nama kolom judul dokumen dalam tabel database Anda. | | BodyColumn | Berikan nama kolom judul dokumen dalam tabel database Anda. | | SqlQuery | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | TimestampColumn | Masukkan nama kolom yang berisi stempel waktu. Amazon Kendra menggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. | | TimestampFormat | Masukkan nama kolom yang berisi format cap waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. | | timezone | Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. | | changeDetectingColumns | Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendra akan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini | | allowedUsersColumns | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | allowedGroupsColumn | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | sumber URIColumn | Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. | | isSslEnabled | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | jenis | Jenis sumber data. Tentukan JDBC sebagai tipe sumber data Anda. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari rahasia Secrets Manager yang berisi nama pengguna dan kata sandi yang diperlukan untuk terhubung ke database Anda. Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "user name": "database user name",
    "password": "password"
}
| | versi | Versi template yang saat ini didukung. | ### Aurora (MySQL) skema JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "dbType": { "type": "string", "enum": [ "mysql", "db2", "postgresql", "oracle", "sqlserver" ] }, "dbHost": { "type": "string" }, "dbPort": { "type": "string" }, "dbInstance": { "type": "string" } }, "required": [ "dbType", "dbHost", "dbPort", "dbInstance" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "document": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string" }, "dataSourceFieldName": { "type": "string" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } }, "required": [ ] }, "additionalProperties": { "type": "object", "properties": { "primaryKey": { "type": "string" }, "titleColumn": { "type": "string" }, "bodyColumn": { "type": "string" }, "sqlQuery": { "type": "string", "not": { "pattern": ";+" } }, "timestampColumn": { "type": "string" }, "timestampFormat": { "type": "string" }, "timezone": { "type": "string" }, "changeDetectingColumns": { "type": "array", "items": { "type": "string" } }, "allowedUsersColumn": { "type": "string" }, "allowedGroupsColumn": { "type": "string" }, "sourceURIColumn": { "type": "string" }, "isSslEnabled": { "type": "boolean" } }, "required": ["primaryKey", "titleColumn", "bodyColumn", "sqlQuery"] }, "type" : { "type" : "string", "pattern": "JDBC" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "secretArn": { "type": "string" } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## Aurora (PostgreSQL) skema templat Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Tentukan jenis sumber data sebagai`JDBC`, tipe database sebagai`postgresql`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Aurora (PostgreSQL) Skema JSON](#aurora-postgresql-json). Tabel berikut menjelaskan parameter skema JSON Aurora (PostgreSQL). | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi konfigurasi yang diperlukan untuk menghubungkan sumber data Anda.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. Tentukan jenis sumber data dan ARN rahasia. | | dokumen | Daftar objek yang memetakan atribut atau nama bidang konten database Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. Gunakan untuk menyertakan atau mengecualikan konten tertentu dalam sumber data database Anda. | | PrimaryKey | Berikan kunci utama untuk tabel database. Detail ini mengidentifikasi tabel di dalam basis data Anda. | | Judul Kolom | Berikan nama kolom judul dokumen dalam tabel database Anda. | | BodyColumn | Berikan nama kolom judul dokumen dalam tabel database Anda. | | SqlQuery | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | TimestampColumn | Masukkan nama kolom yang berisi stempel waktu. Amazon Kendra menggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. | | TimestampFormat | Masukkan nama kolom yang berisi format cap waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. | | timezone | Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. | | changeDetectingColumns | Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendra akan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini | | allowedUsersColumns | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | allowedGroupsColumn | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | sumber URIColumn | Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. | | isSslEnabled | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | jenis | Jenis sumber data. Tentukan JDBC sebagai tipe sumber data Anda. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari rahasia Secrets Manager yang berisi nama pengguna dan kata sandi yang diperlukan untuk terhubung ke database Anda. Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "user name": "database user name",
    "password": "password"
}
| | versi | Versi template yang saat ini didukung. | ### Aurora (PostgreSQL) Skema JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "dbType": { "type": "string", "enum": [ "mysql", "db2", "postgresql", "oracle", "sqlserver" ] }, "dbHost": { "type": "string" }, "dbPort": { "type": "string" }, "dbInstance": { "type": "string" } }, "required": [ "dbType", "dbHost", "dbPort", "dbInstance" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "document": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string" }, "dataSourceFieldName": { "type": "string" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } }, "required": [ ] }, "additionalProperties": { "type": "object", "properties": { "primaryKey": { "type": "string" }, "titleColumn": { "type": "string" }, "bodyColumn": { "type": "string" }, "sqlQuery": { "type": "string", "not": { "pattern": ";+" } }, "timestampColumn": { "type": "string" }, "timestampFormat": { "type": "string" }, "timezone": { "type": "string" }, "changeDetectingColumns": { "type": "array", "items": { "type": "string" } }, "allowedUsersColumn": { "type": "string" }, "allowedGroupsColumn": { "type": "string" }, "sourceURIColumn": { "type": "string" }, "isSslEnabled": { "type": "boolean" } }, "required": ["primaryKey", "titleColumn", "bodyColumn", "sqlQuery"] }, "type" : { "type" : "string", "pattern": "JDBC" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "secretArn": { "type": "string" } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## Amazon RDS Skema templat (Microsoft SQL Server) Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Tentukan jenis sumber data sebagai`JDBC`, tipe database sebagai`sqlserver`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Amazon RDS (Microsoft SQL Server) Skema JSON](#rds-ms-sql-server-json). Tabel berikut menjelaskan parameter skema JSON Amazon RDS (Microsoft SQL Server). | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi konfigurasi yang diperlukan untuk menghubungkan sumber data Anda.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. Tentukan jenis sumber data dan ARN rahasia. | | dokumen | Daftar objek yang memetakan atribut atau nama bidang konten database Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. Gunakan untuk menyertakan atau mengecualikan konten tertentu dalam sumber data database Anda. | | PrimaryKey | Berikan kunci utama untuk tabel database. Detail ini mengidentifikasi tabel di dalam basis data Anda. | | Judul Kolom | Berikan nama kolom judul dokumen dalam tabel database Anda. | | BodyColumn | Berikan nama kolom judul dokumen dalam tabel database Anda. | | SqlQuery | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | TimestampColumn | Masukkan nama kolom yang berisi stempel waktu. Amazon Kendra menggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. | | TimestampFormat | Masukkan nama kolom yang berisi format cap waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. | | timezone | Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. | | changeDetectingColumns | Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendra akan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini | | allowedUsersColumns | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | allowedGroupsColumn | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | sumber URIColumn | Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. | | isSslEnabled | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | jenis | Jenis sumber data. Tentukan JDBC sebagai tipe sumber data Anda. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari rahasia Secrets Manager yang berisi nama pengguna dan kata sandi yang diperlukan untuk terhubung ke database Anda. Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "user name": "database user name",
    "password": "password"
}
| | versi | Versi template yang saat ini didukung. | ### Amazon RDS (Microsoft SQL Server) Skema JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "dbType": { "type": "string", "enum": [ "mysql", "db2", "postgresql", "oracle", "sqlserver" ] }, "dbHost": { "type": "string" }, "dbPort": { "type": "string" }, "dbInstance": { "type": "string" } }, "required": [ "dbType", "dbHost", "dbPort", "dbInstance" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "document": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string" }, "dataSourceFieldName": { "type": "string" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } }, "required": [ ] }, "additionalProperties": { "type": "object", "properties": { "primaryKey": { "type": "string" }, "titleColumn": { "type": "string" }, "bodyColumn": { "type": "string" }, "sqlQuery": { "type": "string", "not": { "pattern": ";+" } }, "timestampColumn": { "type": "string" }, "timestampFormat": { "type": "string" }, "timezone": { "type": "string" }, "changeDetectingColumns": { "type": "array", "items": { "type": "string" } }, "allowedUsersColumn": { "type": "string" }, "allowedGroupsColumn": { "type": "string" }, "sourceURIColumn": { "type": "string" }, "isSslEnabled": { "type": "boolean" } }, "required": ["primaryKey", "titleColumn", "bodyColumn", "sqlQuery"] }, "type" : { "type" : "string", "pattern": "JDBC" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "secretArn": { "type": "string" } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## Amazon RDS Skema templat (MySQL) Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Tentukan jenis sumber data sebagai`JDBC`, tipe database sebagai`mysql`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Amazon RDS (MySQL) skema JSON](#rds-mysql-json). Tabel berikut menjelaskan parameter skema Amazon RDS (MySQL) JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi konfigurasi yang diperlukan untuk menghubungkan sumber data Anda.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. Tentukan jenis sumber data dan ARN rahasia. | | dokumen | Daftar objek yang memetakan atribut atau nama bidang konten database Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. Gunakan untuk menyertakan atau mengecualikan konten tertentu dalam sumber data database Anda. | | PrimaryKey | Berikan kunci utama untuk tabel database. Detail ini mengidentifikasi tabel di dalam basis data Anda. | | Judul Kolom | Berikan nama kolom judul dokumen dalam tabel database Anda. | | BodyColumn | Berikan nama kolom judul dokumen dalam tabel database Anda. | | SqlQuery | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | TimestampColumn | Masukkan nama kolom yang berisi stempel waktu. Amazon Kendra menggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. | | TimestampFormat | Masukkan nama kolom yang berisi format cap waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. | | timezone | Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. | | changeDetectingColumns | Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendra akan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini | | allowedUsersColumns | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | allowedGroupsColumn | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | sumber URIColumn | Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. | | isSslEnabled | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | jenis | Jenis sumber data. Tentukan JDBC sebagai tipe sumber data Anda. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari rahasia Secrets Manager yang berisi nama pengguna dan kata sandi yang diperlukan untuk terhubung ke database Anda. Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "user name": "database user name",
    "password": "password"
}
| | versi | Versi template yang saat ini didukung. | ### Amazon RDS (MySQL) skema JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "dbType": { "type": "string", "enum": [ "mysql", "db2", "postgresql", "oracle", "sqlserver" ] }, "dbHost": { "type": "string" }, "dbPort": { "type": "string" }, "dbInstance": { "type": "string" } }, "required": [ "dbType", "dbHost", "dbPort", "dbInstance" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "document": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string" }, "dataSourceFieldName": { "type": "string" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } }, "required": [ ] }, "additionalProperties": { "type": "object", "properties": { "primaryKey": { "type": "string" }, "titleColumn": { "type": "string" }, "bodyColumn": { "type": "string" }, "sqlQuery": { "type": "string", "not": { "pattern": ";+" } }, "timestampColumn": { "type": "string" }, "timestampFormat": { "type": "string" }, "timezone": { "type": "string" }, "changeDetectingColumns": { "type": "array", "items": { "type": "string" } }, "allowedUsersColumn": { "type": "string" }, "allowedGroupsColumn": { "type": "string" }, "sourceURIColumn": { "type": "string" }, "isSslEnabled": { "type": "boolean" } }, "required": ["primaryKey", "titleColumn", "bodyColumn", "sqlQuery"] }, "type" : { "type" : "string", "pattern": "JDBC" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "secretArn": { "type": "string" } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## Amazon RDS Skema templat (Oracle) Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Tentukan jenis sumber data sebagai`JDBC`, tipe database sebagai`oracle`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Amazon RDS (Oracle) Skema JSON](#rds-oracle-json). Tabel berikut menjelaskan parameter skema Amazon RDS (Oracle) JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi konfigurasi yang diperlukan untuk menghubungkan sumber data Anda.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. Tentukan jenis sumber data dan ARN rahasia. | | dokumen | Daftar objek yang memetakan atribut atau nama bidang konten database Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. Gunakan untuk menyertakan atau mengecualikan konten tertentu dalam sumber data database Anda. | | PrimaryKey | Berikan kunci utama untuk tabel database. Detail ini mengidentifikasi tabel di dalam basis data Anda. | | Judul Kolom | Berikan nama kolom judul dokumen dalam tabel database Anda. | | BodyColumn | Berikan nama kolom judul dokumen dalam tabel database Anda. | | SqlQuery | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | TimestampColumn | Masukkan nama kolom yang berisi stempel waktu. Amazon Kendra menggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. | | TimestampFormat | Masukkan nama kolom yang berisi format cap waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. | | timezone | Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. | | changeDetectingColumns | Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendra akan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini | | allowedUsersColumns | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | allowedGroupsColumn | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | sumber URIColumn | Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. | | isSslEnabled | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | jenis | Jenis sumber data. Tentukan JDBC sebagai tipe sumber data Anda. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari rahasia Secrets Manager yang berisi nama pengguna dan kata sandi yang diperlukan untuk terhubung ke database Anda. Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "user name": "database user name",
    "password": "password"
}
| | versi | Versi template yang saat ini didukung. | ### Amazon RDS (Oracle) Skema JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "dbType": { "type": "string", "enum": [ "mysql", "db2", "postgresql", "oracle", "sqlserver" ] }, "dbHost": { "type": "string" }, "dbPort": { "type": "string" }, "dbInstance": { "type": "string" } }, "required": [ "dbType", "dbHost", "dbPort", "dbInstance" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "document": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string" }, "dataSourceFieldName": { "type": "string" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } }, "required": [ ] }, "additionalProperties": { "type": "object", "properties": { "primaryKey": { "type": "string" }, "titleColumn": { "type": "string" }, "bodyColumn": { "type": "string" }, "sqlQuery": { "type": "string", "not": { "pattern": ";+" } }, "timestampColumn": { "type": "string" }, "timestampFormat": { "type": "string" }, "timezone": { "type": "string" }, "changeDetectingColumns": { "type": "array", "items": { "type": "string" } }, "allowedUsersColumn": { "type": "string" }, "allowedGroupsColumn": { "type": "string" }, "sourceURIColumn": { "type": "string" }, "isSslEnabled": { "type": "boolean" } }, "required": ["primaryKey", "titleColumn", "bodyColumn", "sqlQuery"] }, "type" : { "type" : "string", "pattern": "JDBC" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "secretArn": { "type": "string" } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## Amazon RDS (PostgreSQL) skema templat Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Tentukan jenis sumber data sebagai`JDBC`, tipe database sebagai`postgresql`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Amazon RDS (PostgreSQL) Skema JSON](#rds-postgresql-json). Tabel berikut menjelaskan parameter skema JSON Amazon RDS (PostgreSQL). | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi konfigurasi yang diperlukan untuk menghubungkan sumber data Anda.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. Tentukan jenis sumber data dan ARN rahasia. | | dokumen | Daftar objek yang memetakan atribut atau nama bidang konten database Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. Gunakan untuk menyertakan atau mengecualikan konten tertentu dalam sumber data database Anda. | | PrimaryKey | Berikan kunci utama untuk tabel database. Detail ini mengidentifikasi tabel di dalam basis data Anda. | | Judul Kolom | Berikan nama kolom judul dokumen dalam tabel database Anda. | | BodyColumn | Berikan nama kolom judul dokumen dalam tabel database Anda. | | SqlQuery | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | TimestampColumn | Masukkan nama kolom yang berisi stempel waktu. Amazon Kendra menggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. | | TimestampFormat | Masukkan nama kolom yang berisi format cap waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. | | timezone | Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. | | changeDetectingColumns | Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendra akan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini | | allowedUsersColumns | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | allowedGroupsColumn | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | sumber URIColumn | Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. | | isSslEnabled | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | jenis | Jenis sumber data. Tentukan JDBC sebagai tipe sumber data Anda. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari rahasia Secrets Manager yang berisi nama pengguna dan kata sandi yang diperlukan untuk terhubung ke database Anda. Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "user name": "database user name",
    "password": "password"
}
| | versi | Versi template yang saat ini didukung. | ### Amazon RDS (PostgreSQL) Skema JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "dbType": { "type": "string", "enum": [ "mysql", "db2", "postgresql", "oracle", "sqlserver" ] }, "dbHost": { "type": "string" }, "dbPort": { "type": "string" }, "dbInstance": { "type": "string" } }, "required": [ "dbType", "dbHost", "dbPort", "dbInstance" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "document": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string" }, "dataSourceFieldName": { "type": "string" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } }, "required": [ ] }, "additionalProperties": { "type": "object", "properties": { "primaryKey": { "type": "string" }, "titleColumn": { "type": "string" }, "bodyColumn": { "type": "string" }, "sqlQuery": { "type": "string", "not": { "pattern": ";+" } }, "timestampColumn": { "type": "string" }, "timestampFormat": { "type": "string" }, "timezone": { "type": "string" }, "changeDetectingColumns": { "type": "array", "items": { "type": "string" } }, "allowedUsersColumn": { "type": "string" }, "allowedGroupsColumn": { "type": "string" }, "sourceURIColumn": { "type": "string" }, "isSslEnabled": { "type": "boolean" } }, "required": ["primaryKey", "titleColumn", "bodyColumn", "sqlQuery"] }, "type" : { "type" : "string", "pattern": "JDBC" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "secretArn": { "type": "string" } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## Amazon S3 skema templat Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari konfigurasi template. Anda memberikan nama bucket S3 sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Juga tentukan jenis sumber data sebagai`S3`, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Skema S3 JSON](#s3-json). Tabel berikut menjelaskan parameter skema Amazon S3 JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. | | BucketName | Nama Amazon S3 ember Anda. | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk menyertakan atau mengecualikan file tertentu dalam sumber Amazon S3 data Anda. File yang cocok dengan pola disertakan dalam indeks. File yang tidak cocok dengan pola dikecualikan dari indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan dan file tidak disertakan dalam indeks. | | aclConfigurationFileJalan | Jalur file yang mengontrol akses ke dokumen dalam Amazon Kendra indeks. | | metadataFilesPrefix | Lokasi dalam bucket Anda untuk file metadata. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | jenis | Jenis sumber data. Tentukan S3 sebagai tipe sumber data Anda. | | versi | Versi template yang didukung. | ### Skema S3 JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "BucketName": { "type": "string" } }, "required": [ "BucketName" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "document": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING" ] }, "dataSourceFieldName": { "type": "string" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } }, "required": [ "document" ] }, "additionalProperties": { "type": "object", "properties": { "inclusionPatterns": { "type": "array" }, "exclusionPatterns": { "type": "array" }, "inclusionPrefixes": { "type": "array" }, "exclusionPrefixes": { "type": "array" }, "aclConfigurationFilePath": { "type": "string" }, "metadataFilesPrefix": { "type": "string" } } }, "syncMode": { "type": "string", "enum": [ "FULL_CRAWL", "FORCED_FULL_CRAWL" ] }, "type": { "type": "string", "pattern": "S3" }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] } }, "required": [ "connectionConfiguration", "type", "syncMode", "repositoryConfigurations" ] } ``` ## Amazon Kendra Skema Templat Perayap Web Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Anda memberikan benih atau titik awal URLs, atau Anda dapat memberikan peta situs URLs, sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Alih-alih mencantumkan semua file Anda secara manual URLs, Anda dapat memberikan jalur ke Amazon S3 bucket yang menyimpan file teks untuk daftar file XHTML seed URLs atau sitemap Anda, yang dapat Anda gabungkan bersama dalam file ZIP di S3. Anda juga menentukan jenis sumber data sebagai`WEBCRAWLERV2`, kredensi otentikasi situs web dan jenis otentikasi jika situs web Anda memerlukan otentikasi, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html). **penting** Pembuatan konektor Web Crawler v2.0 tidak didukung oleh. CloudFormation Gunakan konektor Web Crawler v1.0 jika Anda memerlukan CloudFormation dukungan. *Saat memilih situs web untuk diindeks, Anda harus mematuhi [Kebijakan Penggunaan yang Diterima Amazon](https://aws.amazon.com/aup/) dan semua syarat Amazon lainnya. Ingat bahwa Anda hanya harus menggunakan Amazon Kendra Web Crawler untuk mengindeks halaman web Anda sendiri, atau halaman web yang Anda memiliki otorisasi untuk indeks. Untuk mempelajari cara menghentikan Amazon Kendra Web Crawler dari mengindeks situs web Anda, lihat. [Mengkonfigurasi `robots.txt` file untuk Amazon Kendra Web Crawler](stop-web-crawler.md)* Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Amazon Kendra Skema JSON Web Crawler](#web-crawler-json). Tabel berikut menjelaskan parameter skema Amazon Kendra Web Crawler JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. | | siteMapUrls | Daftar peta situs URLs untuk situs web yang ingin Anda jelajahi. Anda dapat membuat daftar hingga tiga URLs sitemap. | | s3 SeedUrl | Jalur S3 ke file teks yang menyimpan daftar benih atau titik URLs awal. Misalnya, s3://bucket-name/directory/. Setiap URL dalam file teks harus diformat pada baris terpisah. Anda dapat mencantumkan hingga 100 benih URLs dalam satu file. | | s3 SiteMapUrl | Jalur S3 ke file XMLpeta situs. Misalnya, s3://bucket-name/directory/. Anda dapat membuat daftar hingga tiga file XHTML sitemap. Anda dapat menggabungkan beberapa file peta situs ke dalam file ZIP dan menyimpan file ZIP di bucket Anda Amazon S3 . | | seedUrlConnections | Daftar benih atau titik awal URLs untuk situs web yang ingin Anda jelajahi. Anda dapat membuat daftar hingga 100 benih. URLs | | SeedURL | URL benih atau titik awal. | | autentikasi | Jenis otentikasi jika situs web Anda memerlukan otentikasi yang sama, jika tidak, tentukan. NoAuthentication | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar objek yang memetakan atribut atau nama bidang halaman web dan file halaman web Anda untuk Amazon Kendra mengindeks nama bidang. Misalnya, tag judul halaman web HTML dapat dipetakan ke bidang \$1document\$1title indeks. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. | | RateLimit | Jumlah maksimum URLs crawled per host situs web per menit. | | maxFileSize | Ukuran maksimum (dalam MB) halaman web atau lampiran untuk dirayapi. | | CrawlDepth | Jumlah level dari URL seed yang akan dirayapi. Misalnya, halaman URL benih adalah kedalaman 1 dan hyperlink apa pun di halaman ini yang juga dirayapi adalah kedalaman 2. | | maxLinksPerUrl | Jumlah maksimum URLs pada halaman web untuk disertakan saat merayapi situs web. Nomor ini per halaman web. Saat halaman web situs web dirayapi, semua URLs yang ditautkan ke halaman web juga dirayapi. URLs pada halaman web dirayapi dalam urutan penampilan. | | crawlSubDomain | trueuntuk merayapi domain situs web dengan subdomain. Misalnya, jika URL benih adalah "abc.example.com“, maka" "dana.abc.example.com" b.abc.example.com "juga dirayapi. Jika Anda tidak menyetel crawlSubDomain atau crawlAllDomain ketrue, maka Amazon Kendra hanya merayapi domain situs web yang ingin Anda jelajahi. | | crawlAllDomain | trueuntuk merayapi domain situs web dengan subdomain dan domain lain yang ditautkan halaman web. Jika Anda tidak menyetel crawlSubDomain atau crawlAllDomain ketrue, maka Amazon Kendra hanya merayapi domain situs web yang ingin Anda jelajahi. | | HonorRobots | trueuntuk menghormati arahan robots.txt dari situs web yang ingin Anda jelajahi. Arahan ini mengontrol cara Amazon Kendra Web Crawler merayapi situs web, apakah hanya Amazon Kendra dapat merayapi konten tertentu atau tidak merayapi konten apa pun. | | CrawlatTachments | trueuntuk merayapi file yang ditautkan ke halaman web. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk menyertakan crawling tertentu URLs dan mengindeks hyperlink apa pun di halaman web URL ini. URLs yang cocok dengan pola termasuk dalam indeks. URLs yang tidak cocok dengan pola dikecualikan dari indeks. Jika URL cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan halaman web URL/situs web tidak disertakan dalam indeks. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk mengecualikan perayapan tertentu URLs dan mengindeks hyperlink apa pun di halaman web URL ini. URLs yang cocok dengan pola dikecualikan dari indeks. URLs yang tidak cocok dengan pola yang termasuk dalam indeks. Jika URL cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan halaman web URL/situs web tidak disertakan dalam indeks. | | inclusionFileIndexPola | Daftar pola ekspresi reguler untuk menyertakan file halaman web tertentu. File yang cocok dengan pola disertakan dalam indeks. File yang tidak cocok dengan pola dikecualikan dari indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan file tidak disertakan dalam indeks. | | exclusionFileIndexPola | Daftar pola ekspresi reguler untuk mengecualikan file halaman web tertentu. File yang cocok dengan pola dikecualikan dari indeks. File yang tidak cocok dengan pola disertakan dalam indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan file tidak disertakan dalam indeks. | | implicitWaitDuration | implicitWaitDuration menentukan berapa lama konektor akan menunggu, dalam hitungan detik, sebelum merayapi halaman web. Rentang: 0-10 misalnya. “implicitWaitDuration“: “5" | | proxy | Informasi konfigurasi diperlukan untuk terhubung ke situs web internal Anda melalui proxy web. | | host | Nama host dari proxy sever yang ingin Anda gunakan untuk terhubung ke situs web internal. Misalnya, nama host https://a.example.com/page1.htmladalah "a.example.com”. | | port | Nomor port dari pemutus proxy yang ingin Anda gunakan untuk terhubung ke situs web internal. Misalnya, 443 adalah port standar untuk HTTPS. | | sekretarn (proxy) | Jika kredensyal proxy web diperlukan untuk terhubung ke host situs web, Anda dapat membuat AWS Secrets Manager rahasia yang menyimpan kredensialnya. Berikan Nama Sumber Daya Amazon (ARN) rahasia tersebut. | | jenis | Jenis sumber data. Tentukan WEBCRAWLERV2 sebagai tipe sumber data Anda. | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang digunakan jika situs web Anda memerlukan otentikasi untuk mengakses situs web. Anda menyimpan kredensi otentikasi untuk situs web dalam rahasia yang berisi pasangan nilai kunci JSON. Jika Anda menggunakan dasar, atau NTML/KerberOS, masukkan nama pengguna dan kata sandi. Kunci JSON dalam rahasia harus `userName` dan`password`. Protokol otentikasi NTLM mencakup hashing kata sandi, dan protokol otentikasi Kerberos mencakup enkripsi kata sandi. Jika Anda menggunakan SAFL atau otentikasi formulir, masukkan nama pengguna dan kata sandi, XPath untuk bidang nama pengguna (dan tombol nama pengguna jika menggunakan SAFL), XPaths untuk bidang dan tombol kata sandi, dan URL halaman login. Kunci JSON dalam rahasia harus`userName`,,, `password``userNameFieldXpath`,`userNameButtonXpath`, `passwordFieldXpath``passwordButtonXpath`, dan`loginPageUrl`. Anda dapat menemukan elemen XPaths (XMLPath Language) menggunakan alat pengembang browser web Anda. XPaths biasanya mengikuti format ini:`//tagname[@Attribute='Value']`. Amazon Kendra juga memeriksa apakah informasi titik akhir (seed URLs) yang disertakan dalam rahasia sama dengan informasi titik akhir yang ditentukan dalam detail konfigurasi titik akhir sumber data Anda. | | versi | Versi template ini yang saat ini didukung. | ### Amazon Kendra Skema JSON Web Crawler ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "siteMapUrls": { "type": "array", "items":{ "type": "string", "pattern": "https://.*" } }, "s3SeedUrl": { "type": "string", "pattern": "s3:.*" }, "s3SiteMapUrl": { "type": "string", "pattern": "s3:.*" }, "seedUrlConnections": { "type": "array", "items": [ { "type": "object", "properties": { "seedUrl":{ "type": "string", "pattern": "https://.*" } }, "required": [ "seedUrl" ] } ] }, "authentication": { "type": "string", "enum": [ "NoAuthentication", "BasicAuth", "NTLM_Kerberos", "Form", "SAML" ] } } } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "webPage": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "attachment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } } }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL" ] }, "additionalProperties": { "type": "object", "properties": { "rateLimit": { "type": "string", "default": "300" }, "maxFileSize": { "type": "string", "default": "50" }, "crawlDepth": { "type": "string", "default": "2" }, "maxLinksPerUrl": { "type": "string", "default": "100" }, "crawlSubDomain": { "type": "boolean", "default": false }, "crawlAllDomain": { "type": "boolean", "default": false }, "honorRobots": { "type": "boolean", "default": false }, "crawlAttachments": { "type": "boolean", "default": false }, "inclusionURLCrawlPatterns": { "type": "array", "items": { "type": "string" } }, "exclusionURLCrawlPatterns": { "type": "array", "items": { "type": "string" } }, "inclusionURLIndexPatterns": { "type": "array", "items": { "type": "string" } }, "exclusionURLIndexPatterns": { "type": "array", "items": { "type": "string" } }, "inclusionFileIndexPatterns": { "type": "array", "items": { "type": "string" } }, "exclusionFileIndexPatterns": { "type": "array", "items": { "type": "string" } }, "proxy": { "type": "object", "properties": { "host": { "type": "string" }, "port": { "type": "string" }, "secretArn": { "type": "string", "minLength": 20, "maxLength": 2048 } } } }, "implicitWaitDuration": { "type":"object", "properties": { "innerNumber" : { "type": "number", "minimum": 0, "maximum": 10 } } }, "required": [ "rateLimit", "maxFileSize", "crawlDepth", "crawlSubDomain", "crawlAllDomain", "maxLinksPerUrl", "honorRobots" ] }, "type": { "type": "string", "pattern": "WEBCRAWLERV2" }, "secretArn": { "type": "string", "minLength": 20, "maxLength": 2048 } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "type", "additionalProperties" ] } ``` ## Skema templat pertemuan Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda memberikan URL host Confluence, metode hosting, dan jenis otentikasi sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Juga tentukan jenis sumber data sebagai`CONFLUENCEV2`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Skema Confluence JSON](#confluence-json). Tabel berikut menjelaskan parameter skema Confluence JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. | | HostURL | URL untuk instance Confluence Anda. Misalnya, https://example.confluence.com. | | jenis | Metode hosting untuk instance Confluence Anda, apakah SAAS dan. ON\$1PREM | | authType | Metode otentikasi untuk instance Confluence Anda, apakahBasic, OAuth2 atau. Personal-token | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar objek yang memetakan atribut atau nama bidang ruang Confluence Anda, halaman, blog, komentar, dan lampiran untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). Nama bidang sumber data Confluence harus ada di metadata kustom Confluence Anda. | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. | | isCrawlAcl | Konfigurasikan true untuk merayapi informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. Perhatikan bahwa ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Ini berarti bahwa jika isCrawlACL dimatikan, dokumen dapat dicari secara publik. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). | | fieldForUserId | Tentukan email apakah Anda ingin menggunakan email pengguna untuk ID pengguna. emaildigunakan secara default dan saat ini satu-satunya tipe ID pengguna yang didukung. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk menyertakan and/or mengecualikan file tertentu dalam sumber data Confluence Anda. File yang cocok dengan pola disertakan dalam indeks. File yang tidak cocok dengan pola dikecualikan dari indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan dan file tidak disertakan dalam indeks. | | ProxyHost | Nama host dari proxy web yang Anda gunakan, tanpa https:// protokol http:// atau. | | ProxyPort | Nomor port yang digunakan oleh protokol transport URL host. Harus berupa nilai numerik antara 0 dan 65535. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | trueuntuk merayapi file di ruang pribadi Confluence Anda, halaman, blog, komentar halaman, lampiran halaman, komentar blog, dan lampiran blog. | | maxFileSizeInMegaBytes | Tentukan batas ukuran file MBs yang Amazon Kendra dapat dirayapi. Amazon Kendra hanya merayapi file dalam batas ukuran yang Anda tentukan. Ukuran file default adalah 50MB. Ukuran file maksimum harus lebih besar dari 0MB dan kurang dari atau sama dengan 50MB. | | jenis | Jenis sumber data. Tentukan CONFLUENCEV2 sebagai tipe sumber data Anda. | | enableIdentityCrawler | trueuntuk menggunakan Amazon Kendra crawler identitas untuk menyinkronkan identity/principal informasi pada pengguna dan grup dengan akses ke dokumen tertentu. Jika perayap identitas dimatikan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang berisi pasangan kunci-nilai yang diperlukan untuk terhubung ke Confluence Anda. Untuk informasi tentang pasangan nilai kunci ini, lihat [Instruksi koneksi untuk](https://docs.aws.amazon.com/kendra/latest/dg/data-source-v2-confluence.html#data-source-procedure-v2-confluence) Confluence. | | versi | Versi template ini yang saat ini didukung. | ### Skema Confluence JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "hostUrl": { "type": "string", "pattern": "https:.*" }, "type": { "type": "string", "enum": [ "SAAS", "ON_PREM" ] }, "authType": { "type": "string", "enum": [ "Basic", "OAuth2", "Personal-token" ] } }, "required": [ "hostUrl", "type", "authType" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "space": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "page": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "blog": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "comment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "attachment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } } }, "additionalProperties": { "type": "object", "properties": { "usersAclS3FilePath": { "type": "string" }, "isCrawlAcl": { "type": "boolean" }, "fieldForUserId": { "type": "string" }, "inclusionSpaceKeyFilter": { "type": "array", "items": { "type": "string" } }, "exclusionSpaceKeyFilter": { "type": "array", "items": { "type": "string" } }, "pageTitleRegEX": { "type": "array", "items": { "type": "string" } }, "blogTitleRegEX": { "type": "array", "items": { "type": "string" } }, "commentTitleRegEX": { "type": "array", "items": { "type": "string" } }, "attachmentTitleRegEX": { "type": "array", "items": { "type": "string" } }, "isCrawlPersonalSpace": { "type": "boolean" }, "isCrawlArchivedSpace": { "type": "boolean" }, "isCrawlArchivedPage": { "type": "boolean" }, "isCrawlPage": { "type": "boolean" }, "isCrawlBlog": { "type": "boolean" }, "isCrawlPageComment": { "type": "boolean" }, "isCrawlPageAttachment": { "type": "boolean" }, "isCrawlBlogComment": { "type": "boolean" }, "isCrawlBlogAttachment": { "type": "boolean" }, "maxFileSizeInMegaBytes": { "type":"string" }, "inclusionFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionUrlPatterns": { "type": "array", "items": { "type": "string" } }, "exclusionUrlPatterns": { "type": "array", "items": { "type": "string" } }, "proxyHost": { "type": "string" }, "proxyPort": { "type": "string" } }, "required": [] }, "type": { "type": "string", "pattern": "CONFLUENCEV2" }, "enableIdentityCrawler": { "type": "boolean" }, "syncMode": { "type": "string", "enum": [ "FULL_CRAWL", "FORCED_FULL_CRAWL" ] }, "secretArn": { "type": "string", "minLength": 20, "maxLength": 2048 } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## Skema templat Dropbox Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda memberikan kunci aplikasi Dropbox, rahasia aplikasi, dan token akses sebagai bagian dari rahasia Anda yang menyimpan kredensyal otentikasi Anda. Juga tentukan jenis sumber data sebagai`DROPBOX`, jenis token akses yang ingin Anda gunakan (sementara atau permanen), dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Skema Dropbox JSON](#dropbox-json). Tabel berikut menjelaskan parameter skema Dropbox JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. Sumber data ini tidak menentukan titik akhir direpositoryEndpointMetadata. Sebaliknya, informasi koneksi termasuk dalam AWS Secrets Manager rahasia yang Anda berikansecretArn. | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar objek yang memetakan atribut atau nama bidang file Dropbox, Dropbox Paper, dan pintasan untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | enableIdentityCrawler | trueuntuk menggunakan Amazon Kendra crawler identitas untuk menyinkronkan identity/principal informasi pada pengguna dan grup dengan akses ke dokumen tertentu. Jika perayap identitas dimatikan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup. | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang berisi pasangan nilai kunci yang diperlukan untuk terhubung ke Dropbox Anda. Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "appKey": "Dropbox app key",
    "appSecret": "Dropbox app secret",
    "accesstoken": "temporary access token or refresh access token"
}
| | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. | | isCrawlAcl | trueuntuk merayapi informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk menyertakan nama dan jenis file tertentu di sumber data Dropbox Anda. File yang cocok dengan pola disertakan dalam indeks. File yang tidak cocok dengan pola dikecualikan dari indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan dan file tidak disertakan dalam indeks. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk mengecualikan nama dan jenis file tertentu di sumber data Dropbox Anda. File yang cocok dengan pola dikecualikan dari indeks. File yang tidak cocok dengan pola disertakan dalam indeks. Jika file cocok dengan pola pengecualian dan inklusi, pola pengecualian akan diutamakan dan file tidak disertakan dalam indeks. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | trueuntuk merayapi file di Dropbox, dokumen Dropbox Paper, templat Dropbox Paper, dan pintasan halaman web yang disimpan di Dropbox Anda. | | jenis | Jenis sumber data. Tentukan DROPBOX sebagai tipe sumber data Anda. | | TokenType | Tentukan jenis token akses Anda: token akses permanen atau sementara. Anda disarankan untuk membuat token akses penyegaran yang tidak pernah kedaluwarsa di Dropbox daripada mengandalkan token akses satu kali yang kedaluwarsa setelah 4 jam. Anda membuat aplikasi dan token akses refresh di konsol pengembang Dropbox dan menyediakan token akses dalam rahasia Anda. | | versi | Versi template ini yang saat ini didukung. | ### Skema Dropbox JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { } } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "file": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "LONG", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "dd-MM-yyyy HH:mm:ss" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] }, "paper": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "LONG", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "dd-MM-yyyy HH:mm:ss" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] }, "papert": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "LONG", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "dd-MM-yyyy HH:mm:ss" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] }, "shortcut": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "LONG", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "dd-MM-yyyy HH:mm:ss" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] } } }, "syncMode": { "type": "string", "enum": [ "FULL_CRAWL", "FORCED_FULL_CRAWL", "CHANGE_LOG" ] }, "enableIdentityCrawler": { "type": "boolean" }, "secretArn": { "type": "string" }, "additionalProperties": { "type": "object", "properties": { "isCrawlAcl": { "type": "boolean" }, "inclusionFileNamePatterns": { "type": "array" }, "exclusionFileNamePatterns": { "type": "array" }, "inclusionFileTypePatterns": { "type": "array" }, "exclusionFileTypePatterns": { "type": "array" }, "crawlFile": { "type": "boolean" }, "crawlPaper": { "type": "boolean" }, "crawlPapert": { "type": "boolean" }, "crawlShortcut": { "type": "boolean" } } }, "type": { "type": "string", "pattern": "DROPBOX" }, "tokenType": { "type": "string", "enum": [ "PERMANENT", "TEMPORARY" ] }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] } }, "additionalProperties": false, "required": [ "connectionConfiguration", "repositoryConfigurations", "additionalProperties", "syncMode", "enableIdentityCrawler", "secretArn", "type", "tokenType" ] } ``` ## Skema template Drupal Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Anda memberikan URL host Drupal dan jenis otentikasi sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Juga tentukan jenis sumber data sebagai DRUPAL, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Skema JSON Drupal](#drupal-json). Tabel berikut menjelaskan parameter skema JSON Drupal. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. | | HostURL | URL host situs web Drupal Anda. Misalnya, https:///. | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar objek yang memetakan atribut atau nama bidang file Drupal Anda. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). Nama bidang sumber data Drupal harus ada di metadata kustom Drupal Anda. | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk menyertakan file tertentu dalam sumber data Drupal Anda. File yang cocok dengan pola disertakan dalam indeks. File yang tidak cocok dengan pola dikecualikan dari indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan dan file tidak disertakan dalam indeks. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk mengecualikan file tertentu di sumber data Drupal Anda. File yang cocok dengan pola dikecualikan dari indeks. File yang tidak cocok dengan pola disertakan dalam indeks. Jika file cocok dengan pola pengecualian dan inklusi, pola pengecualian akan diutamakan dan file tidak disertakan dalam indeks. | | ContentDefinitions[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Tentukan jenis konten yang akan dirayapi dan apakah akan merayapi komentar dan lampiran untuk jenis konten yang Anda pilih. | | jenis | Jenis sumber data. Tentukan DRUPAL sebagai tipe sumber data Anda. | | authType | Jenis otentikasi yang Anda gunakan, apakah BASIC-AUTH atauOAUTH2. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | enableIdentityCrawler | trueuntuk menggunakan Amazon Kendra crawler identitas untuk menyinkronkan identity/principal informasi pada pengguna dan grup dengan akses ke dokumen tertentu. Jika perayap identitas dimatikan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup. | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang berisi pasangan kunci-nilai yang diperlukan untuk terhubung ke Drupal Anda. Rahasianya harus berisi struktur JSON dengan kunci berikut: **Jika menggunakan otentikasi dasar:**
{
    "username": "user name",
    "passwords": "password"
}
**Jika menggunakan otentikasi OAuth 2.0:**
{
    "username": "user name",
    "password": "password",
    "clientId": "client id",
    "clientSecret": "client secret"
}
| | versi | Versi template ini yang saat ini didukung. | ### Skema JSON Drupal ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "hostUrl": { "type": "string", "pattern": "https:.*" } }, "required": [ "hostUrl" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "content": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "comment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "attachment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } } }, "additionalProperties": { "type": "object", "properties": { "isCrawlArticle": { "type": "boolean" }, "isCrawlBasicPage": { "type": "boolean" }, "isCrawlBasicBlock": { "type": "boolean" }, "crawlCustomContentTypesList": { "type": "array", "items": { "type": "string" } }, "crawlCustomBlockTypesList": { "type": "array", "items": { "type": "string" } }, "filePath": { "anyOf": [ { "type": "string", "pattern": "s3:.*" }, { "type": "string", "pattern": "" } ] }, "inclusionFileNamePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionFileNamePatterns": { "type": "array", "items": { "type": "string" } }, "articleTitleInclusionPatterns": { "type": "array", "items": { "type": "string" } }, "articleTitleExclusionPatterns": { "type": "array", "items": { "type": "string" } }, "pageTitleInclusionPatterns": { "type": "array", "items": { "type": "string" } }, "pageTitleExclusionPatterns": { "type": "array", "items": { "type": "string" } }, "customContentTitleInclusionPatterns": { "type": "array", "items": { "type": "string" } }, "customContentTitleExclusionPatterns": { "type": "array", "items": { "type": "string" } }, "basicBlockTitleInclusionPatterns": { "type": "array", "items": { "type": "string" } }, "basicBlockTitleExclusionPatterns": { "type": "array", "items": { "type": "string" } }, "customBlockTitleInclusionPatterns": { "type": "array", "items": { "type": "string" } }, "customBlockTitleExclusionPatterns": { "type": "array", "items": { "type": "string" } }, "contentDefinitions": { "type": "array", "items": { "properties": { "contentType": { "type": "string" }, "fieldDefinition": { "type": "array", "items": [ { "type": "object", "properties": { "machineName": { "type": "string" }, "type": { "type": "string" } }, "required": [ "machineName", "type" ] } ] }, "isCrawlComments": { "type": "boolean" }, "isCrawlFiles": { "type": "boolean" } } }, "required": [ "contentType", "fieldDefinition", "isCrawlComments", "isCrawlFiles" ] } }, "required": [] }, "type": { "type": "string", "pattern": "DRUPAL" }, "authType": { "type": "string", "enum": [ "BASIC-AUTH", "OAUTH2" ] }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "enableIdentityCrawler": { "type": "boolean" }, "secretArn": { "type": "string", "minLength": 20, "maxLength": 2048 } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## GitHub skema templat Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Anda memberikan URL GitHub host, nama organisasi, dan apakah Anda menggunakan GitHub GitHub cloud atau lokal sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Juga tentukan jenis sumber data sebagai`GITHUB`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [GitHub Skema JSON](#github-json). Tabel berikut menjelaskan parameter skema GitHub JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. | | jenis | Tentukan jenisnya sebagai salah satu SAAS atauON\$1PREMISE. | | HostURL | URL GitHub host. Misalnya, jika Anda menggunakan GitHub SaaS/Enterprise Cloud:. https://api.github.com Atau, jika Anda menggunakan GitHub On-Premises/Enterprise Server:. https://on-prem-host-url/api/v3/ | | Nama Organisasi | Anda dapat menemukan nama organisasi Anda ketika Anda masuk ke GitHub desktop dan pergi ke Organisasi Anda di bawah dropdown gambar profil Anda. | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar objek yang memetakan atribut atau nama bidang GitHub konten Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. | | isCrawlAcl | trueuntuk merayapi informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses dan dicari oleh pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). | | fieldForUserId | Tentukan jenis ID pengguna yang ingin Anda gunakan untuk perayapan ACL. Tentukan email apakah Anda ingin menggunakan email pengguna untuk ID pengguna, atau username jika Anda ingin menggunakan nama pengguna untuk ID pengguna. Jika Anda tidak menentukan opsi maka email digunakan secara default. | | RepositoryFilter | Daftar nama repositori tertentu dan nama cabang yang ingin Anda indeks. | | CrawlRepository | trueuntuk merayapi repositori. | | crawlRepositoryDocuments | trueuntuk merayapi dokumen repositori. | | CrawlIssue | trueuntuk merayapi masalah. | | crawlIssueComment | trueuntuk merayapi komentar masalah. | | crawlIssueCommentLampiran | trueuntuk merayapi lampiran komentar masalah. | | crawlPullRequest | trueuntuk merayapi permintaan tarik. | | crawlPullRequestKomentar | trueuntuk merayapi komentar permintaan tarik. | | crawlPullRequestCommentAttachment | trueuntuk merayapi lampiran komentar permintaan tarik. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk menyertakan konten tertentu dalam sumber GitHub data Anda. Konten yang cocok dengan pola disertakan dalam indeks. Konten yang tidak cocok dengan pola dikecualikan dari indeks. Jika ada konten yang cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan konten tidak disertakan dalam indeks. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk mengecualikan konten tertentu dalam sumber GitHub data Anda. Konten yang cocok dengan pola dikecualikan dari indeks. Konten yang tidak cocok dengan pola disertakan dalam indeks. Jika ada konten yang cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan konten tidak disertakan dalam indeks. | | jenis | Jenis sumber data. Tentukan GITHUB sebagai tipe sumber data Anda. | | enableIdentityCrawler | trueuntuk menggunakan Amazon Kendra crawler identitas untuk menyinkronkan identity/principal informasi pada pengguna dan grup dengan akses ke dokumen tertentu. Jika perayap identitas dimatikan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang berisi pasangan kunci-nilai yang diperlukan untuk terhubung ke Anda. GitHub Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "personalToken": "token"
}
| | versi | Versi template ini yang saat ini didukung. | ### GitHub Skema JSON Berikut ini adalah skema GitHub JSON: ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "type": { "type": "string" }, "hostUrl": { "type": "string", "pattern": "https://.*" }, "organizationName": { "type": "string" } }, "required": [ "type", "hostUrl", "organizationName" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "ghRepository": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "ghCommit": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "ghIssueDocument": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "ghIssueComment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "ghIssueAttachment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "ghPRDocument": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "ghPRComment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "ghPRAttachment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } } }, "additionalProperties": { "type": "object", "properties": { "isCrawlAcl": { "type": "boolean" }, "fieldForUserId": { "type": "string" }, "crawlRepository": { "type": "boolean" }, "crawlRepositoryDocuments": { "type": "boolean" }, "crawlIssue": { "type": "boolean" }, "crawlIssueComment": { "type": "boolean" }, "crawlIssueCommentAttachment": { "type": "boolean" }, "crawlPullRequest": { "type": "boolean" }, "crawlPullRequestComment": { "type": "boolean" }, "crawlPullRequestCommentAttachment": { "type": "boolean" }, "repositoryFilter": { "type": "array", "items": [ { "type": "object", "properties": { "repositoryName": { "type": "string" }, "branchNameList": { "type": "array", "items": { "type": "string" } } } } ] }, "inclusionFolderNamePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionFileNamePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionFolderNamePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionFileNamePatterns": { "type": "array", "items": { "type": "string" } } }, "required": [] }, "type": { "type": "string", "pattern": "GITHUB" }, "syncMode": { "type": "string", "enum": [ "FULL_CRAWL", "FORCED_FULL_CRAWL", "CHANGE_LOG" ] }, "enableIdentityCrawler": { "type": "boolean" }, "secretArn": { "type": "string", "minLength": 20, "maxLength": 2048 } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "enableIdentityCrawler" ] } ``` ## Skema template Gmail Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Tentukan jenis sumber data sebagai`GMAIL`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Skema JSON Gmail](#gmail-json). Tabel berikut menjelaskan parameter skema JSON Gmail. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. Sumber data ini tidak menentukan titik akhir direpositoryEndpointMetadata. Sebaliknya, informasi koneksi termasuk dalam AWS Secrets Manager rahasia yang Anda berikansecretArn. | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. Tentukan jenis sumber data dan ARN rahasia. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar objek yang memetakan atribut atau nama bidang pesan dan lampiran Gmail Anda ke nama bidang Amazon Kendra indeks. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk menyertakan atau mengecualikan pesan dengan nama subjek tertentu di sumber data Gmail Anda. File yang cocok dengan pola disertakan dalam indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan file tersebut tidak disertakan dalam indeks. | | beforeDateFilter | Tentukan pesan dan lampiran yang akan disertakan sebelum tanggal tertentu. | | afterDateFilter | Tentukan pesan dan lampiran yang akan disertakan setelah tanggal tertentu. | | isCrawlAttachment | Nilai Boolean untuk memilih apakah Anda ingin meng-crawl lampiran. Pesan dirayapi secara otomatis. | | jenis | Jenis sumber data. Tentukan GMAIL sebagai tipe sumber data Anda. | | shouldCrawlDraftPesan | Nilai Boolean untuk memilih apakah Anda ingin merayapi pesan draf. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) Karena tidak ada API untuk memperbarui pesan Gmail yang dihapus secara permanen, sinkronisasi konten baru, dimodifikasi, atau dihapus: Tidak akan menghapus pesan yang dihapus secara permanen dari Gmail dari Amazon Kendra indeks Anda Tidak akan menyinkronkan perubahan pada label email Gmail Untuk menyinkronkan perubahan label sumber data Gmail dan pesan email yang dihapus secara permanen ke Amazon Kendra indeks, Anda harus menjalankan crawl penuh secara berkala. | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari rahasia Secrets Manager yang berisi pasangan nilai kunci yang diperlukan untuk terhubung ke Gmail Anda. Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "adminAccountEmailId": "service account email",
    "clientEmailId": "user account email",
    "privateKey": "private key"
}
| | versi | Versi template yang saat ini didukung. | ### Skema JSON Gmail ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { } }, "repositoryConfigurations": { "type": "object", "properties": { "message": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": ["STRING", "STRING_LIST", "DATE"] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "attachments": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": ["STRING"] }, "dataSourceFieldName": { "type": "string" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } } }, "required": [] }, "additionalProperties": { "type": "object", "properties": { "inclusionLabelNamePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionLabelNamePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionAttachmentTypePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionAttachmentTypePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionAttachmentNamePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionAttachmentNamePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionSubjectFilter": { "type": "array", "items": { "type": "string" } }, "exclusionSubjectFilter": { "type": "array", "items": { "type": "string" } }, "isSubjectAnd": { "type": "boolean" }, "inclusionFromFilter": { "type": "array", "items": { "type": "string" } }, "exclusionFromFilter": { "type": "array", "items": { "type": "string" } }, "inclusionToFilter": { "type": "array", "items": { "type": "string" } }, "exclusionToFilter": { "type": "array", "items": { "type": "string" } }, "inclusionCcFilter": { "type": "array", "items": { "type": "string" } }, "exclusionCcFilter": { "type": "array", "items": { "type": "string" } }, "inclusionBccFilter": { "type": "array", "items": { "type": "string" } }, "exclusionBccFilter": { "type": "array", "items": { "type": "string" } }, "beforeDateFilter": { "anyOf": [ { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$" }, { "type": "string", "pattern": "" } ] }, "afterDateFilter": { "anyOf": [ { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$" }, { "type": "string", "pattern": "" } ] }, "isCrawlAttachment": { "type": "boolean" }, "shouldCrawlDraftMessages": { "type": "boolean" } }, "required": [ "isCrawlAttachment", "shouldCrawlDraftMessages" ] }, "type" : { "type" : "string", "pattern": "GMAIL" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL" ] }, "secretArn": { "type": "string" }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] } }, "required": [ "connectionConfiguration", "repositoryConfigurations", "additionalProperties", "syncMode", "secretArn", "type" ] } ``` ## Skema templat Google Drive Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Tentukan jenis sumber data sebagai`GOOGLEDRIVE2`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Skema Google Drive JSON](#googledrive-json). Tabel berikut menjelaskan parameter skema Google Drive JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. Sumber data ini tidak menentukan titik akhir. Anda memilih jenis otentikasi Anda: serviceAccount danOAuth2. Informasi koneksi termasuk dalam AWS Secrets Manager rahasia yang Anda berikansecretArn. | | authType | Pilih antara serviceAccount dan OAuth2 berdasarkan kasus penggunaan Anda. | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar objek yang memetakan atribut atau nama bidang Google Drive Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Tentukan batas ukuran file MBs yang Amazon Kendra seharusnya dirayapi. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | trueuntuk merayapi komentar di sumber data Google Drive Anda. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | trueuntuk meng-crawl MyDrive dan Shared With Me Drive di sumber data Google Drive Anda. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | trueuntuk merayapi Drive Bersama di sumber data Google Drive Anda. | | isCrawlAcl | trueuntuk merayapi informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses dan dicari oleh pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk mengecualikan file tertentu di sumber data Google Drive Anda. File yang cocok dengan pola dikecualikan dari indeks. File yang tidak cocok dengan pola disertakan dalam indeks. Jika file cocok dengan pola pengecualian dan inklusi, pola pengecualian akan diutamakan, dan file tersebut tidak disertakan dalam indeks. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk menyertakan file tertentu di sumber data Google Drive Anda. File yang cocok dengan pola disertakan dalam indeks. File yang tidak cocok dengan pola dikecualikan dari indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan file tersebut tidak disertakan dalam indeks. | | jenis | Jenis sumber data. Tentukan GOOOGLEDRIVEV2 sebagai tipe sumber data Anda. | | enableIdentityCrawler | trueuntuk menggunakan Amazon Kendra crawler identitas untuk menyinkronkan identity/principal informasi pada pengguna dan grup dengan akses ke dokumen tertentu. Jika perayap identitas dimatikan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang berisi pasangan kunci-nilai yang diperlukan untuk terhubung ke Google Drive Anda. Rahasianya harus berisi struktur JSON dengan kunci berikut: ****Jika menggunakan otentikasi Akun Layanan Google:
{
    "clientEmail": "user account email",
    "adminAccountEmail": "service account email",
    "privateKey": "private key"
}
****Jika menggunakan otentikasi OAuth 2.0: 
{
    "clientID": "OAuth client ID",
    "clientSecret": "client secret",
    "refreshToken": "refresh token"
}
| | versi | Versi template ini yang saat ini didukung. | ### Skema Google Drive JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "authType": { "type": "string", "enum": [ "serviceAccount", "OAuth2" ] } }, "required": [ "authType" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "file": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE", "STRING_LIST", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "comment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE", "STRING_LIST" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } } }, "additionalProperties": { "type": "object", "properties": { "maxFileSizeInMegaBytes": { "type": "string" }, "isCrawlComment": { "type": "boolean" }, "isCrawlMyDriveAndSharedWithMe": { "type": "boolean" }, "isCrawlSharedDrives": { "type": "boolean" }, "isCrawlAcl": { "type": "boolean" }, "excludeUserAccounts": { "type": "array", "items": { "type": "string" } }, "excludeSharedDrives": { "type": "array", "items": { "type": "string" } }, "excludeMimeTypes": { "type": "array", "items": { "type": "string" } }, "includeUserAccounts": { "type": "array", "items": { "type": "string" } }, "includeSharedDrives": { "type": "array", "items": { "type": "string" } }, "includeMimeTypes": { "type": "array", "items": { "type": "string" } }, "includeTargetAudienceGroup": { "type": "array", "items": { "type": "string" } }, "inclusionFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionFileNamePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionFileNamePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionFilePathFilter": { "type": "array", "items": { "type": "string" } }, "exclusionFilePathFilter": { "type": "array", "items": { "type": "string" } } } }, "type": { "type": "string", "pattern": "GOOGLEDRIVEV2" }, "enableIdentityCrawler": { "type": "boolean" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "secretArn": { "type": "string", "minLength": 20, "maxLength": 2048 } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## Skema DB2 templat IBM Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Tentukan jenis sumber data sebagai`JDBC`, tipe database sebagai`db2`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [IBM DB2 JSON skema](#ibm-db2-json). Tabel berikut menjelaskan parameter skema IBM DB2 JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi konfigurasi yang diperlukan untuk menghubungkan sumber data Anda.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. Tentukan jenis sumber data dan ARN rahasia. | | dokumen | Daftar objek yang memetakan atribut atau nama bidang konten database Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. Gunakan untuk menyertakan atau mengecualikan konten tertentu dalam sumber data database Anda. | | PrimaryKey | Berikan kunci utama untuk tabel database. Detail ini mengidentifikasi tabel di dalam basis data Anda. | | Judul Kolom | Berikan nama kolom judul dokumen dalam tabel database Anda. | | BodyColumn | Berikan nama kolom judul dokumen dalam tabel database Anda. | | SqlQuery | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | TimestampColumn | Masukkan nama kolom yang berisi stempel waktu. Amazon Kendra menggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. | | TimestampFormat | Masukkan nama kolom yang berisi format cap waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. | | timezone | Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. | | changeDetectingColumns | Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendra akan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini | | allowedUsersColumns | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | allowedGroupsColumn | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | sumber URIColumn | Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. | | isSslEnabled | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | jenis | Jenis sumber data. Tentukan JDBC sebagai tipe sumber data Anda. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari rahasia Secrets Manager yang berisi nama pengguna dan kata sandi yang diperlukan untuk terhubung ke database Anda. Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "user name": "database user name",
    "password": "password"
}
| | versi | Versi template yang saat ini didukung. | ### IBM DB2 JSON skema ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "dbType": { "type": "string", "enum": [ "mysql", "db2", "postgresql", "oracle", "sqlserver" ] }, "dbHost": { "type": "string" }, "dbPort": { "type": "string" }, "dbInstance": { "type": "string" } }, "required": [ "dbType", "dbHost", "dbPort", "dbInstance" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "document": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string" }, "dataSourceFieldName": { "type": "string" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } }, "required": [ ] }, "additionalProperties": { "type": "object", "properties": { "primaryKey": { "type": "string" }, "titleColumn": { "type": "string" }, "bodyColumn": { "type": "string" }, "sqlQuery": { "type": "string", "not": { "pattern": ";+" } }, "timestampColumn": { "type": "string" }, "timestampFormat": { "type": "string" }, "timezone": { "type": "string" }, "changeDetectingColumns": { "type": "array", "items": { "type": "string" } }, "allowedUsersColumn": { "type": "string" }, "allowedGroupsColumn": { "type": "string" }, "sourceURIColumn": { "type": "string" }, "isSslEnabled": { "type": "boolean" } }, "required": ["primaryKey", "titleColumn", "bodyColumn", "sqlQuery"] }, "type" : { "type" : "string", "pattern": "JDBC" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "secretArn": { "type": "string" } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## Skema templat Microsoft Exchange Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda memberikan ID penyewa sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Juga tentukan jenis sumber data sebagai`MSEXCHANGE`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Skema Microsoft Exchange JSON](#msexchange-json). Tabel berikut menjelaskan parameter skema Microsoft Exchange JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. | | TenanID | ID penyewa Microsoft 365. Anda dapat menemukan ID penyewa Anda di Properti Portal Direktori Aktif Azure Anda atau di aplikasi Anda OAuth . | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar objek yang memetakan atribut atau nama bidang sumber data Microsoft Exchange Anda ke bidang Amazon Kendra indeks. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten di sumber data Anda | | Pola Inklusi | Daftar pola ekspresi reguler untuk menyertakan file tertentu di sumber data Microsoft Exchange Anda. File yang cocok dengan pola disertakan dalam indeks. File yang tidak cocok dengan pola dikecualikan dari indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan dan file tidak disertakan dalam indeks. | | Pola Pengecualian | Daftar pola ekspresi reguler untuk mengecualikan file tertentu di sumber data Microsoft Exchange Anda. File yang cocok dengan pola dikecualikan dari indeks. File yang tidak cocok dengan pola disertakan dalam indeks. Jika file cocok dengan pola pengecualian dan inklusi, pola pengecualian akan diutamakan dan file tidak disertakan dalam indeks. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk menyertakan pengguna dan file pengguna tertentu di sumber data Microsofot Exchange Anda. Pengguna yang cocok dengan pola disertakan dalam indeks. Pengguna yang tidak cocok dengan pola dikecualikan dari indeks. Jika pengguna cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan dan pengguna tidak disertakan dalam indeks. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk mengecualikan pengguna dan file pengguna tertentu di sumber data Microsoft Exchange Anda. Pengguna yang cocok dengan pola dikecualikan dari indeks. Pengguna yang tidak cocok dengan pola disertakan dalam indeks. Jika pengguna cocok dengan pola pengecualian dan inklusi, pola pengecualian akan diutamakan dan pengguna tidak disertakan dalam indeks. | | S3BucketName | Nama bucket S3 Anda jika ingin Anda gunakan. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | trueuntuk merayapi jenis konten ini dan informasi kontrol akses sumber data Microsoft Exchange Anda. | | startCalendarDateWaktu | Anda dapat mengonfigurasi tanggal-waktu mulai tertentu untuk konten kalender Anda. | | endCalendarDateWaktu | Anda dapat mengonfigurasi tanggal-waktu akhir tertentu untuk konten kalender. | | subjek | Anda dapat mengonfigurasi baris subjek tertentu untuk konten email Anda. | | EmailDari | Anda dapat mengonfigurasi email tertentu untuk konten email 'Dari' atau pengirim. | | EmailTo | Anda dapat mengonfigurasi email tertentu untuk konten email 'Kepada' atau penerima. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | jenis | Jenis sumber data. Tentukan MSEXCHANGE sebagai tipe sumber data Anda. | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang berisi pasangan kunci-nilai yang diperlukan untuk terhubung ke Microsoft Exchange Anda. Ini termasuk ID klien Anda dan rahasia klien Anda yang dihasilkan saat Anda membuat OAuth aplikasi di portal Azure. | | versi | Versi template ini yang saat ini didukung. | ### Skema Microsoft Exchange JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "tenantId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "minLength": 36, "maxLength": 36 } }, "required": ["tenantId"] } } }, "repositoryConfigurations": { "type": "object", "properties": { "email": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": ["STRING", "STRING_LIST", "DATE"] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "attachment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": ["STRING", "DATE","LONG"] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "calendar": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": ["STRING", "STRING_LIST", "DATE"] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "contacts": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": ["STRING", "STRING_LIST", "DATE"] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "notes": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": ["STRING", "DATE"] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } }, "required": ["email" ] }, "additionalProperties": { "type": "object", "properties": { "inclusionPatterns": { "type": "array", "items": { "type": "string" } }, "exclusionPatterns": { "type": "array", "items": { "type": "string" } }, "inclusionUsersList": { "type": "array", "items": { "type": "string", "format": "email" } }, "exclusionUsersList": { "type": "array", "items": { "type": "string", "format": "email" } }, "s3bucketName": { "type": "string" }, "inclusionUsersFileName": { "type": "string" }, "exclusionUsersFileName": { "type": "string" }, "inclusionDomainUsers": { "type": "array", "items": { "type": "string" } }, "exclusionDomainUsers": { "type": "array", "items": { "type": "string" } }, "crawlCalendar": { "type": "boolean" }, "crawlNotes": { "type": "boolean" }, "crawlContacts": { "type": "boolean" }, "crawlFolderAcl": { "type": "boolean" }, "startCalendarDateTime": { "anyOf": [ { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$" }, { "type": "string", "pattern": "" } ] }, "endCalendarDateTime": { "anyOf": [ { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$" }, { "type": "string", "pattern": "" } ] }, "subject": { "type": "array", "items": { "type": "string" } }, "emailFrom": { "type": "array", "items": { "type": "string", "format": "email" } }, "emailTo": { "type": "array", "items": { "type": "string", "format": "email" } } }, "required": [ ] }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "type" : { "type" : "string", "pattern": "MSEXCHANGE" }, "secretArn": { "type": "string" } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## OneDrive Skema templat Microsoft Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda memberikan ID penyewa sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Juga tentukan jenis sumber data sebagai`ONEDRIVEV2`, dan rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Microsoft OneDrive JSON skema](#onedrive-json). Tabel berikut menjelaskan parameter skema Microsoft OneDrive JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. | | TenanID | ID penyewa Microsoft 365. Anda dapat menemukan ID penyewa Anda di Properti Portal Direktori Aktif Azure Anda atau di aplikasi Anda OAuth . | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | file | Daftar objek yang memetakan atribut atau nama bidang OneDrive file Microsoft Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Anda dapat memilih untuk mengindeks file, OneNote bagian, OneNote halaman, dan filter tertentu berdasarkan nama pengguna. | | isUserNameOnS3 | trueuntuk memberikan daftar nama pengguna dalam file yang disimpan dalam file Amazon S3. | | jenis | Jenis sumber data. Tentukan ONEDRIVEV2 sebagai tipe sumber data Anda. | | enableIdentityCrawler | trueuntuk menggunakan Amazon Kendra crawler identitas untuk menyinkronkan identity/principal informasi pada pengguna dan grup dengan akses ke dokumen tertentu. Jika perayap identitas dimatikan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup. | | jenis | Jenis sumber data. Tentukan ONEDRIVEV2 sebagai tipe sumber data Anda. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang berisi pasangan kunci-nilai yang diperlukan untuk terhubung ke Microsoft Anda. OneDrive Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "clientId": "client ID",
    "clientSecret": "client secret"
}
| | versi | Versi template ini yang saat ini didukung. | ### Microsoft OneDrive JSON skema ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "tenantId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "minLength": 36, "maxLength": 36 } }, "required": [ "tenantId" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "file": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } } }, "additionalProperties": { "type": "object", "properties": { "userNameFilter": { "type": "array", "items": { "type": "string" } }, "userFilterPath": { "type": "string" }, "isUserNameOnS3": { "type": "boolean" }, "inclusionFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionFileNamePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionFileNamePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionFilePathPatterns": { "type": "array", "items": { "type": "string" } }, "exclusionFilePathPatterns": { "type": "array", "items": { "type": "string" } }, "inclusionOneNoteSectionNamePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionOneNoteSectionNamePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionOneNotePageNamePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionOneNotePageNamePatterns": { "type": "array", "items": { "type": "string" } } }, "required": [] }, "enableIdentityCrawler": { "type": "boolean" }, "type": { "type": "string", "pattern": "ONEDRIVEV2" }, "syncMode": { "type": "string", "enum": [ "FULL_CRAWL", "FORCED_FULL_CRAWL", "CHANGE_LOG" ] }, "secretArn": { "type": "string", "minLength": 20, "maxLength": 2048 } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## SharePoint Skema templat Microsoft Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda memberikan URL SharePoint situs/URLs, domain, dan juga ID penyewa jika diperlukan sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Juga tentukan jenis sumber data sebagai`SHAREPOINTV2`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai **Tipe** saat Anda memanggil [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [SharePoint Skema JSON](#sharepoint-json). Tabel berikut menjelaskan parameter skema Microsoft SharePoint JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data | | TenanID | ID penyewa SharePoint akun Anda. | | domain | Domain SharePoint akun Anda. | | SiteURLS | Tuan rumah URLs SharePoint akun Anda. | | repositoryAdditionalProperties | Properti tambahan untuk terhubung dengan titik akhir repository/data sumber. | | S3BucketName | Nama Amazon S3 bucket yang menyimpan sertifikat X.509 yang ditandatangani sendiri Azure AD Anda. | | S3CertificateName | Nama sertifikat X.509 yang ditandatangani sendiri Azure AD disimpan di bucket Anda. Amazon S3 | | authType | Jenis otentikasi yang Anda gunakan, apakah,OAuth2,OAuth2Certificate,OAuth2App,Basic, OAuth2\$1RefreshTokenNTLM, atauKerberos. | | versi | SharePoint Versi yang Anda gunakan, apakah Server atauOnline. | | onPremVersion | Versi SharePoint Server yang Anda gunakan, apakah 2013 20162019, atauSubscriptionEdition. | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar objek yang memetakan atribut atau nama bidang SharePoint konten Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler ke konten include/exclude tertentu di sumber SharePoint data Anda. Item konten yang cocok dengan pola inklusi disertakan dalam indeks. Item konten yang tidak cocok dengan pola inklusi dikecualikan dari indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan file tersebut tidak disertakan dalam indeks. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | trueuntuk merayapi jenis konten ini. | | CrawlaCl | trueuntuk merayapi informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses dan dicari oleh pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). | | fieldForUserId | Tentukan email apakah Anda ingin menggunakan email pengguna untuk ID pengguna, atau userPrincipalName jika Anda ingin menggunakan nama pengguna untuk ID pengguna. Jika Anda tidak menentukan opsi maka email digunakan secara default. | | ACLConfiguration | Tentukan salah satu ACLWithLDAPEmailFmtACLWithManualEmailFmt,, atauACLWithUsernameFmtM. | | EmailDomain | Domain email. Misalnya, "amazon.com”. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | trueuntuk merayapi informasi pemetaan grup. | | ProxyHost | Nama host dari proxy web yang Anda gunakan, tanpa protokol http://atau https://. | | ProxyPort | Nomor port yang digunakan oleh protokol transport URL host. Harus berupa nilai numerik antara 0 dan 65535. | | jenis | Tentukan SHAREPOINTV2 sebagai tipe sumber data Anda | | enableIdentityCrawler | trueuntuk menggunakan Amazon Kendra crawler identitas untuk menyinkronkan identity/principal informasi pada pengguna dan grup dengan akses ke dokumen tertentu. Jika perayap identitas dimatikan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup. | | SyncMode | Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang berisi pasangan kunci-nilai yang diperlukan untuk terhubung ke Anda. SharePoint Untuk informasi tentang pasangan nilai kunci ini, lihat [Petunjuk koneksi untuk SharePoint Online dan SharePoint Server](https://docs.aws.amazon.com/kendra/latest/dg/data-source-v2-sharepoint.html#data-source-procedure-v2-sharepoint). | | versi | Versi template ini yang saat ini didukung. | ## SharePoint Skema JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "tenantId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "minLength": 36, "maxLength": 36 }, "domain": { "type": "string" }, "siteUrls": { "type": "array", "items": { "type": "string", "pattern": "https://.*" } }, "repositoryAdditionalProperties": { "type": "object", "properties": { "s3bucketName": { "type": "string" }, "s3certificateName": { "type": "string" }, "authType": { "type": "string", "enum": [ "OAuth2", "OAuth2Certificate", "OAuth2App", "Basic", "OAuth2_RefreshToken", "NTLM", "Kerberos" ] }, "version": { "type": "string", "enum": [ "Server", "Online" ] }, "onPremVersion": { "type": "string", "enum": [ "", "2013", "2016", "2019", "SubscriptionEdition" ] } }, "required": [ "authType", "version" ] } }, "required": [ "siteUrls", "domain", "repositoryAdditionalProperties" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "event": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "page": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "file": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "link": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "attachment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "comment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } } }, "additionalProperties": { "type": "object", "properties": { "eventTitleFilterRegEx": { "type": "array", "items": { "type": "string" } }, "pageTitleFilterRegEx": { "type": "array", "items": { "type": "string" } }, "linkTitleFilterRegEx": { "type": "array", "items": { "type": "string" } }, "inclusionFilePath": { "type": "array", "items": { "type": "string" } }, "exclusionFilePath": { "type": "array", "items": { "type": "string" } }, "inclusionFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionFileNamePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionFileNamePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionOneNoteSectionNamePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionOneNoteSectionNamePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionOneNotePageNamePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionOneNotePageNamePatterns": { "type": "array", "items": { "type": "string" } }, "crawlFiles": { "type": "boolean" }, "crawlPages": { "type": "boolean" }, "crawlEvents": { "type": "boolean" }, "crawlComments": { "type": "boolean" }, "crawlLinks": { "type": "boolean" }, "crawlAttachments": { "type": "boolean" }, "crawlListData": { "type": "boolean" }, "crawlAcl": { "type": "boolean" }, "fieldForUserId": { "type": "string" }, "aclConfiguration": { "type": "string", "enum": [ "ACLWithLDAPEmailFmt", "ACLWithManualEmailFmt", "ACLWithUsernameFmt" ] }, "emailDomain": { "type": "string" }, "isCrawlLocalGroupMapping": { "type": "boolean" }, "isCrawlAdGroupMapping": { "type": "boolean" }, "proxyHost": { "type": "string" }, "proxyPort": { "type": "string" } }, "required": [ ] }, "type": { "type": "string", "pattern": "SHAREPOINTV2" }, "enableIdentityCrawler": { "type": "boolean" }, "syncMode": { "type": "string", "enum": [ "FULL_CRAWL", "FORCED_FULL_CRAWL", "CHANGE_LOG" ] }, "secretArn": { "type": "string", "minLength": 20, "maxLength": 2048 } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "enableIdentityCrawler", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## Skema templat Microsoft SQL Server Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Tentukan jenis sumber data sebagai`JDBC`, tipe database sebagai`sqlserver`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Skema Microsoft SQL Server JSON](#ms-sql-server-json). Tabel berikut menjelaskan parameter skema Micorosft SQL Server JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi konfigurasi yang diperlukan untuk menghubungkan sumber data Anda.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. Tentukan jenis sumber data dan ARN rahasia. | | dokumen | Daftar objek yang memetakan atribut atau nama bidang konten database Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. Gunakan untuk menyertakan atau mengecualikan konten tertentu dalam sumber data database Anda. | | PrimaryKey | Berikan kunci utama untuk tabel database. Detail ini mengidentifikasi tabel di dalam basis data Anda. | | Judul Kolom | Berikan nama kolom judul dokumen dalam tabel database Anda. | | BodyColumn | Berikan nama kolom judul dokumen dalam tabel database Anda. | | SqlQuery | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | TimestampColumn | Masukkan nama kolom yang berisi stempel waktu. Amazon Kendra menggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. | | TimestampFormat | Masukkan nama kolom yang berisi format cap waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. | | timezone | Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. | | changeDetectingColumns | Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendra akan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini | | allowedUsersColumns | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | allowedGroupsColumn | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | sumber URIColumn | Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. | | isSslEnabled | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | jenis | Jenis sumber data. Tentukan JDBC sebagai tipe sumber data Anda. | | SyncMode | Tentukan bagaimana Amazon Kendra seharusnya memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari rahasia Secrets Manager yang berisi nama pengguna dan kata sandi yang diperlukan untuk terhubung ke database Anda. Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "user name": "database user name",
    "password": "password"
}
| | versi | Versi template yang saat ini didukung. | ### Skema Microsoft SQL Server JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "dbType": { "type": "string", "enum": [ "mysql", "db2", "postgresql", "oracle", "sqlserver" ] }, "dbHost": { "type": "string" }, "dbPort": { "type": "string" }, "dbInstance": { "type": "string" } }, "required": [ "dbType", "dbHost", "dbPort", "dbInstance" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "document": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string" }, "dataSourceFieldName": { "type": "string" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } }, "required": [ ] }, "additionalProperties": { "type": "object", "properties": { "primaryKey": { "type": "string" }, "titleColumn": { "type": "string" }, "bodyColumn": { "type": "string" }, "sqlQuery": { "type": "string", "not": { "pattern": ";+" } }, "timestampColumn": { "type": "string" }, "timestampFormat": { "type": "string" }, "timezone": { "type": "string" }, "changeDetectingColumns": { "type": "array", "items": { "type": "string" } }, "allowedUsersColumn": { "type": "string" }, "allowedGroupsColumn": { "type": "string" }, "sourceURIColumn": { "type": "string" }, "isSslEnabled": { "type": "boolean" } }, "required": ["primaryKey", "titleColumn", "bodyColumn", "sqlQuery"] }, "type" : { "type" : "string", "pattern": "JDBC" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "secretArn": { "type": "string" } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## Skema templat Microsoft Teams Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda memberikan ID penyewa sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Juga tentukan jenis sumber data sebagai`MSTEAMS`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Microsoft Teams JSON skema](#msteams-json). Tabel berikut menjelaskan parameter skema Microsoft Teams JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. | | TenanID | ID penyewa Microsoft 365. Anda dapat menemukan ID penyewa Anda di Properti Portal Direktori Aktif Azure Anda atau di aplikasi Anda OAuth . | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar objek yang memetakan atribut atau nama bidang konten Microsoft Teams Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. | | PembayaranModel | Menentukan jenis model pembayaran yang akan digunakan dengan sumber data Microsoft Teams Anda. Model pembayaran Model A dibatasi untuk lisensi dan model pembayaran yang memerlukan kepatuhan keamanan. Model pembayaran Model B cocok untuk lisensi dan model pembayaran yang tidak memerlukan kepatuhan keamanan. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk menyertakan konten tertentu di sumber data Microsoft Teams Anda. Konten yang cocok dengan pola disertakan dalam indeks. Konten yang tidak cocok dengan pola dikecualikan dari indeks. Jika konten cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan konten tidak disertakan dalam indeks. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk mengecualikan konten tertentu di sumber data Microsoft Teams Anda. Konten yang cocok dengan pola dikecualikan dari indeks. Konten yang tidak cocok dengan pola disertakan dalam indeks. Jika konten cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan konten tidak disertakan dalam indeks. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | trueuntuk merayapi jenis konten ini di sumber data Microsoft Teams Anda. | | startCalendarDateWaktu | Anda dapat mengonfigurasi tanggal-waktu mulai tertentu untuk konten kalender Anda. | | endCalendarDateWaktu | Anda dapat mengonfigurasi tanggal-waktu akhir tertentu untuk konten kalender. | | jenis | Jenis sumber data. Tentukan MSTEAMS sebagai tipe sumber data Anda. | | enableIdentityCrawler | trueuntuk menggunakan Amazon Kendra crawler identitas untuk menyinkronkan identity/principal informasi pada pengguna dan grup dengan akses ke dokumen tertentu. Jika perayap identitas dimatikan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup. | | SyncMode | Tentukan bagaimana Amazon Kendra seharusnya memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang berisi pasangan kunci-nilai yang diperlukan untuk terhubung ke Tim Microsoft Anda. Ini termasuk ID klien dan rahasia klien Anda yang dihasilkan saat Anda membuat OAuth aplikasi di portal Azure. | | versi | Versi template ini yang saat ini didukung. | ### Microsoft Teams JSON skema ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "tenantId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "minLength": 36, "maxLength": 36 } }, "required": [ "tenantId" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "chatMessage": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "chatAttachment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "channelPost": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "channelWiki": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "channelAttachment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "meetingChat": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "meetingFile": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "meetingNote": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "calendarMeeting": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } } }, "additionalProperties": { "type": "object", "properties": { "paymentModel": { "type": "string", "enum": [ "A", "B", "Evaluation Mode" ] }, "inclusionTeamNameFilter": { "type": "array", "items": { "type": "string" } }, "exclusionTeamNameFilter": { "type": "array", "items": { "type": "string" } }, "inclusionChannelNameFilter": { "type": "array", "items": { "type": "string" } }, "exclusionChannelNameFilter": { "type": "array", "items": { "type": "string" } }, "inclusionFileNamePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionFileNamePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionUserEmailFilter": { "type": "array", "items": { "type": "string" } }, "inclusionOneNoteSectionNamePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionOneNoteSectionNamePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionOneNotePageNamePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionOneNotePageNamePatterns": { "type": "array", "items": { "type": "string" } }, "isCrawlChatMessage": { "type": "boolean" }, "isCrawlChatAttachment": { "type": "boolean" }, "isCrawlChannelPost": { "type": "boolean" }, "isCrawlChannelAttachment": { "type": "boolean" }, "isCrawlChannelWiki": { "type": "boolean" }, "isCrawlCalendarMeeting": { "type": "boolean" }, "isCrawlMeetingChat": { "type": "boolean" }, "isCrawlMeetingFile": { "type": "boolean" }, "isCrawlMeetingNote": { "type": "boolean" }, "startCalendarDateTime": { "anyOf": [ { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$" }, { "type": "string", "pattern": "" } ] }, "endCalendarDateTime": { "anyOf": [ { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$" }, { "type": "string", "pattern": "" } ] } }, "required": [] }, "type": { "type": "string", "pattern": "MSTEAMS" }, "enableIdentityCrawler": { "type": "boolean" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "secretArn": { "type": "string", "minLength": 20, "maxLength": 2048 } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## Skema templat Microsoft Yammer Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Tentukan jenis sumber data sebagai`YAMMER`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai **Tipe** saat Anda memanggil [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Tabel berikut menjelaskan parameter skema Microsoft Yammer JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. Sumber data ini tidak menentukan titik akhir direpositoryEndpointMetadata. Sebaliknya, informasi koneksi termasuk dalam AWS Secrets Manager rahasia yang Anda berikansecretArn. | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar objek yang memetakan atribut atau nama bidang konten Microsoft Yammer ke nama bidang indeks Amazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data | | Pola Inklusi | Daftar pola ekspresi reguler untuk menyertakan file tertentu di sumber data Microsoft Yammer Anda. File yang cocok dengan pola disertakan dalam indeks. File yang tidak cocok dengan pola dikecualikan dari indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan dan file tidak disertakan dalam indeks. | | Pola Pengecualian | Daftar pola ekspresi reguler untuk mengecualikan file tertentu di sumber data Microsoft Yammer Anda. File yang cocok dengan pola dikecualikan dari indeks. File yang tidak cocok dengan pola disertakan dalam indeks. Jika file cocok dengan pola pengecualian dan inklusi, pola pengecualian akan diutamakan dan file tidak disertakan dalam indeks. | | Sejak Date | Anda dapat memilih untuk mengonfigurasi sinceDate parameter sehingga konektor Microsoft Yammer merayapi konten berdasarkan spesifik. sinceDate | | communityNameFilter | Anda dapat memilih untuk mengindeks konten komunitas tertentu. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | trueuntuk merayapi pesan, lampiran pesan, dan pesan pribadi. | | jenis | Tentukan YAMMER sebagai tipe sumber data Anda. | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang berisi pasangan kunci-nilai yang diperlukan untuk terhubung ke Microsoft Yammer Anda. Ini termasuk nama pengguna dan kata sandi Microsoft Yammer Anda, serta ID klien dan rahasia klien yang dihasilkan saat Anda membuat OAuth aplikasi di portal Azure. | | useChangeLog | trueuntuk menggunakan log perubahan Microsoft Yammer untuk menentukan dokumen mana yang perlu diperbarui dalam indeks. | | SyncMode | Tentukan bagaimana Amazon Kendra seharusnya memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | enableIdentityCrawler | trueuntuk menggunakan Amazon Kendra crawler identitas untuk menyinkronkan identity/principal informasi pada pengguna dan grup dengan akses ke dokumen tertentu. Jika perayap identitas dimatikan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup. | ### Microsoft Yammer JSON skema ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { } } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "community": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] }, "user": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] }, "message": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] }, "attachment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] } } }, "additionalProperties": { "type": "object", "properties": { "inclusionPatterns": { "type": "array" }, "exclusionPatterns": { "type": "array" }, "sinceDate": { "type": "string", "pattern": "^(19|2[0-9])[0-9]{2}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T(0[0-9]|1[0-9]|2[0-3]):([0-5][0-9]):([0-5][0-9])((\\+|-)(0[0-9]|1[0-9]|2[0-3]):([0-5][0-9]))?$" }, "communityNameFilter": { "type": "array", "items": { "type": "string" } }, "isCrawlMessage": { "type": "boolean" }, "isCrawlAttachment": { "type": "boolean" }, "isCrawlPrivateMessage": { "type": "boolean" } }, "required": [ "sinceDate" ] }, "type": { "type": "string", "pattern": "YAMMER" }, "secretArn": { "type": "string", "minLength": 20, "maxLength": 2048 }, "useChangeLog": { "type": "string", "enum": [ "true", "false" ] }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "enableIdentityCrawler": { "type": "boolean" }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] } }, "required": [ "connectionConfiguration", "repositoryConfigurations", "additionalProperties", "type", "secretArn", "syncMode" ] } ``` ## Skema templat MySQL Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Tentukan jenis sumber data sebagai`JDBC`, tipe database sebagai`mysql`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [MySQL JSON skema](#mysql-json). Tabel berikut menjelaskan parameter skema MySQL JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi konfigurasi yang diperlukan untuk menghubungkan sumber data Anda.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. Tentukan jenis sumber data dan ARN rahasia. | | dokumen | Daftar objek yang memetakan atribut atau nama bidang konten database Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. Gunakan untuk menyertakan atau mengecualikan konten tertentu dalam sumber data database Anda. | | PrimaryKey | Berikan kunci utama untuk tabel database. Detail ini mengidentifikasi tabel di dalam basis data Anda. | | Judul Kolom | Berikan nama kolom judul dokumen dalam tabel database Anda. | | BodyColumn | Berikan nama kolom judul dokumen dalam tabel database Anda. | | SqlQuery | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | TimestampColumn | Masukkan nama kolom yang berisi stempel waktu. Amazon Kendra menggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. | | TimestampFormat | Masukkan nama kolom yang berisi format cap waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. | | timezone | Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. | | changeDetectingColumns | Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendra akan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini | | allowedUsersColumns | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | allowedGroupsColumn | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | sumber URIColumn | Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. | | isSslEnabled | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | jenis | Jenis sumber data. Tentukan JDBC sebagai tipe sumber data Anda. | | SyncMode | Tentukan bagaimana Amazon Kendra seharusnya memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari rahasia Secrets Manager yang berisi nama pengguna dan kata sandi yang diperlukan untuk terhubung ke database Anda. Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "user name": "database user name",
    "password": "password"
}
| | versi | Versi template yang saat ini didukung. | ### MySQL JSON skema ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "dbType": { "type": "string", "enum": [ "mysql", "db2", "postgresql", "oracle", "sqlserver" ] }, "dbHost": { "type": "string" }, "dbPort": { "type": "string" }, "dbInstance": { "type": "string" } }, "required": [ "dbType", "dbHost", "dbPort", "dbInstance" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "document": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string" }, "dataSourceFieldName": { "type": "string" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } }, "required": [ ] }, "additionalProperties": { "type": "object", "properties": { "primaryKey": { "type": "string" }, "titleColumn": { "type": "string" }, "bodyColumn": { "type": "string" }, "sqlQuery": { "type": "string", "not": { "pattern": ";+" } }, "timestampColumn": { "type": "string" }, "timestampFormat": { "type": "string" }, "timezone": { "type": "string" }, "changeDetectingColumns": { "type": "array", "items": { "type": "string" } }, "allowedUsersColumn": { "type": "string" }, "allowedGroupsColumn": { "type": "string" }, "sourceURIColumn": { "type": "string" }, "isSslEnabled": { "type": "boolean" } }, "required": ["primaryKey", "titleColumn", "bodyColumn", "sqlQuery"] }, "type" : { "type" : "string", "pattern": "JDBC" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "secretArn": { "type": "string" } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## Skema templat Oracle Database Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Tentukan jenis sumber data sebagai`JDBC`, tipe database sebagai`oracle`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Skema JSON Database Oracle](#oracle-database-json). Tabel berikut menjelaskan parameter skema Oracle Database JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi konfigurasi yang diperlukan untuk menghubungkan sumber data Anda.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. Tentukan jenis sumber data dan ARN rahasia. | | dokumen | Daftar objek yang memetakan atribut atau nama bidang konten database Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. Gunakan untuk menyertakan atau mengecualikan konten tertentu dalam sumber data database Anda. | | PrimaryKey | Berikan kunci utama untuk tabel database. Detail ini mengidentifikasi tabel di dalam basis data Anda. | | Judul Kolom | Berikan nama kolom judul dokumen dalam tabel database Anda. | | BodyColumn | Berikan nama kolom judul dokumen dalam tabel database Anda. | | SqlQuery | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | TimestampColumn | Masukkan nama kolom yang berisi stempel waktu. Amazon Kendra menggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. | | TimestampFormat | Masukkan nama kolom yang berisi format cap waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. | | timezone | Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. | | changeDetectingColumns | Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendra akan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini | | allowedUsersColumns | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | allowedGroupsColumn | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | sumber URIColumn | Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. | | isSslEnabled | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | jenis | Jenis sumber data. Tentukan JDBC sebagai tipe sumber data Anda. | | SyncMode | Tentukan bagaimana Amazon Kendra seharusnya memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari rahasia Secrets Manager yang berisi nama pengguna dan kata sandi yang diperlukan untuk terhubung ke database Anda. Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "user name": "database user name",
    "password": "password"
}
| | versi | Versi template yang saat ini didukung. | ### Skema JSON Database Oracle ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "dbType": { "type": "string", "enum": [ "mysql", "db2", "postgresql", "oracle", "sqlserver" ] }, "dbHost": { "type": "string" }, "dbPort": { "type": "string" }, "dbInstance": { "type": "string" } }, "required": [ "dbType", "dbHost", "dbPort", "dbInstance" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "document": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string" }, "dataSourceFieldName": { "type": "string" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } }, "required": [ ] }, "additionalProperties": { "type": "object", "properties": { "primaryKey": { "type": "string" }, "titleColumn": { "type": "string" }, "bodyColumn": { "type": "string" }, "sqlQuery": { "type": "string", "not": { "pattern": ";+" } }, "timestampColumn": { "type": "string" }, "timestampFormat": { "type": "string" }, "timezone": { "type": "string" }, "changeDetectingColumns": { "type": "array", "items": { "type": "string" } }, "allowedUsersColumn": { "type": "string" }, "allowedGroupsColumn": { "type": "string" }, "sourceURIColumn": { "type": "string" }, "isSslEnabled": { "type": "boolean" } }, "required": ["primaryKey", "titleColumn", "bodyColumn", "sqlQuery"] }, "type" : { "type" : "string", "pattern": "JDBC" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "secretArn": { "type": "string" } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## Skema Templat PostgreSQL Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Tentukan jenis sumber data sebagai`JDBC`, tipe database sebagai`postgresql`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [PostgreSQL JSON skema](#postgresql-json). Tabel berikut menjelaskan parameter skema PostgreSQL JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi konfigurasi yang diperlukan untuk menghubungkan sumber data Anda.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. Tentukan jenis sumber data dan ARN rahasia. | | dokumen | Daftar objek yang memetakan atribut atau nama bidang konten database Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. Gunakan untuk menyertakan atau mengecualikan konten tertentu dalam sumber data database Anda. | | PrimaryKey | Berikan kunci utama untuk tabel database. Detail ini mengidentifikasi tabel di dalam basis data Anda. | | Judul Kolom | Berikan nama kolom judul dokumen dalam tabel database Anda. | | BodyColumn | Berikan nama kolom judul dokumen dalam tabel database Anda. | | SqlQuery | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | TimestampColumn | Masukkan nama kolom yang berisi stempel waktu. Amazon Kendra menggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. | | TimestampFormat | Masukkan nama kolom yang berisi format cap waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. | | timezone | Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. | | changeDetectingColumns | Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendra akan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini | | allowedUsersColumns | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | allowedGroupsColumn | Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. | | sumber URIColumn | Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. | | isSslEnabled | Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten database yang cocok dengan kueri Anda. | | jenis | Jenis sumber data. Tentukan JDBC sebagai tipe sumber data Anda. | | SyncMode | Tentukan bagaimana Amazon Kendra seharusnya memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari rahasia Secrets Manager yang berisi nama pengguna dan kata sandi yang diperlukan untuk terhubung ke database Anda. Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "user name": "database user name",
    "password": "password"
}
| | versi | Versi template yang saat ini didukung. | ### PostgreSQL JSON skema ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "dbType": { "type": "string", "enum": [ "mysql", "db2", "postgresql", "oracle", "sqlserver" ] }, "dbHost": { "type": "string" }, "dbPort": { "type": "string" }, "dbInstance": { "type": "string" } }, "required": [ "dbType", "dbHost", "dbPort", "dbInstance" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "document": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string" }, "dataSourceFieldName": { "type": "string" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } }, "required": [ ] }, "additionalProperties": { "type": "object", "properties": { "primaryKey": { "type": "string" }, "titleColumn": { "type": "string" }, "bodyColumn": { "type": "string" }, "sqlQuery": { "type": "string", "not": { "pattern": ";+" } }, "timestampColumn": { "type": "string" }, "timestampFormat": { "type": "string" }, "timezone": { "type": "string" }, "changeDetectingColumns": { "type": "array", "items": { "type": "string" } }, "allowedUsersColumn": { "type": "string" }, "allowedGroupsColumn": { "type": "string" }, "sourceURIColumn": { "type": "string" }, "isSslEnabled": { "type": "boolean" } }, "required": ["primaryKey", "titleColumn", "bodyColumn", "sqlQuery"] }, "type" : { "type" : "string", "pattern": "JDBC" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "secretArn": { "type": "string" } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## Skema templat Salesforce Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda memberikan URL host Salesforce sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Juga tentukan jenis sumber data sebagai`SALESFORCEV2`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Skema JSON Salesforce](#salesforce-json). Tabel berikut menjelaskan parameter skema JSON Salesforce. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. | | HostURL | URL instance Salesforce yang akan diindeks. | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar objek yang memetakan atribut atau nama bidang entitas Salesforce Anda untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang berisi pasangan kunci-nilai yang diperlukan untuk terhubung ke Salesforce Anda. Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "authenticationUrl": "OAUTH endpoint that Amazon Kendra connects to get an OAUTH token",
    "consumerKey": "Application public key generated when you created your Salesforce application",
    "consumerSecret": "Application private key generated when you created your Salesforce application",
    "password": "Password associated with the user logging in to the Salesforce instance",
    "securityToken": "Token associated with the user account logging in to the Salesforce instance",
    "username": "User name of the user logging in to the Salesforce instance"
}
| | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Kumpulan string yang menentukan entitas mana yang akan difilter. | | Pola Inklusi [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk menyertakan file tertentu dalam sumber data Salesforce Anda. File yang cocok dengan pola disertakan dalam indeks. File yang tidak cocok dengan pola dikecualikan dari indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan dan file tidak disertakan dalam indeks. | | Pola Pengecualian [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk mengecualikan file tertentu di sumber data Salesforce Anda. File yang cocok dengan pola dikecualikan dari indeks. File yang tidak cocok dengan pola disertakan dalam indeks. Jika file cocok dengan pola pengecualian dan inklusi, pola pengecualian akan diutamakan dan file tidak disertakan dalam indeks. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | trueuntuk merayapi jenis file ini di akun Salesforce Anda. | | jenis | Jenis sumber data. Tentukan SALESFORCEV2 sebagai tipe sumber data Anda. | | enableIdentityCrawler | trueuntuk menggunakan Amazon Kendra crawler identitas untuk menyinkronkan identity/principal informasi pada pengguna dan grup dengan akses ke dokumen tertentu. Jika perayap identitas dimatikan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup. | | SyncMode | Tentukan bagaimana Amazon Kendra seharusnya memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | versi | Versi template ini yang saat ini didukung. | ### Skema JSON Salesforce ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "hostUrl": { "type": "string", "pattern": "https:.*" } }, "required": [ "hostUrl" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "account": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "contact": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "campaign": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "case": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "product": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "lead": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "contract": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "partner": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "profile": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "idea": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "pricebook": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "task": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "solution": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "attachment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "user": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "document": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "knowledgeArticles": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "group": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "opportunity": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE", "LONG" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "chatter": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "customEntity": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "STRING_LIST", "DATE" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } } }, "additionalProperties": { "type": "object", "properties": { "accountFilter":{ "type": "array", "items": { "type": "string" } }, "contactFilter":{ "type": "array", "items": { "type": "string" } }, "caseFilter":{ "type": "array", "items": { "type": "string" } }, "campaignFilter":{ "type": "array", "items": { "type": "string" } }, "contractFilter":{ "type": "array", "items": { "type": "string" } }, "groupFilter":{ "type": "array", "items": { "type": "string" } }, "leadFilter":{ "type": "array", "items": { "type": "string" } }, "productFilter":{ "type": "array", "items": { "type": "string" } }, "opportunityFilter":{ "type": "array", "items": { "type": "string" } }, "partnerFilter":{ "type": "array", "items": { "type": "string" } }, "pricebookFilter":{ "type": "array", "items": { "type": "string" } }, "ideaFilter":{ "type": "array", "items": { "type": "string" } }, "profileFilter":{ "type": "array", "items": { "type": "string" } }, "taskFilter":{ "type": "array", "items": { "type": "string" } }, "solutionFilter":{ "type": "array", "items": { "type": "string" } }, "userFilter":{ "type": "array", "items": { "type": "string" } }, "chatterFilter":{ "type": "array", "items": { "type": "string" } }, "documentFilter":{ "type": "array", "items": { "type": "string" } }, "knowledgeArticleFilter":{ "type": "array", "items": { "type": "string" } }, "customEntities":{ "type": "array", "items": { "type": "string" } }, "isCrawlAccount": { "type": "boolean" }, "isCrawlContact": { "type": "boolean" }, "isCrawlCase": { "type": "boolean" }, "isCrawlCampaign": { "type": "boolean" }, "isCrawlProduct": { "type": "boolean" }, "isCrawlLead": { "type": "boolean" }, "isCrawlContract": { "type": "boolean" }, "isCrawlPartner": { "type": "boolean" }, "isCrawlProfile": { "type": "boolean" }, "isCrawlIdea": { "type": "boolean" }, "isCrawlPricebook": { "type": "boolean" }, "isCrawlDocument": { "type": "boolean" }, "crawlSharedDocument": { "type": "boolean" }, "isCrawlGroup": { "type": "boolean" }, "isCrawlOpportunity": { "type": "boolean" }, "isCrawlChatter": { "type": "boolean" }, "isCrawlUser": { "type": "boolean" }, "isCrawlSolution":{ "type": "boolean" }, "isCrawlTask":{ "type": "boolean" }, "isCrawlAccountAttachments": { "type": "boolean" }, "isCrawlContactAttachments": { "type": "boolean" }, "isCrawlCaseAttachments": { "type": "boolean" }, "isCrawlCampaignAttachments": { "type": "boolean" }, "isCrawlLeadAttachments": { "type": "boolean" }, "isCrawlContractAttachments": { "type": "boolean" }, "isCrawlGroupAttachments": { "type": "boolean" }, "isCrawlOpportunityAttachments": { "type": "boolean" }, "isCrawlChatterAttachments": { "type": "boolean" }, "isCrawlSolutionAttachments":{ "type": "boolean" }, "isCrawlTaskAttachments":{ "type": "boolean" }, "isCrawlCustomEntityAttachments":{ "type": "boolean" }, "isCrawlKnowledgeArticles": { "type": "object", "properties": { "isCrawlDraft": { "type": "boolean" }, "isCrawlPublish": { "type": "boolean" }, "isCrawlArchived": { "type": "boolean" } } }, "inclusionDocumentFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionDocumentFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionDocumentFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionDocumentFileNamePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionAccountFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionAccountFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionAccountFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionAccountFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionCampaignFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionCampaignFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionCampaignFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionCampaignFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionCaseFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionCaseFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionCaseFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionCaseFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionContactFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionContactFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionContactFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionContactFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionContractFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionContractFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionContractFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionContractFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionLeadFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionLeadFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionLeadFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionLeadFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionOpportunityFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionOpportunityFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionOpportunityFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionOpportunityFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionSolutionFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionSolutionFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionSolutionFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionSolutionFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionTaskFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionTaskFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionTaskFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionTaskFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionGroupFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionGroupFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionGroupFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionGroupFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionChatterFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionChatterFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionChatterFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionChatterFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionCustomEntityFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionCustomEntityFileTypePatterns":{ "type": "array", "items": { "type": "string" } }, "inclusionCustomEntityFileNamePatterns":{ "type": "array", "items": { "type": "string" } }, "exclusionCustomEntityFileNamePatterns":{ "type": "array", "items": { "type": "string" } } }, "required": [] }, "enableIdentityCrawler": { "type": "boolean" }, "type": { "type": "string", "pattern": "SALESFORCEV2" }, "syncMode": { "type": "string", "enum": [ "FULL_CRAWL", "FORCED_FULL_CRAWL", "CHANGE_LOG" ] }, "secretArn": { "type": "string", "minLength": 20, "maxLength": 2048 } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## ServiceNow skema templat Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda memberikan URL ServiceNow host, jenis otentikasi, dan versi instans sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Juga tentukan jenis sumber data sebagai`SERVICENOWV2`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [ServiceNow Skema JSON](#servicenow-json). Tabel berikut menjelaskan parameter skema ServiceNow JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. | | HostURL | URL ServiceNow host. Misalnya, your-domain.service-now.com. | | authType | Jenis otentikasi yang Anda gunakan, apakah basicAuth atauOAuth2. | | servicenowInstanceVersion | ServiceNow Versi yang Anda gunakan. Anda dapat memilih antaraTokyo,Sandiego,Rome, danOthers. | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar objek yang memetakan atribut atau nama bidang artikel ServiceNow pengetahuan Anda, lampiran, katalog layanan, dan insiden untuk Amazon Kendra mengindeks nama bidang. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). Nama bidang sumber ServiceNow data harus ada di metadata ServiceNow kustom Anda. | | properti tambahan | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. | | maxFileSizeInMegaBytes | Tentukan batas ukuran file di Amazon Kendra MBs yang akan dirayapi. Amazon Kendra hanya akan merayapi file dalam batas ukuran yang Anda tentukan. Ukuran file default adalah 50MB. Ukuran file maksimum harus lebih besar dari 0MB dan kurang dari atau sama dengan 50MB. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar pola ekspresi reguler untuk menyertakan and/or mengecualikan file tertentu dalam sumber ServiceNow data Anda. File yang cocok dengan pola disertakan dalam indeks. File yang tidak cocok dengan pola dikecualikan dari indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan dan file tidak disertakan dalam indeks. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | trueuntuk merayapi artikel ServiceNow pengetahuan, katalog layanan, insiden, dan lampiran. | | jenis | Jenis sumber data. Tentukan SERVICENOWV2 sebagai tipe sumber data Anda. | | enableIdentityCrawler | trueuntuk menggunakan Amazon Kendra crawler identitas untuk menyinkronkan identity/principal informasi pada pengguna dan grup dengan akses ke dokumen tertentu. Jika perayap identitas dimatikan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup. | | SyncMode | Tentukan bagaimana Amazon Kendra seharusnya memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang berisi pasangan kunci-nilai yang diperlukan untuk terhubung ke Anda. ServiceNow Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "username": "user name",
    "password": "password"
}
Jika Anda menggunakan OAuth2 otentikasi, rahasia Anda harus berisi struktur JSON dengan kunci berikut: 
{
    "username": "user name",
    "password": "password",
    "clientId": "client id",
    "clientSecret": "client secret"         
}
| | versi | Versi template yang saat ini didukung. | ### ServiceNow Skema JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "hostUrl": { "type": "string", "pattern": "^(?!(^(https?|ftp|file):\/\/))[a-z0-9-]+(.service-now.com|.servicenowservices.com)$", "minLength": 1, "maxLength": 2048 }, "authType": { "type": "string", "enum": [ "basicAuth", "OAuth2" ] }, "servicenowInstanceVersion": { "type": "string", "enum": [ "Tokyo", "Sandiego", "Rome", "Others" ] } }, "required": [ "hostUrl", "authType", "servicenowInstanceVersion" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "knowledgeArticle": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE", "STRING_LIST" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "attachment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "LONG", "DATE", "STRING_LIST" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "serviceCatalog": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE", "STRING_LIST" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] }, "incident": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": [ "STRING", "DATE", "STRING_LIST" ] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } } }, "additionalProperties": { "type": "object", "properties": { "maxFileSizeInMegaBytes": { "type": "string" }, "isCrawlKnowledgeArticle": { "type": "boolean" }, "isCrawlKnowledgeArticleAttachment": { "type": "boolean" }, "includePublicArticlesOnly": { "type": "boolean" }, "knowledgeArticleFilter": { "type": "string" }, "incidentQueryFilter": { "type": "string" }, "serviceCatalogQueryFilter": { "type": "string" }, "isCrawlServiceCatalog": { "type": "boolean" }, "isCrawlServiceCatalogAttachment": { "type": "boolean" }, "isCrawlActiveServiceCatalog": { "type": "boolean" }, "isCrawlInactiveServiceCatalog": { "type": "boolean" }, "isCrawlIncident": { "type": "boolean" }, "isCrawlIncidentAttachment": { "type": "boolean" }, "isCrawlActiveIncident": { "type": "boolean" }, "isCrawlInactiveIncident": { "type": "boolean" }, "applyACLForKnowledgeArticle": { "type": "boolean" }, "applyACLForServiceCatalog": { "type": "boolean" }, "applyACLForIncident": { "type": "boolean" }, "incidentStateType": { "type": "array", "items": { "type": "string", "enum": [ "Open", "Open - Unassigned", "Resolved", "All" ] } }, "knowledgeArticleTitleRegExp": { "type": "string" }, "serviceCatalogTitleRegExp": { "type": "string" }, "incidentTitleRegExp": { "type": "string" }, "inclusionFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionFileTypePatterns": { "type": "array", "items": { "type": "string" } }, "inclusionFileNamePatterns": { "type": "array", "items": { "type": "string" } }, "exclusionFileNamePatterns": { "type": "array", "items": { "type": "string" } } }, "required": [] }, "type": { "type": "string", "pattern": "SERVICENOWV2" }, "enableIdentityCrawler": { "type": "boolean" }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL" ] }, "secretArn": { "type": "string", "minLength": 20, "maxLength": 2048 } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type" ] } ``` ## Skema template kendur Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda memberikan URL host sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Juga tentukan jenis sumber data sebagai`SLACK`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Slack JSON skema](#slack-json). Tabel berikut menjelaskan parameter skema Slack JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. | | TeamID | ID tim Slack yang Anda salin dari URL halaman utama Slack Anda. | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | Semua | Daftar objek yang memetakan atribut atau nama bidang Slack konten Anda untuk Amazon Kendra mengindeks nama bidang. | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data Anda. | | Pola Inklusi | Daftar pola ekspresi reguler untuk menyertakan konten tertentu dalam sumber Slack data Anda. Konten yang cocok dengan pola disertakan dalam indeks. Konten yang tidak cocok dengan pola dikecualikan dari indeks. Jika ada konten yang cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan konten tidak disertakan dalam indeks. | | Pola Pengecualian | Daftar pola ekspresi reguler untuk mengecualikan konten tertentu di sumber Slack data Anda. Konten yang cocok dengan pola dikecualikan dari indeks. Konten yang tidak cocok dengan pola disertakan dalam indeks. Jika ada konten yang cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan konten tidak disertakan dalam indeks. | | crawlBotMessages | trueuntuk merayapi pesan bot. | | dikecualikanDiarsipkan | trueuntuk mengecualikan perayapan pesan yang diarsipkan. | | ConversationType | Jenis percakapan yang ingin Anda indeks apakahPUBLIC\$1CHANNEL,PRIVATE\$1CHANNEL, GROUP\$1MESSAGE danDIRECT\$1MESSAGE. | | Filter Saluran | Jenis saluran yang ingin Anda indeks apakah private\$1channel ataupublic\$1channel. | | Sejak Date | Anda dapat memilih untuk mengonfigurasi sinceDate parameter sehingga Slack konektor merayapi konten berdasarkan spesifiksinceDate. | | Lookback | Anda dapat memilih untuk mengonfigurasi lookBack parameter sehingga Slack konektor merayapi konten yang diperbarui atau dihapus hingga jumlah jam tertentu sebelum sinkronisasi konektor terakhir Anda. | | SyncMode | Tentukan bagaimana Amazon Kendra seharusnya memperbarui indeks Anda saat konten sumber data Anda berubah. Anda dapat memilih antara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | | jenis | Jenis sumber data. Tentukan SLACK sebagai tipe sumber data Anda. | | enableIdentityCrawler | trueuntuk menggunakan Amazon Kendra crawler identitas untuk menyinkronkan identity/principal informasi pada pengguna dan grup dengan akses ke dokumen tertentu. Jika perayap identitas dimatikan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup. | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang berisi pasangan kunci-nilai yang diperlukan untuk terhubung ke Anda. Slack Rahasianya harus berisi struktur JSON dengan kunci berikut: 
{
    "slackToken": "token"
}
| | versi | Versi template ini yang saat ini didukung. | ### Slack JSON skema ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "teamId": { "type": "string" } }, "required": ["teamId"] } } }, "repositoryConfigurations": { "type": "object", "properties": { "All": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": ["STRING", "STRING_LIST", "DATE","LONG"] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } }, "required": [ "fieldMappings" ] } }, "required": [ ] }, "additionalProperties": { "type": "object", "properties": { "exclusionPatterns": { "type": "array", "items": { "type": "string" } }, "inclusionPatterns": { "type": "array", "items": { "type": "string" } }, "crawlBotMessages": { "type": "boolean" }, "excludeArchived": { "type": "boolean" }, "conversationType": { "type": "array", "items": { "type": "string", "enum": [ "PUBLIC_CHANNEL", "PRIVATE_CHANNEL", "GROUP_MESSAGE", "DIRECT_MESSAGE" ] } }, "channelFilter": { "type": "object", "properties": { "private_channel": { "type": "array", "items": { "type": "string" } }, "public_channel": { "type": "array", "items": { "type": "string" } } } }, "channelIdFilter": { "type": "array", "items": { "type": "string" } }, "sinceDate": { "anyOf": [ { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$" }, { "type": "string", "pattern": "" } ] }, "lookBack": { "type": "string", "pattern": "^[0-9]*$" } }, "required": [ ] }, "syncMode": { "type": "string", "enum": [ "FORCED_FULL_CRAWL", "FULL_CRAWL", "CHANGE_LOG" ] }, "type" : { "type" : "string", "pattern": "SLACK" }, "enableIdentityCrawler": { "type": "boolean" }, "secretArn": { "type": "string" } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "required": [ "connectionConfiguration", "repositoryConfigurations", "syncMode", "additionalProperties", "secretArn", "type", "enableIdentityCrawler" ] } ``` ## Skema template Zendesk Anda menyertakan JSON yang berisi skema sumber data sebagai bagian dari objek. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda memberikan URL host sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Juga tentukan jenis sumber data sebagai`ZENDESK`, rahasia untuk kredensyal otentikasi Anda, dan konfigurasi lain yang diperlukan. Anda kemudian menentukan `TEMPLATE` sebagai `Type` saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Anda dapat menggunakan template yang disediakan dalam panduan pengembang ini. Lihat [Skema Zendesk JSON](#zendesk-json). Tabel berikut menjelaskan parameter skema Zendesk JSON. | Konfigurasi | Deskripsi | | --- | --- | | ConnectionConfiguration | Informasi konfigurasi untuk titik akhir untuk sumber data. | | repositoryEndpointMetadata | Informasi titik akhir untuk sumber data. | | HostURL | URL host Zendesk. Misalnya, https://yoursubdomain.zendesk.com. | | RepositoryConfigurations | Informasi konfigurasi untuk konten sumber data. Misalnya, mengonfigurasi jenis konten dan pemetaan bidang tertentu. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Daftar objek yang memetakan atribut atau nama bidang tiket Zendesk ke nama bidang indeks Amazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). | | Sekretarn | Nama Sumber Daya Amazon (ARN) dari AWS Secrets Manager rahasia yang berisi pasangan kunci-nilai yang diperlukan untuk terhubung ke Zendesk Anda. Rahasia harus berisi struktur JSON dengan kunci berikut: URL host, ID klien, rahasia klien, nama pengguna, dan kata sandi. | | AdditionalProperties | Opsi konfigurasi tambahan untuk konten Anda di sumber data | | organizationNameFilter | Anda dapat memilih untuk mengindeks tiket yang ada dalam Organisasi tertentu. | | Sejak Date | Anda dapat memilih untuk mengonfigurasi sinceDate parameter sehingga konektor Zendesk merayapi konten berdasarkan spesifik. sinceDate | | Pola Inklusi | Daftar pola ekspresi reguler untuk menyertakan file tertentu dalam sumber data Zendesk Anda. File yang cocok dengan pola disertakan dalam indeks. File yang tidak cocok dengan pola dikecualikan dari indeks. Jika file cocok dengan pola inklusi dan pengecualian, pola pengecualian akan diutamakan, dan file tersebut tidak disertakan dalam indeks. | | Pola Pengecualian | Daftar pola ekspresi reguler untuk mengecualikan file tertentu di sumber data Zendesk Anda. File yang cocok dengan pola dikecualikan dari indeks. File yang tidak cocok dengan pola disertakan dalam indeks. Jika file cocok dengan pola pengecualian dan inklusi, pola pengecualian akan diutamakan, dan file tersebut tidak disertakan dalam indeks. | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/ds-schemas.html) | Masukkan "true" untuk merayapi jenis konten ini. | | jenis | Tentukan ZENDESK sebagai tipe sumber data Anda. | | useChangeLog | Masukkan "true" untuk menggunakan log perubahan Zendesk untuk menentukan dokumen mana yang perlu diperbarui dalam indeks. Tergantung pada ukuran log perubahan, mungkin lebih cepat untuk memindai dokumen di Zendesk. Jika Anda menyinkronkan sumber data Zendesk Anda dengan indeks Anda untuk pertama kalinya, semua dokumen dipindai. | ### Skema Zendesk JSON ``` { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "hostUrl": { "type": "string", "pattern": "https:.*" } }, "required": [ "hostUrl" ] } }, "required": [ "repositoryEndpointMetadata" ] }, "repositoryConfigurations": { "type": "object", "properties": { "ticket": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": ["STRING", "STRING_LIST", "LONG", "DATE"] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "dd-MM-yyyy HH:mm:ss" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] }, "ticketComment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": ["STRING", "STRING_LIST", "LONG", "DATE"] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "dd-MM-yyyy HH:mm:ss" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] }, "ticketCommentAttachment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": ["STRING", "STRING_LIST", "LONG", "DATE"] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "dd-MM-yyyy HH:mm:ss" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] }, "article": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": ["STRING", "STRING_LIST", "LONG", "DATE"] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "dd-MM-yyyy HH:mm:ss" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] }, "communityPostComment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": ["STRING", "STRING_LIST", "LONG", "DATE"] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "dd-MM-yyyy HH:mm:ss" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] }, "articleComment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": ["STRING", "STRING_LIST", "LONG", "DATE"] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "dd-MM-yyyy HH:mm:ss" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] }, "articleAttachment": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": ["STRING", "STRING_LIST", "LONG", "DATE"] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "dd-MM-yyyy HH:mm:ss" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] }, "communityTopic": { "type": "object", "properties": { "fieldMappings": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "indexFieldName": { "type": "string" }, "indexFieldType": { "type": "string", "enum": ["STRING", "STRING_LIST", "LONG", "DATE"] }, "dataSourceFieldName": { "type": "string" }, "dateFieldFormat": { "type": "string", "pattern": "dd-MM-yyyy HH:mm:ss" } }, "required": [ "indexFieldName", "indexFieldType", "dataSourceFieldName" ] } ] } } }, "required": [ "fieldMappings" ] } } }, "secretArn": { "type": "string", "minLength": 20, "maxLength": 2048 }, "additionalProperties": { "type": "object", "properties": { "organizationNameFilter": { "type": "array" }, "sinceDate": { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}:[0-9]{2}$" }, "inclusionPatterns": { "type": "array" }, "exclusionPatterns": { "type": "array" }, "isCrawTicket": { "type": "string" }, "isCrawTicketComment": { "type": "string" }, "isCrawTicketCommentAttachment": { "type": "string" }, "isCrawlArticle": { "type": "string" }, "isCrawlArticleAttachment": { "type": "string" }, "isCrawlArticleComment": { "type": "string" }, "isCrawlCommunityTopic": { "type": "string" }, "isCrawlCommunityPost": { "type": "string" }, "isCrawlCommunityPostComment": { "type": "string" } } }, "type": { "type": "string", "pattern": "ZENDESK" }, "useChangeLog": { "type": "string", "enum": ["true", "false"] } }, "version": { "type": "string", "anyOf": [ { "pattern": "1.0.0" } ] }, "additionalProperties": false, "required": [ "connectionConfiguration", "repositoryConfigurations", "additionalProperties", "useChangeLog", "secretArn", "type" ] } ``` # Adobe Experience Manager **catatan** Konektor Adobe Experience Manager tetap didukung penuh untuk pelanggan lama hingga 31 Mei 2026. Meskipun konektor ini tidak lagi tersedia untuk pengguna baru, pengguna saat ini dapat terus menggunakannya tanpa gangguan. Kami terus mengembangkan portofolio konektor kami untuk menawarkan solusi yang lebih terukur dan dapat disesuaikan. Untuk integrasi masa depan, sebaiknya jelajahi Amazon Kendra Custom Connector Framework [1], yang dirancang untuk mendukung rangkaian kasus penggunaan perusahaan yang lebih luas dengan fleksibilitas yang ditingkatkan. Adobe Experience Manageradalah sistem manajemen konten yang digunakan untuk membuat konten situs web atau aplikasi seluler. Anda dapat menggunakan Amazon Kendra untuk menghubungkan Adobe Experience Manager dan mengindeks halaman dan aset konten Anda. Amazon Kendramendukung Adobe Experience Manager (AEM) sebagai instance penulis Layanan Cloud dan penulis Adobe Experience Manager On-Premise dan menerbitkan instance. Anda dapat terhubung Amazon Kendra ke sumber Adobe Experience Manager data menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) atau [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber data Amazon Kendra Adobe Experience Manager, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-aem) + [Prasyarat](#prerequisites-aem) + [Instruksi koneksi](#data-source-procedure-aem) ## Fitur yang didukung Adobe Experience Managerkonektor sumber data mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + OAuth 2.0 dan otentikasi dasar + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber Adobe Experience Manager data Anda, buat perubahan ini di akun Adobe Experience Manager dan AWS akun Anda. **DiAdobe Experience Manager, pastikan Anda memiliki**: + Akses ke akun dengan hak administratif, atau pengguna admin. + Menyalin URL Adobe Experience Manager host Anda. **catatan** (On-premise/server) Amazon Kendra memeriksa apakah informasi titik akhir yang disertakan sama dengan informasi titik akhir yang AWS Secrets Manager ditentukan dalam detail konfigurasi sumber data Anda. Ini membantu melindungi dari [masalah wakil yang membingungkan](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html), yang merupakan masalah keamanan di mana pengguna tidak memiliki izin untuk melakukan tindakan tetapi menggunakan Amazon Kendra sebagai proxy untuk mengakses rahasia yang dikonfigurasi dan melakukan tindakan. Jika nanti Anda mengubah informasi titik akhir Anda, Anda harus membuat rahasia baru untuk menyinkronkan informasi ini. + Mencatat kredensi otentikasi dasar Anda dari nama pengguna dan kata sandi admin. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **Opsional**: Kredensi OAuth 2.0 yang dikonfigurasi di Adobe Experience Manager (AEM) sebagai Layanan Cloud atau AEM On-Premise. Jika Anda menggunakan AEM On-Premise, kredensialnya mencakup ID klien, rahasia klien, dan kunci pribadi. Jika Anda menggunakan AEM sebagai Layanan Cloud, kredensialnya mencakup ID klien, rahasia klien, kunci pribadi, ID organisasi, ID akun teknis, dan host Adobe Identity Management System (IMS). [Untuk informasi selengkapnya tentang cara membuat kredensil ini untuk AEM sebagai Layanan Cloud, lihat dokumentasi. Adobe Experience Manager](https://experienceleague.adobe.com/docs/experience-manager-learn/getting-started-with-aem-headless/authentication/service-credentials.html) Untuk AEM On-Premise, implementasi server Adobe Granite OAuth 2.0 (com.adobe.granite.oauth.server) menyediakan dukungan untuk fungsionalitas server OAuth 2.0 di AEM. + Memeriksa setiap dokumen unik di Adobe Experience Manager dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi Adobe Experience Manager Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasianya. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data Adobe Experience ManagerAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber Adobe Experience Manager data Anda, Anda harus memberikan rincian yang diperlukan dari sumber Adobe Experience Manager data Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Adobe Experience Manager untukAmazon Kendra, lihat[Prasyarat](#prerequisites-aem). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Adobe Experience Manager** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambah sumber data**, pilih **konektor Adobe Experience Manager**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Adobe Experience Manager** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **Sumber** —Pilih **AEM On-Premise** atau **AEM** sebagai Layanan Cloud. Masukkan URL Adobe Experience Manager host Anda. Misalnya, jika Anda menggunakan AEM On-Premise, Anda menyertakan nama host dan port: *https://hostname:port*. Atau, jika Anda menggunakan AEM as a Layanan Cloud, Anda dapat menggunakan URL penulis: *https://author-xxxxxx-xxxxxxx.adobeaemcloud.com*. 1. **Lokasi sertifikat SSL** —Masukkan jalur ke sertifikat SSL yang disimpan dalam bucket. Amazon S3 Anda menggunakan ini untuk terhubung ke AEM On-Premise dengan koneksi SSL yang aman. 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. **Otentikasi** **—Pilih otentikasi **dasar atau OAuth otentikasi 2.0**.** Kemudian pilih AWS Secrets Manager rahasia yang ada atau buat rahasia baru untuk menyimpan Adobe Experience Manager kredensil Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. Jika Anda memilih **otentikasi dasar**, masukkan nama untuk rahasia, nama pengguna Adobe Experience Manager situs dan kata sandi. Pengguna harus memiliki izin admin atau menjadi pengguna admin. Jika Anda memilih **otentikasi OAuth 2.0** dan Anda menggunakan AEM On-Premise, masukkan nama untuk rahasia, ID klien, rahasia klien, dan kunci pribadi. Jika Anda menggunakan AEM sebagai Layanan Cloud, masukkan nama untuk rahasia, ID klien, rahasia klien, kunci pribadi, ID organisasi, ID akun teknis, dan host Adobe Identity Management System (IMS). Simpan menambahkan rahasia Anda. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Sinkronisasi cakupan** —Tetapkan batas untuk merayapi jenis konten tertentu, komponen halaman, dan jalur akar, dan filter konten menggunakan pola ekspresi regex. 1. **Jenis konten** —Pilih apakah hanya akan merayapi halaman atau aset, atau keduanya. 1. (Opsional) **Konfigurasi tambahan —Konfigurasikan** pengaturan berikut: + **Komponen halaman** —Nama spesifik komponen halaman. Komponen Halaman adalah komponen halaman yang dapat diperluas yang dirancang untuk bekerja dengan editor Adobe Experience Manager template dan memungkinkan komponen halaman header/footer dan struktur dirakit dengan editor template. + Variasi **fragmen konten —Nama spesifik variasi** fragmen konten. Fragmen Konten memungkinkan Anda mendesain, membuat, mengkurasi, dan mempublikasikan konten yang tidak bergantung pada halaman. Adobe Experience Manager Mereka memungkinkan Anda menyiapkan konten yang siap digunakan di locations/over beberapa saluran. + **Jalur root —Jalur** root ke konten tertentu. + Pola **Regex —Pola** ekspresi reguler untuk menyertakan atau mengecualikan halaman dan aset tertentu. 1. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. **ID zona waktu** —Jika Anda menggunakan AEM On-Premise dan zona waktu server Anda berbeda dari zona waktu konektor atau indeks Amazon Kendra AEM, Anda dapat menentukan zona waktu server agar sejajar dengan konektor atau indeks AEM. Zona waktu default untuk AEM On-Premise adalah zona waktu konektor atau indeks Amazon Kendra AEM. Zona waktu default untuk AEM sebagai Layanan Cloud adalah Greenwich Mean Time. 1. **Sinkronkan jadwal berjalan**, untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda. Untuk menambahkan bidang sumber data kustom, buat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Adobe Experience Manager** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-aem-schema) menggunakan API. [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `AEM` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **URL host AEM —Tentukan URL** Adobe Experience Manager host. Misalnya, jika Anda menggunakan AEM On-Premise, Anda menyertakan nama host dan port: *https://hostname:port*. Atau, jika Anda menggunakan AEM as a Layanan Cloud, Anda dapat menggunakan URL penulis: *https://author-xxxxxx-xxxxxxx.adobeaemcloud.com*. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Jenis otentikasi** —Tentukan jenis otentikasi yang ingin Anda gunakan, salah satu atau. `Basic` `OAuth2` + **Jenis AEM** —Tentukan jenis yang Adobe Experience Manager Anda gunakan, salah satu atau`CLOUD`. `ON_PREMISE` + **Rahasia Nama Sumber Daya Amazon (ARN)** —Jika Anda ingin menggunakan otentikasi dasar untuk AEM On-Premise atau Cloud, Anda memberikan rahasia yang menyimpan kredensi otentikasi nama pengguna dan kata sandi Anda. Anda memberikan Nama Sumber Daya Amazon (ARN) dari sebuah AWS Secrets Manager rahasia. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "aemUrl": "Adobe Experience Manager On-Premise host URL", "username": "user name with admin permissions", "password": "password with admin permissions" } ``` Jika Anda ingin menggunakan otentikasi OAuth 2.0 untuk AEM On-Premise, rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "aemUrl": "Adobe Experience Manager host URL", "clientId": "client ID", "clientSecret": "client secret", "privateKey": "private key" } ``` Jika Anda ingin menggunakan otentikasi OAuth 2.0 untuk AEM sebagai Layanan Cloud, rahasia disimpan dalam struktur JSON dengan kunci berikut: ``` { "clientId": "client ID", "clientSecret": "client secret", "privateKey": "private key", "orgId": "organization ID", "technicalAccountId": "technical account ID", "imsHost": "Adobe Identity Management System (IMS) host" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik APIs yang diperlukan untuk konektor Adobe Experience Manager dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Adobe Experience Manager](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **ID zona waktu** —Jika Anda menggunakan AEM On-Premise dan zona waktu server Anda berbeda dari zona waktu konektor atau indeks Amazon Kendra AEM, Anda dapat menentukan zona waktu server agar sejajar dengan konektor atau indeks AEM. Zona waktu default untuk AEM On-Premise adalah zona waktu konektor atau indeks Amazon Kendra AEM. Zona waktu default untuk AEM sebagai Layanan Cloud adalah Greenwich Mean Time. Untuk informasi tentang zona waktu yang didukung IDs, lihat [skema Adobe Experience Manager JSON](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#aem-json). + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan halaman dan aset tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Adobe Experience Manager Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat [skema Adobe Experience Manager template](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-aem-schema). ------ # Alfresco **catatan** Konektor alfresco tetap didukung penuh untuk pelanggan lama hingga 31 Mei 2026. Meskipun konektor ini tidak lagi tersedia untuk pengguna baru, pengguna saat ini dapat terus menggunakannya tanpa gangguan. Kami terus mengembangkan portofolio konektor kami untuk menawarkan solusi yang lebih terukur dan dapat disesuaikan. Untuk integrasi masa depan, sebaiknya jelajahi Amazon Kendra Custom Connector Framework [1], yang dirancang untuk mendukung rangkaian kasus penggunaan perusahaan yang lebih luas dengan fleksibilitas yang ditingkatkan. Alfrescoadalah layanan manajemen konten yang membantu pelanggan menyimpan dan mengelola konten mereka. Anda dapat menggunakan Amazon Kendra untuk mengindeks pustaka Alfresco Dokumen, Wiki, dan Blog Anda. Amazon Kendramendukung Alfresco On-Premise dan Alfresco Cloud (Platform as a Service). Anda dapat terhubung Amazon Kendra ke sumber Alfresco data menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) atau [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber data Amazon Kendra Alfresco, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-alfresco) + [Prasyarat](#prerequisites-alfresco) + [Instruksi koneksi](#data-source-procedure-alfresco) + [Pelajari selengkapnya](#alfresco-learn-more) ## Fitur yang didukung Amazon KendraAlfrescokonektor sumber data mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan inkremental + OAuth 2.0 dan otentikasi dasar + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Alfresco Anda, buat perubahan ini pada sumber data Anda dan. Alfresco Akun AWS **DiAlfresco, pastikan Anda memiliki:** + Menyalin URL Alfresco repositori dan URL aplikasi web Anda. Jika Anda hanya ingin mengindeks Alfresco situs tertentu, maka salin juga ID situs. + Mencatat kredensi Alfresco otentikasi Anda, yang mencakup nama pengguna dan kata sandi dengan setidaknya izin baca. Jika Anda ingin menggunakan otentikasi OAuth 2.0, Anda harus menambahkan pengguna ke grup Alfresco administrator. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **Opsional**: Kredensi OAuth 2.0 yang dikonfigurasi di. Alfresco Kredensialnya termasuk ID klien, rahasia klien, dan URL token. Untuk informasi selengkapnya tentang cara mengonfigurasi klien untuk Alfresco Lokal, lihat dokumentasi [Alfresco](https://docs.alfresco.com/identity-service/latest/tutorial/sso/saml/). Jika Anda menggunakan Alfresco Cloud (PaaS), Anda harus menghubungi [dukungan Hyland](https://community.hyland.com/) untuk otentikasi Alfresco OAuth 2.0. + Memeriksa setiap dokumen unik di Alfresco dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi Alfresco Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasianya. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat menghubungkan sumber data Alfresco. Amazon Kendra Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Alfresco Anda, Anda harus memberikan rincian yang diperlukan dari sumber data Alfresco Anda sehingga dapat mengakses data Anda. Amazon Kendra Jika Anda belum mengkonfigurasi Alfresco untukAmazon Kendra, lihat. [Prasyarat](#prerequisites-alfresco) ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Alfresco** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. **Pada halaman **Tambahkan sumber data**, pilih konektor **Alfresco, lalu pilih Tambah konektor**.** Jika menggunakan versi 2 (jika ada), pilih **konektor Alfresco** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **Alfrescoketik** —Pilih apakah Anda menggunakan Alfresco On-Premises/Server atau Alfresco Cloud (Platform as a Service). 1. URL repositori **alfresco —Masukkan URL repositori** Alfresco Anda. Misalnya, jika Anda menggunakan Alfresco Cloud (PaaS), URL repositori bisa jadi. *https://company.alfrescocloud.com* Atau, jika Anda menggunakan Alfresco On-Premise, URL repositorinya dapat berupa *https://company-alfresco-instance.company-domain.suffix:port*. 1. **Aplikasi pengguna alfresco. URL** —Masukkan URL antarmuka Alfresco pengguna Anda. Anda bisa mendapatkan URL repositori dari administrator AndaAlfresco. Misalnya, URL antarmuka pengguna dapat berupa *https://example.com*. 1. **Lokasi sertifikat SSL** —Masukkan jalur ke sertifikat SSL yang disimpan dalam bucket. Amazon S3 Anda menggunakan ini untuk terhubung ke Alfresco Lokal dengan koneksi SSL yang aman. 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. **Otentikasi** **—Pilih otentikasi **dasar atau OAuth otentikasi 2.0**.** Kemudian pilih Secrets Manager rahasia yang ada atau buat rahasia baru untuk menyimpan Alfresco kredensil Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. Jika Anda memilih **otentikasi Dasar**, masukkan nama untuk rahasia, nama Alfresco pengguna, dan kata sandi. Jika Anda memilih **otentikasi OAuth 2.0**, masukkan nama untuk rahasia, ID klien, rahasia klien, dan URL token. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. 1. **IAMperan** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Lingkup sinkronisasi** —Tetapkan batas untuk merayapi konten tertentu dan memfilter konten menggunakan pola ekspresi regex. 1. 1. **Konten** —Pilih apakah akan merayapi konten yang ditandai dengan 'Aspek'Alfresco, konten dalam Alfresco situs tertentu, atau konten di semua situs AndaAlfresco. 1. (Opsional) **Konfigurasi tambahan** —Atur pengaturan berikut: + **Sertakan komentar** —Pilih untuk menyertakan komentar di pustaka Alfresco Dokumen dan Blog. + Pola **Regex —Pola** ekspresi reguler untuk menyertakan atau mengecualikan file tertentu. 1. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda. 1. Untuk menambahkan bidang sumber data kustom, buat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Alfresco** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-alfresco-schema) menggunakan API. [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `ALFRESCO` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **AlfrescoID situs** —Tentukan ID situs Alfresco. + AlfrescoURL **repositori —Tentukan URL** repositori. Alfresco Anda bisa mendapatkan URL repositori dari administrator AndaAlfresco. Misalnya, jika Anda menggunakan Alfresco Cloud (PaaS), URL repositori bisa jadi. *https://company.alfrescocloud.com* Atau, jika Anda menggunakan Alfresco On-Premise, URL repositorinya dapat berupa *https://company-alfresco-instance.company-domain.suffix:port*. + **AlfrescoURL aplikasi web** —Tentukan URL antarmuka Alfresco pengguna. Anda bisa mendapatkan URL repositori dari administrator AndaAlfresco. Misalnya, URL antarmuka pengguna dapat berupa *https://example.com*. + **Jenis otentikasi** —Tentukan jenis otentikasi yang ingin Anda gunakan, apakah atau. `OAuth2` `Basic` + **Alfrescotype** —Tentukan jenis yang Alfresco Anda gunakan, apakah `PAAS` (Cloud/Platform sebagai Layanan) atau `ON_PREM` (Lokal). + **Rahasia Nama Sumber Daya Amazon (ARN)** —Jika Anda ingin menggunakan otentikasi dasar, Anda memberikan rahasia yang menyimpan kredensi otentikasi nama pengguna dan kata sandi Anda. Anda memberikan Nama Sumber Daya Amazon (ARN) dari sebuah AWS Secrets Manager rahasia. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "username": "user name", "password": "password" } ``` Jika Anda ingin menggunakan otentikasi OAuth 2.0, rahasia disimpan dalam struktur JSON dengan kunci berikut: ``` { "clientId": "client ID", "clientSecret": "client secret", "tokenUrl": "token URL" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik APIs yang diperlukan untuk konektor Alfresco dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Alfresco](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Jenis konten** —Jenis konten yang ingin dirayapi, apakah konten yang ditandai dengan 'Aspek'Alfresco, konten dalam Alfresco situs tertentu, atau konten di semua situs AndaAlfresco. Anda juga dapat membuat daftar konten 'Aspek' tertentu. + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan file tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Alfresco Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat [skema Alfresco template](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-alfresco-schema). ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Alfresco Anda, lihat: + [Cerdas mencari konten menggunakan AlfrescoAmazon Kendra](https://aws.amazon.com/blogs/machine-learning/intelligently-search-alfresco-content-using-amazon-kendra/) # Aurora(MySQL) **catatan** Aurora(MySQL)konektor tetap didukung penuh untuk pelanggan yang sudah ada hingga 31 Mei 2026. Meskipun konektor ini tidak lagi tersedia untuk pengguna baru, pengguna saat ini dapat terus menggunakannya tanpa gangguan. Kami terus mengembangkan portofolio konektor kami untuk menawarkan solusi yang lebih terukur dan dapat disesuaikan. Untuk integrasi masa depan, sebaiknya jelajahi Amazon Kendra Custom Connector Framework [1], yang dirancang untuk mendukung rangkaian kasus penggunaan perusahaan yang lebih luas dengan fleksibilitas yang ditingkatkan. Auroraadalah sistem manajemen basis data relasional (RDBMS) yang dibangun untuk cloud. Jika Anda adalah Aurora pengguna, Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber Aurora(MySQL) data Anda. Konektor sumber Amazon Kendra Aurora(MySQL) data mendukung Aurora MySQL 3 dan MySQL 8.0 Tanpa Aurora Server. Anda dapat terhubung Amazon Kendra ke sumber Aurora(MySQL) data menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber Amazon Kendra Aurora(MySQL) data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-aurora-mysql) + [Prasyarat](#prerequisites-aurora-mysql) + [Instruksi koneksi](#data-source-procedure-aurora-mysql) + [Catatan](#aurora-mysql-notes) ## Fitur yang didukung + Pemetaan bidang + Pemfilteran konteks pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan inkremental + Cloud privat virtual (VPC) ## Prasyarat Sebelum dapat digunakan Amazon Kendra untuk mengindeks sumber Aurora(MySQL) data Anda, buat perubahan ini di akun Aurora(MySQL) dan AWS akun Anda. **DiAurora(MySQL), pastikan Anda memiliki:** + Mencatat nama pengguna dan kata sandi database Anda. **penting** Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Menyalin url, port, dan instance host database Anda. Anda dapat menemukan informasi ini di Amazon RDS konsol. + Memeriksa setiap dokumen unik di dalam Aurora(MySQL) dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensyal Aurora(MySQL) otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber Aurora(MySQL) data AndaAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber Aurora(MySQL) data Anda, Anda harus memberikan rincian Aurora(MySQL) kredensyal Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Aurora(MySQL) untuk Amazon Kendra lihat[Prasyarat](#prerequisites-aurora-mysql). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Aurora(MySQL)** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **Aurora(MySQL)konektor**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **Aurora(MySQL)konektor** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. Di **Sumber**, masukkan informasi berikut: 1. **Host** — Masukkan URL host database, misalnya:`http://instance URL.region.rds.amazonaws.com`. 1. **Port** — Masukkan port database, misalnya,`5432`. 1. **Instance** - Masukkan instance database. 1. Dalam **Otentikasi** —masukkan informasi berikut: 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal Aurora(MySQL) otentikasi Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra- Aurora(MySQL) -' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **nama pengguna Database**, dan **Kata Sandi** —Masukkan nilai kredensi otentikasi yang Anda salin dari database Anda. 1. Pilih **Simpan**. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **IAMperan** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensyal repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Dalam **lingkup Sinkronisasi**, pilih dari opsi berikut: + **Kueri SQL**—Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB Kueri SQL harus kurang dari 32KB dan tidak mengandung semi-titik dua (;). Amazon Kendraakan merayapi semua konten database yang cocok dengan kueri Anda. + **Kolom kunci primer**—Berikan kunci primer untuk tabel basis data. Detail ini mengidentifikasi tabel di dalam basis data Anda. + **Kolom judul**—Berikan nama kolom judul dokumen di dalam tabel basis data Anda. + **Kolom tubuh** —Berikan nama kolom badan dokumen dalam tabel database Anda. 1. Dalam **Konfigurasi tambahan — *opsional***, pilih dari opsi berikut untuk menyinkronkan konten tertentu alih-alih menyinkronkan semua file: + **Kolom pendeteksi perubahan** —Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendraakan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini. + ** IDsKolom pengguna** —Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. + **Kolom grup**—Masukkan nama kolom yang berisi grup untuk diizinkan mengakses konten. + ** URLsKolom sumber** —Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. + **Kolom stempel waktu** —Masukkan nama kolom yang berisi stempel waktu. Amazon Kendramenggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. + **Kolom zona waktu**—Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. + **Format stempel waktu**—Masukkan nama kolom yang berisi format stempel waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. 1. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Dalam **jadwal berjalan Sinkronisasi**, untuk **Frekuensi** —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang sumber data default yang dihasilkan— **Dokumen IDs**, **Judul dokumen**, dan **Sumber URLs** —Anda ingin memetakan ke Amazon Kendra indeks. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Aurora(MySQL)** Anda harus menentukan yang berikut menggunakan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API: + **Sumber data** —Tentukan tipe sumber data seperti `JDBC` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Juga tentukan sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **Jenis database** —Anda harus menentukan jenis database sebagai`mySql`. + **Kueri SQL** —Tentukan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensi otentikasi yang Anda buat di akun Anda. Aurora(MySQL) Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "user name": "database user name", "password": "password" } ``` **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk Aurora(MySQL) konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber Aurora(MySQL) data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan konten tertentu menggunakan pengguna IDs, grup, sumber, stempel waktu URLs, dan zona waktu. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber Aurora(MySQL) data Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat[Aurora Skema templat (MySQL)](ds-schemas.md#ds-aurora-mysql-schema). ------ ## Catatan + Baris database yang dihapus tidak akan dilacak saat Amazon Kendra memeriksa konten yang diperbarui. + Ukuran nama bidang dan nilai dalam deretan database Anda tidak dapat melebihi 400KB. + Jika Anda memiliki sejumlah besar data dalam sumber data database Anda, dan tidak Amazon Kendra ingin mengindeks semua konten database Anda setelah sinkronisasi pertama, Anda dapat memilih untuk menyinkronkan hanya dokumen baru, dimodifikasi, atau dihapus. + Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Sebagai praktik terbaik, hindari menambahkan tabel dengan data sensitif atau informasi identitas pribadi (PII). # Aurora(PostgreSQL) **catatan** Aurora(PostgreSQL)konektor tetap didukung penuh untuk pelanggan yang sudah ada hingga 31 Mei 2026. Meskipun konektor ini tidak lagi tersedia untuk pengguna baru, pengguna saat ini dapat terus menggunakannya tanpa gangguan. Kami terus mengembangkan portofolio konektor kami untuk menawarkan solusi yang lebih terukur dan dapat disesuaikan. Untuk integrasi masa depan, sebaiknya jelajahi Amazon Kendra Custom Connector Framework [1], yang dirancang untuk mendukung rangkaian kasus penggunaan perusahaan yang lebih luas dengan fleksibilitas yang ditingkatkan. Auroraadalah sistem manajemen basis data relasional (RDBMS) yang dibangun untuk cloud. Jika Anda adalah Aurora pengguna, Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber Aurora(PostgreSQL) data Anda. Konektor sumber Amazon Kendra Aurora(PostgreSQL) data mendukung Aurora PostgreSQL 1. Anda dapat terhubung Amazon Kendra ke sumber Aurora(PostgreSQL) data menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber Amazon Kendra Aurora(PostgreSQL) data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-aurora-postgresql) + [Prasyarat](#prerequisites-aurora-postgresql) + [Instruksi koneksi](#data-source-procedure-aurora-postgresql) + [Catatan](#aurora-postgresql-notes) ## Fitur yang didukung + Pemetaan bidang + Pemfilteran konteks pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan inkremental + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber Aurora(PostgreSQL) data Anda, buat perubahan ini di akun Aurora(PostgreSQL) dan AWS akun Anda. **DiAurora(PostgreSQL), pastikan Anda memiliki:** + Mencatat nama pengguna dan kata sandi database Anda. **penting** Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Menyalin url, port, dan instance host database Anda. + Memeriksa setiap dokumen unik di dalam Aurora(PostgreSQL) dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensyal Aurora(PostgreSQL) otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber Aurora(PostgreSQL) data AndaAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber Aurora(PostgreSQL) data Anda, Anda harus memberikan rincian Aurora(PostgreSQL) kredensyal Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Aurora(PostgreSQL) untuk Amazon Kendra lihat[Prasyarat](#prerequisites-aurora-postgresql). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Aurora(PostgreSQL)** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **Aurora(PostgreSQL)konektor**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **Aurora(PostgreSQL)konektor** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. Di **Sumber**, masukkan informasi berikut: 1. **Host** — Masukkan URL host database, misalnya:`http://instance URL.region.rds.amazonaws.com`. 1. **Port** — Masukkan port database, misalnya,`5432`. 1. **Instance** — Masukkan contoh database, misalnya`postgres`. 1. **Aktifkan lokasi sertifikat SSL** —Pilih untuk memasukkan Amazon S3 jalur ke file sertifikat SSL Anda. 1. Dalam **Otentikasi** —masukkan informasi berikut: 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal Aurora(PostgreSQL) otentikasi Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra- Aurora(PostgreSQL) -' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **nama pengguna Database**, dan **Kata Sandi** —Masukkan nilai kredensi otentikasi yang Anda salin dari database Anda. 1. Pilih **Simpan**. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Dalam **lingkup Sinkronisasi**, pilih dari opsi berikut: + **Kueri SQL**—Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB Kueri SQL harus kurang dari 32KB dan tidak mengandung semi-titik dua (;). Amazon Kendraakan merayapi semua konten database yang cocok dengan kueri Anda. + **Kolom kunci primer**—Berikan kunci primer untuk tabel basis data. Detail ini mengidentifikasi tabel di dalam basis data Anda. + **Kolom judul**—Berikan nama kolom judul dokumen di dalam tabel basis data Anda. + **Kolom tubuh** —Berikan nama kolom badan dokumen dalam tabel database Anda. 1. Dalam **Konfigurasi tambahan — *opsional***, pilih dari opsi berikut untuk menyinkronkan konten tertentu alih-alih menyinkronkan semua file: + **Kolom pendeteksi perubahan** —Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendraakan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini. + ** IDsKolom pengguna** —Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. + **Kolom grup**—Masukkan nama kolom yang berisi grup untuk diizinkan mengakses konten. + ** URLsKolom sumber** —Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. + **Kolom stempel waktu** —Masukkan nama kolom yang berisi stempel waktu. Amazon Kendramenggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. + **Kolom zona waktu**—Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. + **Format stempel waktu**—Masukkan nama kolom yang berisi format stempel waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. 1. **Mode sinkronisasi** —Pilih cara Anda ingin memperbarui indeks saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Dalam **jadwal berjalan Sinkronisasi**, untuk **Frekuensi** —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang sumber data default yang dihasilkan— **Dokumen IDs**, **Judul dokumen**, dan **Sumber URLs** —Anda ingin memetakan ke Amazon Kendra indeks. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Aurora(PostgreSQL)** Anda harus menentukan yang berikut menggunakan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API: + **Sumber data** —Tentukan tipe sumber data seperti `JDBC` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **Jenis database** —Anda harus menentukan jenis database sebagai`postgresql`. + **Kueri SQL** —Tentukan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensi otentikasi yang Anda buat di akun Anda. Aurora(PostgreSQL) Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "user name": "database user name", "password": "password" } ``` **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk Aurora(PostgreSQL) konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber Aurora(PostgreSQL) data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan konten tertentu menggunakan pengguna IDs, grup, sumber, stempel waktu URLs, dan zona waktu. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber Aurora(PostgreSQL) data Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat[Aurora (PostgreSQL) skema templat](ds-schemas.md#ds-aurora-postgresql-schema). ------ ## Catatan + Baris database yang dihapus tidak akan dilacak saat Amazon Kendra memeriksa konten yang diperbarui. + Ukuran nama bidang dan nilai dalam deretan database Anda tidak dapat melebihi 400KB. + Jika Anda memiliki sejumlah besar data dalam sumber data database Anda, dan tidak Amazon Kendra ingin mengindeks semua konten database Anda setelah sinkronisasi pertama, Anda dapat memilih untuk menyinkronkan hanya dokumen baru, dimodifikasi, atau dihapus. + Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Sebagai praktik terbaik, hindari menambahkan tabel dengan data sensitif atau informasi identitas pribadi (PII). # Amazon FSx(Jendela) Amazon FSx(Windows) adalah sistem server file berbasis cloud yang dikelola sepenuhnya yang menawarkan kemampuan penyimpanan bersama. Jika Anda pengguna Amazon FSx (Windows), Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Amazon FSx (Windows) Anda. **catatan** Amazon Kendrasekarang mendukung konektor Amazon FSx (Windows) yang ditingkatkan. Konsol telah ditingkatkan secara otomatis untuk Anda. Konektor baru apa pun yang Anda buat di konsol akan menggunakan arsitektur yang ditingkatkan. Jika Anda menggunakan API, Anda sekarang harus menggunakan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objek alih-alih `FSxConfiguration` objek untuk mengonfigurasi konektor Anda. Konektor yang dikonfigurasi menggunakan konsol lama dan arsitektur API akan terus berfungsi seperti yang dikonfigurasi. Namun, Anda tidak akan dapat mengedit atau memperbaruinya. Jika Anda ingin mengedit atau memperbarui konfigurasi konektor Anda, Anda harus membuat konektor baru. Kami merekomendasikan untuk memigrasikan alur kerja konektor Anda ke versi yang ditingkatkan. Support untuk konektor yang dikonfigurasi menggunakan arsitektur lama dijadwalkan berakhir pada Juni 2024. Anda dapat terhubung Amazon Kendra ke sumber data Amazon FSx (Windows) menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/), atau [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber data Amazon Kendra Amazon FSx (Windows) Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-fsx) + [Prasyarat](#prerequisites-fsx) + [Instruksi koneksi](#data-source-procedure-fsx) + [Pelajari selengkapnya](#fsx-learn-more) ## Fitur yang didukung Amazon KendraAmazon FSx(Windows) konektor sumber data mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Perayapan identitas pengguna + Filter inklusi dan pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Amazon FSx (Windows) Anda, periksa detail Amazon FSx (Windows) Anda danAkun AWS. **Untuk Amazon FSx (Windows), pastikan Anda memiliki**: + Siapkan Amazon FSx (Windows) dengan izin baca dan pemasangan. + Mencatat ID sistem file Anda. Anda dapat menemukan ID sistem file Anda di dasbor Sistem File di konsol Amazon FSx (Windows). + Mengonfigurasi cloud pribadi virtual menggunakan Amazon VPC tempat sistem file Amazon FSx (Windows) Anda berada. + Mencatat kredensi otentikasi Amazon FSx (Windows) Anda untuk akun Active Directory pengguna. Ini termasuk nama pengguna Active Directory Anda dengan nama domain DNS Anda (misalnya, *user@corp.example.com*) dan kata sandi. **catatan** Gunakan hanya kredensil yang diperlukan agar konektor berfungsi. Jangan gunakan kredensil istimewa seperti admin domain. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + Memeriksa setiap dokumen unik di Amazon FSx (Windows) dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi Amazon FSx (Windows) Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data Amazon FSx (Windows) AndaAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Amazon FSx (Windows) Anda, Anda harus memberikan rincian yang diperlukan dari sumber data Amazon FSx (Windows) Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Amazon FSx (Windows) untukAmazon Kendra, lihat[Prasyarat](#prerequisites-fsx). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke sistem file Amazon FSx (Windows) Anda** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **konektor Amazon FSx (Windows)**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Amazon FSx (Windows)** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen menggantikan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **Amazon FSx(Windows) ID sistem file** —Pilih dari dropdown ID sistem file Anda yang ada, diambil dari Amazon FSx (Windows). Atau, buat [sistem file Amazon FSx (Windows)](https://console.aws.amazon.com/fsx/). Anda dapat menemukan ID sistem file Anda di dasbor Sistem File di konsol Amazon FSx (Windows). 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. **Otentikasi** —Pilih AWS Secrets Manager rahasia yang ada, atau buat rahasia baru untuk menyimpan kredensi sistem file Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. Berikan rahasia yang menyimpan kredensi otentikasi Anda atas nama pengguna dan kata sandi Anda. Nama pengguna harus menyertakan nama domain DNS Anda. Misalnya, *user@corp.example.com*. Simpan dan tambahkan rahasia Anda. 1. **Virtual Private Cloud (VPC)** —Anda harus memilih Amazon VPC tempat (Windows) Anda Amazon FSx berada. Anda menyertakan subnet VPC dan grup keamanan. Lihat [Mengkonfigurasi file. Amazon VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html) 1. **IAMperan** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Lingkup sinkronisasi, pola Regex —Tambahkan pola** ekspresi reguler untuk menyertakan atau mengecualikan file tertentu. 1. **Mode sinkronisasi** —Pilih cara Anda ingin memperbarui indeks saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. **Sinkronkan jadwal berjalan** —Untuk **Frekuensi**, pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang default Amazon Kendra yang dihasilkan dari file Anda yang ingin Anda petakan ke indeks Anda. Untuk menambahkan bidang sumber data kustom, buat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke sistem file Amazon FSx (Windows) Anda** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-fsx-schema) menggunakan API. [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `FSX` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **ID sistem file** —Pengidentifikasi sistem file Amazon FSx (Windows). Anda dapat menemukan ID sistem file Anda di dasbor Sistem File di konsol Amazon FSx (Windows). + **Jenis sistem file** —Tentukan jenis sistem file sebagai`WINDOWS`. + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). **catatan** Anda harus memilih Amazon VPC tempat Amazon FSx (Windows) Anda berada. Anda menyertakan subnet VPC dan grup keamanan. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensi otentikasi untuk akun (Windows) Anda. Amazon FSx Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "username": "user@corp.example.com", "password": "password" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Amazon FSx (Windows) dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Amazon FSx (Windows)](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan file tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Daftar kontrol akses (ACL)** —Tentukan apakah akan merayapi informasi ACL untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). **catatan** Untuk menguji pemfilteran konteks pengguna pada pengguna, Anda harus menyertakan nama domain DNS sebagai bagian dari nama pengguna saat Anda mengeluarkan kueri. Anda harus memiliki izin administratif dari domain Active Directory. Anda juga dapat menguji pemfilteran konteks pengguna pada nama grup. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Amazon FSx (Windows) Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat [skema templat Amazon FSx (Windows)](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-fsx-windows-schema). ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Amazon FSx (Windows) Anda, lihat: + [Cari data tidak terstruktur dengan aman pada sistem file Windows dengan Amazon Kendra konektor untuk Amazon FSx (Windows)](https://aws.amazon.com/blogs/machine-learning/securely-search-unstructured-data-on-windows-file-systems-with-amazon-kendra-connector-for-amazon-fsx-for-windows-file-server/) untuk. Windows File Server # Amazon FSx(NetApp ONTAP) Amazon FSx(NetApp ONTAP) adalah sistem server file berbasis cloud yang dikelola sepenuhnya yang menawarkan kemampuan penyimpanan bersama. Jika Anda pengguna Amazon FSx (NetApp ONTAP), Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Amazon FSx (NetApp ONTAP) Anda. Anda dapat terhubung Amazon Kendra ke sumber data Amazon FSx (NetApp ONTAP) menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/), atau [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber data Amazon Kendra Amazon FSx (NetApp ONTAP) Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-fsx-ontap) + [Prasyarat](#prerequisites-fsx-ontap) + [Instruksi koneksi](#data-source-procedure-fsx-ontap) ## Fitur yang didukung Amazon KendraAmazon FSx(NetApp ONTAP) konektor sumber data mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi dan pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Amazon FSx (NetApp ONTAP) Anda, periksa detail Amazon FSx (NetApp ONTAP) Anda dan. Akun AWS **Untuk Amazon FSx (NetApp ONTAP), pastikan Anda memiliki**: + Siapkan Amazon FSx (NetApp ONTAP) dengan izin baca dan pemasangan. + Mencatat ID sistem file Anda. Anda dapat menemukan ID sistem file Anda di dasbor Sistem File di konsol Amazon FSx (NetApp ONTAP). + Mencatat ID mesin virtual penyimpanan (SVM) yang digunakan dengan sistem file Anda. Anda dapat menemukan ID SVM Anda dengan membuka dasbor Sistem File di konsol Amazon FSx (NetApp ONTAP), memilih ID sistem file Anda, dan kemudian memilih mesin **virtual Penyimpanan**. + Mengonfigurasi cloud pribadi virtual menggunakan Amazon VPC tempat sistem file Amazon FSx (NetApp ONTAP) Anda berada. + Mencatat kredensi autentikasi Amazon FSx (NetApp ONTAP) Anda untuk akun pengguna. Active Directory Ini termasuk nama pengguna Active Directory Anda dengan nama domain DNS Anda (misalnya, *user@corp.example.com*) dan kata sandi. Jika Anda menggunakan protokol Network File System (NFS) untuk sistem file Amazon FSx (NetApp ONTAP) Anda, kredensi otentikasi mencakup ID kiri, ID kanan, dan kunci yang telah dibagikan sebelumnya. **catatan** Gunakan hanya kredensil yang diperlukan agar konektor berfungsi. Jangan gunakan kredensil istimewa seperti admin domain. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + Memeriksa setiap dokumen unik di Amazon FSx (NetApp ONTAP) dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi Amazon FSx (NetApp ONTAP) Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat menghubungkan sumber data Amazon FSx (NetApp ONTAP). Amazon Kendra Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Amazon FSx (NetApp ONTAP) Anda, Anda harus memberikan rincian yang diperlukan dari sumber data Amazon FSx (NetApp ONTAP) Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Amazon FSx (NetApp ONTAP) untukAmazon Kendra, lihat[Prasyarat](#prerequisites-fsx-ontap). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke sistem file Amazon FSx (NetApp ONTAP)** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **konektor Amazon FSx (NetApp ONTAP)**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Amazon FSx (NetApp ONTAP) dengan tag** “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **Sumber** —Berikan informasi sistem file Anda. + **Protokol sistem file** —Pilih protokol sistem file Amazon FSx (NetApp ONTAP) Anda. Anda dapat memilih protokol Common Internet File System (CIFS), atau protokol Network File System (NFS) untuk Linux. + **Amazon FSx(NetApp ONTAP) ID sistem file** —Pilih dari dropdown ID sistem file Anda yang ada, diambil dari (ONTAP). Amazon FSx NetApp Atau, buat [sistem file Amazon FSx (NetApp ONTAP)](https://console.aws.amazon.com/fsx/). Anda dapat menemukan ID sistem file Anda di dasbor Sistem File di konsol Amazon FSx (NetApp ONTAP). + **ID SVM** (Amazon FSx(NetApp ONTAP) NetApp ONTAP hanya untuk) —Berikan ID mesin virtual penyimpanan (SVM) Anda Amazon FSx (ONTAP). NetApp NetApp ONTAP Anda dapat menemukan ID SVM Anda dengan membuka dasbor Sistem File di konsol Amazon FSx (NetApp ONTAP), memilih ID sistem file Anda, dan memilih mesin **virtual Penyimpanan**. 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. **Otentikasi** —Pilih AWS Secrets Manager rahasia yang ada, atau buat rahasia baru untuk menyimpan kredensi sistem file Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. Berikan rahasia yang menyimpan kredensi otentikasi Anda atas nama pengguna dan kata sandi Anda. Nama pengguna harus menyertakan nama domain DNS Anda. Misalnya, *user@corp.example.com*. Jika Anda menggunakan protokol NFS untuk sistem file Amazon FSx (NetApp ONTAP) Anda, berikan rahasia yang menyimpan kredensi otentikasi Anda dari ID kiri, ID kanan, dan kunci yang telah dibagikan sebelumnya. Simpan dan tambahkan rahasia Anda. 1. **Virtual Private Cloud (VPC)** —Anda harus memilih lokasi (ONTAP) Anda Amazon VPC Amazon FSx berada. NetApp Anda menyertakan subnet VPC dan grup keamanan. Lihat [Mengkonfigurasi file. Amazon VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html) 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Lingkup sinkronisasi, pola Regex —Tambahkan pola** ekspresi reguler untuk menyertakan atau mengecualikan file tertentu. 1. **Mode sinkronisasi** —Pilih cara Anda ingin memperbarui indeks saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. **Sinkronkan jadwal berjalan** —Untuk **Frekuensi**, pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang default Amazon Kendra yang dihasilkan dari file Anda yang ingin Anda petakan ke indeks Anda. Untuk menambahkan bidang sumber data kustom, buat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke sistem file Amazon FSx (NetApp ONTAP)** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-fsx-ontap-schema) menggunakan API. [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `FSXONTAP` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **ID sistem file** —Pengidentifikasi sistem file Amazon FSx (NetApp ONTAP). Anda dapat menemukan ID sistem file Anda di dasbor Sistem File di konsol Amazon FSx (NetApp ONTAP). + ID **SVM —ID** mesin virtual penyimpanan (SVM) yang digunakan dengan sistem file Anda. Anda dapat menemukan ID SVM Anda dengan membuka dasbor Sistem File di konsol Amazon FSx (NetApp ONTAP), memilih ID sistem file Anda, dan kemudian memilih mesin **virtual Penyimpanan**. + **Jenis protokol** —Tentukan apakah Anda menggunakan protokol Common Internet File System (CIFS), atau protokol Network File System (NFS) untuk Linux. + **Jenis sistem file** —Tentukan jenis sistem file sebagai keduanya`FSXONTAP`. + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). **catatan** Anda harus memilih Amazon VPC tempat Amazon FSx (NetApp ONTAP) Anda berada. Anda menyertakan subnet VPC dan grup keamanan. + **Rahasia Nama Sumber Daya Amazon (ARN) —Berikan** Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensi otentikasi untuk akun (ONTAP) Anda. Amazon FSx NetApp Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "username": "user@corp.example.com", "password": "password" } ``` Jika Anda menggunakan protokol NFS untuk sistem file Amazon FSx (NetApp ONTAP) Anda, rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "leftId": "left ID", "rightId": "right ID", "preSharedKey": "pre-shared key" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Amazon FSx (NetApp ONTAP) dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Amazon FSx (NetApp ONTAP)](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan file tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Daftar kontrol akses (ACL)** —Tentukan apakah akan merayapi informasi ACL untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). **catatan** Untuk menguji pemfilteran konteks pengguna pada pengguna, Anda harus menyertakan nama domain DNS sebagai bagian dari nama pengguna saat Anda mengeluarkan kueri. Anda harus memiliki izin administratif dari domain Active Directory. Anda juga dapat menguji pemfilteran konteks pengguna pada nama grup. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Amazon FSx (NetApp ONTAP) Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat skema [templat Amazon FSx (NetApp ONTAP)](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-fsx-ontap-schema). ------ # Amazon RDS/Aurora Anda dapat mengindeks dokumen yang disimpan dalam database menggunakan sumber data database. Setelah Anda memberikan informasi koneksi untuk database, Amazon Kendra menghubungkan dan mengindeks dokumen. Amazon Kendramendukung database berikut: + Amazon Aurora MySQL + Amazon Aurora PostgreSQL + Amazon RDSuntuk MySQL + Amazon RDSuntuk PostgreSQL **catatan** Database Aurora tanpa server tidak didukung. **penting** RDS/Aurora Konektor Amazon ini dijadwalkan untuk penghentian pada akhir 2023. Amazon Kendrasekarang mendukung konektor sumber data database baru. Untuk pengalaman yang lebih baik, kami sarankan Anda memilih dari konektor baru berikut untuk kasus penggunaan Anda: [Aurora(MySQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aurora-mysql.html) [Aurora(PostgreSQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aurora-postgresql.html) [Amazon RDS(MySQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-mysql.html) [Amazon RDS(Server Microsoft SQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-ms-sql-server.html) [Amazon RDS(Oracle)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-oracle.html) [Amazon RDS(PostgreSQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-postgresql.html) [IBM DB2](https://docs.aws.amazon.com/kendra/latest/dg/data-source-ibm-db2.html) [Microsoft SQL Server](https://docs.aws.amazon.com/kendra/latest/dg/data-source-ms-sql-server.html) [MySQL](https://docs.aws.amazon.com/kendra/latest/dg/data-source-mysql.html) [Database Oracle](https://docs.aws.amazon.com/kendra/latest/dg/data-source-oracle-database.html) [PostgreSQL](https://docs.aws.amazon.com/kendra/latest/dg/data-source-postgresql.html) Anda dapat terhubung Amazon Kendra ke sumber data database Anda menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [DatabaseConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DatabaseConfiguration.html)API. Untuk memecahkan masalah konektor sumber data Amazon Kendra database Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-database) + [Prasyarat](#prerequisites-database) + [Instruksi koneksi](#data-source-procedure-database) ## Fitur yang didukung Amazon Kendrakonektor sumber data database mendukung fitur-fitur berikut: + Pemetaan bidang + Pemfilteran konteks pengguna + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data database Anda, buat perubahan ini di database dan AWS akun Anda. **Dalam database Anda, pastikan Anda memiliki:** + Mencatat kredensi otentikasi dasar Anda dari nama pengguna dan kata sandi untuk database Anda. + Menyalin nama host, nomor port, alamat host, nama database, dan nama tabel data yang berisi data dokumen. Untuk PostgreSQL, tabel data harus berupa tabel publik atau skema publik. **catatan** Host dan port memberi tahu Amazon Kendra di mana menemukan server database di internet. Nama database dan nama tabel memberi tahu Amazon Kendra di mana menemukan data dokumen di server database. + Menyalin nama kolom dalam tabel data yang berisi data dokumen. Anda harus menyertakan ID dokumen, badan dokumen, kolom untuk mendeteksi apakah dokumen telah berubah (misalnya, kolom terakhir diperbarui), dan kolom tabel data opsional yang dipetakan ke bidang indeks kustom. Anda juga dapat memetakan salah satu [nama bidang yang Amazon Kendra dicadangkan](https://docs.aws.amazon.com/kendra/latest/dg/hiw-document-attributes.html#index-reserved-fields) ke kolom tabel. + Menyalin informasi jenis mesin database seperti apakah Anda menggunakan Amazon RDS untuk MySQL atau jenis lain. + Memeriksa setiap dokumen unik dalam database dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi database Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data database AndaAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data database Anda, Anda harus memberikan rincian yang diperlukan dari sumber data database Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi database untukAmazon Kendra, lihat[Prasyarat](#prerequisites-database). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke database** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambah sumber data**, pilih **konektor database**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor database** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **Endpoint** — Nama host DNS, IPv4 alamat, atau alamat. IPv6 1. **Port** —Nomor port. 1. **Database** —Nama database. 1. **Nama tabel —Nama** tabel. 1. Untuk **Jenis otentikasi**, pilih antara **Existing** dan **New** untuk menyimpan kredensyal otentikasi database Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-database-' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **Nama Pengguna** dan **Kata Sandi** —Masukkan nilai kredensi otentikasi dari akun database Anda. 1. Pilih **Simpan otentikasi.** 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. **catatan** Anda harus menggunakan subnet pribadi. Jika instans RDS Anda berada di subnet publik di VPC Anda, Anda dapat membuat subnet pribadi yang memiliki akses keluar ke gateway NAT di subnet publik. Subnet yang disediakan dalam konfigurasi VPC harus berada di AS Barat (Oregon), AS Timur (Virginia N.), UE (Irlandia). 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Pilih antara **Aurora MySQL, MySQL, **Aurora** PostgreSQL****,** dan PostgreSQL berdasarkan kasus penggunaan Anda.** 1. **Lampirkan pengidentifikasi SQL dengan tanda kutip ganda** —Pilih untuk melampirkan pengidentifikasi SQL dalam tanda kutip ganda. Misalnya, “ColumnName”. 1. **Kolom ACL** dan **Ubah kolom pendeteksi** —Konfigurasikan kolom yang Amazon Kendra digunakan untuk deteksi perubahan (misalnya, kolom yang terakhir diperbarui) dan daftar kontrol akses Anda. 1. Di **Jadwal berjalan Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. **Amazon Kendrapemetaan bidang default** —Pilih dari bidang sumber data default Amazon Kendra yang dihasilkan yang ingin Anda petakan ke indeks Anda. Anda harus menambahkan nilai **kolom Database** untuk `document_id` dan `document_body` 1. **Pemetaan bidang kustom** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke database** Anda harus menentukan [DatabaseConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DatabaseConfiguration.html)API berikut ini: + **ColumnConfiguration**—Informasi tentang di mana indeks harus mendapatkan informasi dokumen dari database. Untuk detail selengkapnya, lihat [ColumnConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ColumnConfiguration.html). Anda harus menentukan bidang `DocumentDataColumnName` (badan dokumen atau teks utama) dan`DocumentIdColumnName`, dan `ChangeDetectingColumn` (misalnya, kolom yang diperbarui terakhir). Kolom yang dipetakan ke bidang `DocumentIdColumnName` harus berupa kolom integer. Contoh berikut menunjukkan konfigurasi kolom sederhana untuk sumber data database: ``` "ColumnConfiguration": { "ChangeDetectingColumns": [ "LastUpdateDate", "LastUpdateTime" ], "DocumentDataColumnName": "TextColumn", "DocumentIdColumnName": "IdentifierColumn", "DocoumentTitleColumnName": "TitleColumn", "FieldMappings": [ { "DataSourceFieldName": "AbstractColumn", "IndexFieldName": "Abstract" } ] } ``` + **ConnectionConfiguration**Konfigurasi informasi yang diperlukan untuk terhubung ke database. Untuk detail selengkapnya, lihat [ConnectionConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConnectionConfiguration.html). + **DatabaseEngineType**—Jenis mesin database yang menjalankan database. `DatabaseHost`Bidang untuk `ConnectionConfiguration` harus berupa titik akhir instance Amazon Relational Database Service (Amazon RDS) untuk database. Jangan gunakan titik akhir klaster. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi untuk akun database Anda. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "username": "user name", "password": "password" } ``` Contoh berikut menunjukkan konfigurasi database, termasuk ARN rahasia. ``` "DatabaseConfiguration": { "ConnectionConfiguration": { "DatabaseHost": "host.subdomain.domain.tld", "DatabaseName": "DocumentDatabase", "DatabasePort": 3306, "SecretArn": "arn:aws:secretmanager:region:account ID:secret/secret name", "TableName": "DocumentTable" } } ``` **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor database dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data database](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC)** —Tentukan `VpcConfiguration` sebagai bagian dari konfigurasi sumber data. Lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html). **catatan** Anda hanya perlu menggunakan subnet pribadi. Jika instans RDS Anda berada di subnet publik di VPC Anda, Anda dapat membuat subnet pribadi yang memiliki akses keluar ke gateway NAT di subnet publik. Subnet yang disediakan dalam konfigurasi VPC harus berada di AS Barat (Oregon), AS Timur (Virginia N.), UE (Irlandia). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data database Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). ------ # Amazon RDS(Microsoft SQL Server) **catatan** Amazon RDSKonektor (Microsoft SQL Server) tetap didukung penuh untuk pelanggan yang sudah ada hingga 31 Mei 2026. Meskipun konektor ini tidak lagi tersedia untuk pengguna baru, pengguna saat ini dapat terus menggunakannya tanpa gangguan. Kami terus mengembangkan portofolio konektor kami untuk menawarkan solusi yang lebih terukur dan dapat disesuaikan. Untuk integrasi masa depan, sebaiknya jelajahi Amazon Kendra Custom Connector Framework [1], yang dirancang untuk mendukung rangkaian kasus penggunaan perusahaan yang lebih luas dengan fleksibilitas yang ditingkatkan. SQL Server adalah sistem manajemen database yang dikembangkan oleh Microsoft. Amazon RDSuntuk SQL Server memudahkan untuk mengatur, mengoperasikan, dan menskalakan penyebaran SQL Server di cloud. Jika Anda adalah pengguna Amazon RDS (Microsoft SQL Server), Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Amazon RDS (Microsoft SQL Server) Anda. Konektor sumber data Amazon Kendra JDBC mendukung Microsoft SQL Server 2019. Anda dapat terhubung Amazon Kendra ke sumber data Amazon RDS (Microsoft SQL Server) menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber data (Amazon KendraAmazon RDSMicrosoft SQL Server), lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-rds-ms-sql-server) + [Prasyarat](#prerequisites-rds-ms-sql-server) + [Instruksi koneksi](#data-source-procedure-rds-ms-sql-server) + [Catatan](#rds-ms-sql-server-notes) ## Fitur yang didukung + Pemetaan bidang + Pemfilteran konteks pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Amazon RDS (Microsoft SQL Server) Anda, buat perubahan ini di Amazon RDS (Microsoft SQL Server) dan AWS akun Anda. **Di Amazon RDS (Microsoft SQL Server), pastikan Anda memiliki:** + Mencatat nama pengguna dan kata sandi database Anda. **penting** Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Menyalin url, port, dan instance host database Anda. + Memeriksa setiap dokumen unik di Amazon RDS (Microsoft SQL Server) dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi Amazon RDS (Microsoft SQL Server) Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasianya. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat menghubungkan sumber data Amazon RDS (Microsoft SQL Server) keAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Amazon RDS (Microsoft SQL Server) Anda harus memberikan rincian kredenal Amazon RDS (Microsoft SQL Server) Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Amazon RDS (Microsoft SQL Server) untuk Amazon Kendra lihat[Prasyarat](#prerequisites-rds-ms-sql-server). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Amazon RDS (Microsoft SQL Server)** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambah sumber data**, pilih **konektor Amazon RDS (Microsoft SQL Server)**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Amazon RDS (Microsoft SQL Server) dengan tag** “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen menggantikan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. Di **Sumber**, masukkan informasi berikut: 1. **Host** — Masukkan nama host database. 1. **Port** — Masukkan port database. 1. **Instance** - Masukkan instance database. 1. **Aktifkan lokasi sertifikat SSL** —Pilih untuk memasukkan Amazon S3 jalur ke file sertifikat SSL Anda. 1. Dalam **Otentikasi** —masukkan informasi berikut: 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal otentikasi Amazon RDS (Microsoft SQL Server) Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra- Amazon RDS (Microsoft SQL Server) -' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **nama pengguna Database**, dan **Kata Sandi** —Masukkan nilai kredensi otentikasi yang Anda salin dari database Anda. 1. Pilih **Simpan**. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Dalam **lingkup Sinkronisasi**, pilih dari opsi berikut: + **Kueri SQL**—Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. **catatan** Jika nama tabel menyertakan karakter khusus (non alfanumerik) dalam nama, Anda harus menggunakan tanda kurung siku di sekitar nama tabel. Sebagai contoh, *select \$1 from [my-database-table]*. + **Kolom kunci primer**—Berikan kunci primer untuk tabel basis data. Detail ini mengidentifikasi tabel di dalam basis data Anda. + **Kolom judul**—Berikan nama kolom judul dokumen di dalam tabel basis data Anda. + **Kolom tubuh** —Berikan nama kolom badan dokumen dalam tabel database Anda. 1. Dalam **Konfigurasi tambahan — *opsional***, pilih dari opsi berikut untuk menyinkronkan konten tertentu alih-alih menyinkronkan semua file: + **Kolom pendeteksi perubahan** —Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendraakan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini. + ** IDsKolom pengguna** —Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. + **Kolom grup**—Masukkan nama kolom yang berisi grup untuk diizinkan mengakses konten. + ** URLsKolom sumber** —Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. + **Kolom stempel waktu** —Masukkan nama kolom yang berisi stempel waktu. Amazon Kendramenggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. + **Kolom zona waktu**—Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. + **Format stempel waktu**—Masukkan nama kolom yang berisi format stempel waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. 1. **Mode sinkronisasi** —Pilih cara Anda ingin memperbarui indeks saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Dalam **jadwal berjalan Sinkronisasi**, untuk **Frekuensi** —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang sumber data default yang dihasilkan— **Dokumen IDs**, **Judul dokumen**, dan **Sumber URLs** —Anda ingin memetakan ke Amazon Kendra indeks. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Amazon RDS (Microsoft SQL Server)** Anda harus menentukan yang berikut menggunakan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API: + **Sumber data** —Tentukan tipe sumber data seperti `JDBC` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Juga tentukan sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **Jenis database** —Anda harus menentukan jenis database sebagai`sqlserver`. + **Kueri SQL** —Tentukan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. **catatan** Jika nama tabel menyertakan karakter khusus (non alfanumerik) dalam nama, Anda harus menggunakan tanda kurung siku di sekitar nama tabel. Sebagai contoh, *select \$1 from [my-database-table]*. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensi otentikasi yang Anda buat di akun (Microsoft SQL Server) AndaAmazon RDS. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "user name": "database user name", "password": "password" } ``` **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **IAMperan** —Tentukan `RoleArn` kapan Anda memanggil `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor (Amazon RDSMicrosoft SQL Server) dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Amazon RDS (Microsoft SQL Server)](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan konten tertentu menggunakan pengguna IDs, grup, sumber, stempel waktu URLs, dan zona waktu. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data (Amazon RDSMicrosoft SQL Server) Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat[Amazon RDS Skema templat (Microsoft SQL Server)](ds-schemas.md#ds-rds-ms-sql-server-schema). ------ ## Catatan + Baris database yang dihapus tidak akan dilacak saat Amazon Kendra memeriksa konten yang diperbarui. + Ukuran nama bidang dan nilai dalam deretan database Anda tidak dapat melebihi 400KB. + Jika Anda memiliki sejumlah besar data dalam sumber data database Anda, dan tidak Amazon Kendra ingin mengindeks semua konten database Anda setelah sinkronisasi pertama, Anda dapat memilih untuk menyinkronkan hanya dokumen baru, dimodifikasi, atau dihapus. + Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Sebagai praktik terbaik, hindari menambahkan tabel dengan data sensitif atau informasi identitas pribadi (PII). # Amazon RDS(MySQL) **catatan** Amazon RDS(MySQL)konektor tetap didukung penuh untuk pelanggan yang sudah ada hingga 31 Mei 2026. Meskipun konektor ini tidak lagi tersedia untuk pengguna baru, pengguna saat ini dapat terus menggunakannya tanpa gangguan. Kami terus mengembangkan portofolio konektor kami untuk menawarkan solusi yang lebih terukur dan dapat disesuaikan. Untuk integrasi masa depan, sebaiknya jelajahi Amazon Kendra Custom Connector Framework [1], yang dirancang untuk mendukung rangkaian kasus penggunaan perusahaan yang lebih luas dengan fleksibilitas yang ditingkatkan. Amazon RDS(Amazon Relational Database Service) adalah layanan web yang memudahkan pengaturan, pengoperasian, dan skala database relasional di AWS Cloud. Jika Anda adalah Amazon RDS pengguna, Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber Amazon RDS(MySQL) data Anda. Konektor sumber Amazon Kendra data mendukung Amazon RDS MySql 5.6, 5.7, dan 8.0. Anda dapat terhubung Amazon Kendra ke sumber Amazon RDS(MySQL) data menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber Amazon Kendra Amazon RDS(MySQL) data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-rds-mysql) + [Prasyarat](#prerequisites-rds-mysql) + [Instruksi koneksi](#data-source-procedure-rds-mysql) + [Catatan](#rds-mysql-notes) ## Fitur yang didukung + Pemetaan bidang + Pemfilteran konteks pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan inkremental + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber Amazon RDS(MySQL) data Anda, buat perubahan ini di akun Amazon RDS(MySQL) dan AWS akun Anda. **DiAmazon RDS(MySQL), pastikan Anda memiliki:** + Mencatat nama pengguna dan kata sandi database Anda. **penting** Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Menyalin url, port, dan instance host database Anda. Anda dapat menemukan informasi ini di Amazon RDS konsol. + Memeriksa setiap dokumen unik di dalam Amazon RDS(MySQL) dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensyal Amazon RDS(MySQL) otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber Amazon RDS(MySQL) data AndaAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber Amazon RDS(MySQL) data Anda, Anda harus memberikan rincian Amazon RDS(MySQL) kredensyal Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Amazon RDS(MySQL) untuk Amazon Kendra lihat[Prasyarat](#prerequisites-rds-mysql). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Amazon RDS(MySQL)** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **Amazon RDS(MySQL)konektor**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **Amazon RDS(MySQL)konektor** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. Di **Sumber**, masukkan informasi berikut: 1. **Host** — Masukkan URL host database, misalnya:`http://instance URL.region.rds.amazonaws.com`. 1. **Port** — Masukkan port database, misalnya,`5432`. 1. **Instance** — Masukkan contoh database, misalnya`postgres`. 1. **Aktifkan lokasi sertifikat SSL** —Pilih untuk memasukkan Amazon S3 jalur ke file sertifikat SSL Anda. 1. Dalam **Otentikasi** —masukkan informasi berikut: 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal Amazon RDS(MySQL) otentikasi Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra- Amazon RDS(MySQL) -' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **nama pengguna Database**, dan **Kata Sandi** —Masukkan nilai kredensi otentikasi yang Anda salin dari database Anda. 1. Pilih **Simpan**. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **IAMperan** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensyal repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Dalam **lingkup Sinkronisasi**, pilih dari opsi berikut: + **Kueri SQL**—Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB Kueri SQL harus kurang dari 32KB dan tidak mengandung semi-titik dua (;). Amazon Kendraakan merayapi semua konten database yang cocok dengan kueri Anda. + **Kolom kunci primer**—Berikan kunci primer untuk tabel basis data. Detail ini mengidentifikasi tabel di dalam basis data Anda. + **Kolom judul**—Berikan nama kolom judul dokumen di dalam tabel basis data Anda. + **Kolom tubuh** —Berikan nama kolom badan dokumen dalam tabel database Anda. 1. Dalam **Konfigurasi tambahan — *opsional***, pilih dari opsi berikut untuk menyinkronkan konten tertentu alih-alih menyinkronkan semua file: + **Kolom pendeteksi perubahan** —Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendraakan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini. + ** IDsKolom pengguna** —Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. + **Kolom grup**—Masukkan nama kolom yang berisi grup untuk diizinkan mengakses konten. + ** URLsKolom sumber** —Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. + **Kolom stempel waktu** —Masukkan nama kolom yang berisi stempel waktu. Amazon Kendramenggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. + **Kolom zona waktu**—Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. + **Format stempel waktu**—Masukkan nama kolom yang berisi format stempel waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. 1. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Dalam **jadwal berjalan Sinkronisasi**, untuk **Frekuensi** —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang sumber data default yang dihasilkan— **Dokumen IDs**, **Judul dokumen**, dan **Sumber URLs** —Anda ingin memetakan ke Amazon Kendra indeks. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Amazon RDS(MySQL)** Anda harus menentukan yang berikut menggunakan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API: + **Sumber data** —Tentukan tipe sumber data seperti `JDBC` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **Jenis database** —Anda harus menentukan jenis database sebagai`mySql`. + **Kueri SQL** —Tentukan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensi otentikasi yang Anda buat di akun Anda. Amazon RDS(MySQL) Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "user name": "database user name", "password": "password" } ``` **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk Amazon RDS(MySQL) konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber Amazon RDS(MySQL) data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan konten tertentu menggunakan pengguna IDs, grup, sumber, stempel waktu URLs, dan zona waktu. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber Amazon RDS(MySQL) data Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat[Amazon RDS Skema templat (MySQL)](ds-schemas.md#ds-rds-mysql-schema). ------ ## Catatan + Baris database yang dihapus tidak akan dilacak saat Amazon Kendra memeriksa konten yang diperbarui. + Ukuran nama bidang dan nilai dalam deretan database Anda tidak dapat melebihi 400KB. + Jika Anda memiliki sejumlah besar data dalam sumber data database Anda, dan tidak Amazon Kendra ingin mengindeks semua konten database Anda setelah sinkronisasi pertama, Anda dapat memilih untuk menyinkronkan hanya dokumen baru, dimodifikasi, atau dihapus. + Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Sebagai praktik terbaik, hindari menambahkan tabel dengan data sensitif atau informasi identitas pribadi (PII). # Amazon RDS(Oracle) **catatan** Amazon RDS(Oracle)konektor tetap didukung penuh untuk pelanggan yang sudah ada hingga 31 Mei 2026. Meskipun konektor ini tidak lagi tersedia untuk pengguna baru, pengguna saat ini dapat terus menggunakannya tanpa gangguan. Kami terus mengembangkan portofolio konektor kami untuk menawarkan solusi yang lebih terukur dan dapat disesuaikan. Untuk integrasi masa depan, sebaiknya jelajahi Amazon Kendra Custom Connector Framework [1], yang dirancang untuk mendukung rangkaian kasus penggunaan perusahaan yang lebih luas dengan fleksibilitas yang ditingkatkan. Amazon RDS(Amazon Relational Database Service) adalah layanan web yang membuatnya lebih mudah untuk mengatur, mengoperasikan, dan menskalakan database relasional di AWS Cloud. Jika Anda adalah Amazon RDS(Oracle) pengguna, Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber Amazon RDS(Oracle) data Anda. Konektor sumber Amazon Kendra Amazon RDS(Oracle) data mendukung Amazon RDS Oracle Database 21c, Oracle Database 19c, Oracle Database 12c. Anda dapat terhubung Amazon Kendra ke sumber Amazon RDS(Oracle) data menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber Amazon Kendra Amazon RDS(Oracle) data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-rds-oracle) + [Prasyarat](#prerequisites-rds-oracle) + [Instruksi koneksi](#data-source-procedure-rds-oracle) + [Catatan](#rds-oracle-notes) ## Fitur yang didukung + Pemetaan bidang + Pemfilteran konteks pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber Amazon RDS(Oracle) data Anda, buat perubahan ini di akun Amazon RDS(Oracle) dan AWS akun Anda. **DiAmazon RDS(Oracle), pastikan Anda memiliki:** + Mencatat nama pengguna dan kata sandi database Anda. **penting** Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Menyalin url, port, dan instance host database Anda. + Memeriksa setiap dokumen unik di dalam Amazon RDS(Oracle) dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensyal Amazon RDS(Oracle) otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber Amazon RDS(Oracle) data AndaAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber Amazon RDS(Oracle) data Anda, Anda harus memberikan rincian Amazon RDS(Oracle) kredensyal Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Amazon RDS(Oracle) untuk Amazon Kendra lihat[Prasyarat](#prerequisites-rds-oracle). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Amazon RDS(Oracle)** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **Amazon RDS(Oracle)konektor**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **Amazon RDS(Oracle)konektor** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. Di **Sumber**, masukkan informasi berikut: 1. **Host** — Masukkan nama host database. 1. **Port** — Masukkan port database. 1. **Instance** - Masukkan instance database. 1. **Aktifkan lokasi sertifikat SSL** —Pilih untuk memasukkan Amazon S3 jalur ke file sertifikat SSL Anda. 1. Dalam **Otentikasi** —masukkan informasi berikut: 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal Amazon RDS(Oracle) otentikasi Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra- Amazon RDS(Oracle) -' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **nama pengguna Database**, dan **Kata Sandi** —Masukkan nilai kredensi otentikasi yang Anda salin dari database Anda. 1. Pilih **Simpan**. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Dalam **lingkup Sinkronisasi**, pilih dari opsi berikut: + **Kueri SQL**—Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. + **Kolom kunci primer**—Berikan kunci primer untuk tabel basis data. Detail ini mengidentifikasi tabel di dalam basis data Anda. + **Kolom judul**—Berikan nama kolom judul dokumen di dalam tabel basis data Anda. + **Kolom tubuh** —Berikan nama kolom badan dokumen dalam tabel database Anda. 1. Dalam **Konfigurasi tambahan — *opsional***, pilih dari opsi berikut untuk menyinkronkan konten tertentu alih-alih menyinkronkan semua file: + **Kolom pendeteksi perubahan** —Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendraakan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini. + ** IDsKolom pengguna** —Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. + **Kolom grup**—Masukkan nama kolom yang berisi grup untuk diizinkan mengakses konten. + ** URLsKolom sumber** —Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. + **Kolom stempel waktu** —Masukkan nama kolom yang berisi stempel waktu. Amazon Kendramenggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. + **Kolom zona waktu**—Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. + **Format stempel waktu**—Masukkan nama kolom yang berisi format stempel waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. 1. **Mode sinkronisasi** —Pilih cara Anda ingin memperbarui indeks saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Dalam **jadwal berjalan Sinkronisasi**, untuk **Frekuensi** —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang sumber data default yang dihasilkan— **Dokumen IDs**, **Judul dokumen**, dan **Sumber URLs** —Anda ingin memetakan ke Amazon Kendra indeks. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Amazon RDS(Oracle)** Anda harus menentukan yang berikut menggunakan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API: + **Sumber data** —Tentukan tipe sumber data seperti `JDBC` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **Jenis database** —Anda harus menentukan jenis database sebagai`oracle`. + **Kueri SQL** —Tentukan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi yang Anda buat di akun Anda. Amazon RDS(Oracle) Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "user name": "database user name", "password": "password" } ``` **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk Amazon RDS(Oracle) konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber Amazon RDS(Oracle) data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan konten tertentu menggunakan pengguna IDs, grup, sumber, stempel waktu URLs, dan zona waktu. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber Amazon RDS(Oracle) data Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat[Amazon RDS Skema templat (Oracle)](ds-schemas.md#ds-rds-oracle-schema). ------ ## Catatan + Baris database yang dihapus tidak akan dilacak saat Amazon Kendra memeriksa konten yang diperbarui. + Ukuran nama bidang dan nilai dalam deretan database Anda tidak dapat melebihi 400KB. + Jika Anda memiliki sejumlah besar data dalam sumber data database Anda, dan tidak Amazon Kendra ingin mengindeks semua konten database Anda setelah sinkronisasi pertama, Anda dapat memilih untuk menyinkronkan hanya dokumen baru, dimodifikasi, atau dihapus. + Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Sebagai praktik terbaik, hindari menambahkan tabel dengan data sensitif atau informasi identitas pribadi (PII). # Amazon RDS(PostgreSQL) **catatan** Amazon RDS(PostgreSQL)konektor tetap didukung penuh untuk pelanggan yang sudah ada hingga 31 Mei 2026. Meskipun konektor ini tidak lagi tersedia untuk pengguna baru, pengguna saat ini dapat terus menggunakannya tanpa gangguan. Kami terus mengembangkan portofolio konektor kami untuk menawarkan solusi yang lebih terukur dan dapat disesuaikan. Untuk integrasi masa depan, sebaiknya jelajahi Amazon Kendra Custom Connector Framework [1], yang dirancang untuk mendukung rangkaian kasus penggunaan perusahaan yang lebih luas dengan fleksibilitas yang ditingkatkan. Amazon RDSadalah layanan web yang membuatnya lebih mudah untuk mengatur, mengoperasikan, dan menskalakan database relasional di AWS Cloud. Jika Anda adalah Amazon RDS pengguna, Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber Amazon RDS(PostgreSQL) data Anda. Konektor sumber Amazon Kendra Amazon RDS(PostgreSQL) data mendukung PostgreSQL 9.6. Anda dapat terhubung Amazon Kendra ke sumber Amazon RDS(PostgreSQL) data menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber Amazon Kendra Amazon RDS(PostgreSQL) data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-rds-postgresql) + [Prasyarat](#prerequisites-rds-postgresql) + [Instruksi koneksi](#data-source-procedure-rds-postgresql) + [Catatan](#rds-postgresql-notes) ## Fitur yang didukung + Pemetaan bidang + Pemfilteran konteks pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan inkremental + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber Amazon RDS(PostgreSQL) data Anda, buat perubahan ini di akun Amazon RDS(PostgreSQL) dan AWS akun Anda. **DiAmazon RDS(PostgreSQL), pastikan Anda memiliki:** + Mencatat nama pengguna dan kata sandi database Anda. **penting** Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Menyalin url, port, dan instance host database Anda. Anda dapat menemukan informasi ini di Amazon RDS konsol. + Memeriksa setiap dokumen unik di dalam Amazon RDS(PostgreSQL) dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensyal Amazon RDS(PostgreSQL) otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber Amazon RDS(PostgreSQL) data AndaAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber Amazon RDS(PostgreSQL) data Anda, Anda harus memberikan rincian Amazon RDS(PostgreSQL) kredensyal Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Amazon RDS(PostgreSQL) untuk Amazon Kendra lihat[Prasyarat](#prerequisites-rds-postgresql). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Amazon RDS(PostgreSQL)** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **Amazon RDS(PostgreSQL)konektor**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **Amazon RDS(PostgreSQL)konektor** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. Di **Sumber**, masukkan informasi berikut: 1. **Host** — Masukkan URL host database, misalnya:`http://instance URL.region.rds.amazonaws.com`. 1. **Port** — Masukkan port database, misalnya,`5432`. 1. **Instance** — Masukkan contoh database, misalnya`postgres`. 1. **Aktifkan lokasi sertifikat SSL** —Pilih untuk memasukkan Amazon S3 jalur ke file sertifikat SSL Anda. 1. Dalam **Otentikasi** —masukkan informasi berikut: 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal Amazon RDS(PostgreSQL) otentikasi Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra- Amazon RDS(PostgreSQL) -' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **nama pengguna Database**, dan **Kata Sandi** —Masukkan nilai kredensi otentikasi yang Anda salin dari database Anda. 1. Pilih **Simpan**. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **IAMperan** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensyal repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Dalam **lingkup Sinkronisasi**, pilih dari opsi berikut: + **Kueri SQL**—Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB Kueri SQL harus kurang dari 32KB dan tidak mengandung semi-titik dua (;). Amazon Kendraakan merayapi semua konten database yang cocok dengan kueri Anda. + **Kolom kunci primer**—Berikan kunci primer untuk tabel basis data. Detail ini mengidentifikasi tabel di dalam basis data Anda. + **Kolom judul**—Berikan nama kolom judul dokumen di dalam tabel basis data Anda. + **Kolom tubuh** —Berikan nama kolom badan dokumen dalam tabel database Anda. 1. Dalam **Konfigurasi tambahan — *opsional***, pilih dari opsi berikut untuk menyinkronkan konten tertentu alih-alih menyinkronkan semua file: + **Kolom pendeteksi perubahan** —Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendraakan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini. + ** IDsKolom pengguna** —Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. + **Kolom grup**—Masukkan nama kolom yang berisi grup untuk diizinkan mengakses konten. + ** URLsKolom sumber** —Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. + **Kolom stempel waktu** —Masukkan nama kolom yang berisi stempel waktu. Amazon Kendramenggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. + **Kolom zona waktu**—Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. + **Format stempel waktu**—Masukkan nama kolom yang berisi format stempel waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. 1. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Dalam **jadwal berjalan Sinkronisasi**, untuk **Frekuensi** —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang sumber data default yang dihasilkan— **Dokumen IDs**, **Judul dokumen**, dan **Sumber URLs** —Anda ingin memetakan ke Amazon Kendra indeks. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Amazon RDS(PostgreSQL)** Anda harus menentukan yang berikut menggunakan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API: + **Sumber data** —Tentukan tipe sumber data seperti `JDBC` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **Jenis database** —Anda harus menentukan jenis database sebagai`postgresql`. + **Kueri SQL** —Tentukan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensi otentikasi yang Anda buat di akun Anda. Amazon RDS(PostgreSQL) Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "user name": "database user name", "password": "password" } ``` **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk Amazon RDS(PostgreSQL) konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber Amazon RDS(PostgreSQL) data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan konten tertentu menggunakan pengguna IDs, grup, sumber, stempel waktu URLs, dan zona waktu. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber Amazon RDS(PostgreSQL) data Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat[Amazon RDS (PostgreSQL) skema templat](ds-schemas.md#ds-rds-postgresql-schema). ------ ## Catatan + Baris database yang dihapus tidak akan dilacak saat Amazon Kendra memeriksa konten yang diperbarui. + Ukuran nama bidang dan nilai dalam deretan database Anda tidak dapat melebihi 400KB. + Jika Anda memiliki sejumlah besar data dalam sumber data database Anda, dan tidak Amazon Kendra ingin mengindeks semua konten database Anda setelah sinkronisasi pertama, Anda dapat memilih untuk menyinkronkan hanya dokumen baru, dimodifikasi, atau dihapus. + Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Sebagai praktik terbaik, hindari menambahkan tabel dengan data sensitif atau informasi identitas pribadi (PII). # Amazon S3 Amazon S3 adalah layanan penyimpanan objek yang menyimpan data sebagai objek di dalam ember. Anda dapat menggunakan Amazon Kendra untuk mengindeks repositori Amazon S3 bucket dokumen Anda. **Awas** Amazon Kendra tidak menggunakan kebijakan bucket yang memberikan izin kepada Amazon Kendra kepala sekolah untuk berinteraksi dengan bucket S3. Sebaliknya, ia menggunakan IAM peran. Pastikan itu Amazon Kendra tidak disertakan sebagai anggota tepercaya dalam kebijakan bucket Anda untuk menghindari masalah keamanan data dalam pemberian izin secara tidak sengaja kepada prinsipal arbitrer. Namun, Anda dapat menambahkan kebijakan bucket untuk menggunakan Amazon S3 bucket di berbagai akun. Untuk informasi selengkapnya, lihat [Kebijakan yang akan digunakan Amazon S3 di seluruh akun](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds-s3-cross-accounts) (dalam tab IAM peran S3, di bawah **IAM peran untuk sumber data**). Untuk informasi tentang IAM peran untuk sumber data S3, lihat [IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds-s3). **catatan** Amazon Kendra sekarang mendukung Amazon S3 konektor yang ditingkatkan. Konsol telah ditingkatkan secara otomatis untuk Anda. Konektor baru apa pun yang Anda buat di konsol akan menggunakan arsitektur yang ditingkatkan. Jika Anda menggunakan API, Anda sekarang harus menggunakan [https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objek alih-alih `S3DataSourceConfiguration` objek untuk mengonfigurasi konektor Anda. Konektor yang dikonfigurasi menggunakan konsol lama dan arsitektur API akan terus berfungsi seperti yang dikonfigurasi. Namun, Anda tidak akan dapat mengedit atau memperbaruinya. Jika Anda ingin mengedit atau memperbarui konfigurasi konektor Anda, Anda harus membuat konektor baru. Kami merekomendasikan untuk memigrasikan alur kerja konektor Anda ke versi yang ditingkatkan. Support untuk konektor yang dikonfigurasi menggunakan arsitektur lama dijadwalkan berakhir pada Juni 2024. Anda dapat terhubung ke sumber Amazon S3 data menggunakan [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/) atau [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. **catatan** Untuk membuat laporan status sinkronisasi untuk sumber Amazon S3 data Anda, lihat [Memecahkan masalah sumber data](https://docs.aws.amazon.com/kendra/latest/dg/troubleshooting-data-sources.html#troubleshooting-data-sources-sync-status-manifest). Untuk memecahkan masalah konektor sumber data Amazon Kendra S3 Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-s3) + [Prasyarat](#prerequisites-s3) + [Instruksi koneksi](#data-source-procedure-s3) + [Membuat sumber Amazon S3 data](create-ds-s3.md) + [Amazon S3 metadata dokumen](s3-metadata.md) + [Kontrol akses untuk sumber Amazon S3 data](s3-acl.md) + [Menggunakan Amazon VPC dengan sumber Amazon S3 data](s3-vpc-example-1.md) ## Fitur yang didukung + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data S3 Anda, buat perubahan ini di S3 dan AWS akun Anda. **Di S3, pastikan Anda memiliki:** + Menyalin nama Amazon S3 ember Anda. **catatan** Bucket Anda harus berada di wilayah yang sama dengan Amazon Kendra indeks Anda dan indeks Anda harus memiliki izin untuk mengakses bucket yang berisi dokumen Anda. + Memeriksa setiap dokumen unik di S3 dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di AWS akun Anda, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebut IAM . Jika Anda tidak memiliki IAM peran yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran baru saat Anda menghubungkan sumber data S3. Amazon Kendra Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran yang ada dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data S3 Anda, Anda harus memberikan rincian yang diperlukan dari sumber data S3 Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi S3 untuk Amazon Kendra, lihat[Prasyarat](#prerequisites-s3). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Amazon S3 ** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **konektor S3**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor S3 dengan tag** “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi opsional berikut: 1. **IAM peran** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAM peran yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Untuk **lokasi sumber data** —Tentukan jalur ke Amazon S3 bucket tempat data Anda disimpan. Pilih **Browse S3** untuk memilih bucket S3 Anda. 1. Untuk **Ukuran file maksimum** —Tentukan batas dalam MB untuk hanya merayapi file di bawah batas ini. Ukuran file maksimum yang Amazon Kendra dapat memungkinkan adalah 50 MB. 1. Untuk (Opsional) **Lokasi folder awalan file metadata** —Tentukan jalur ke folder tempat metadata dokumen Anda fields/attributes dan lainnya disimpan. Pilih **Browse S3** untuk menemukan folder metadata Anda. 1. Untuk (Opsional) **Lokasi file konfigurasi daftar kontrol akses** —Tentukan jalur ke file yang berisi struktur JSON pengguna Anda dan aksesnya ke dokumen. Pilih **Jelajahi S3** untuk menemukan file ACL Anda. 1. (Opsional) **Pilih kunci dekripsi —Pilih untuk menggunakan kunci** dekripsi. Anda dapat memilih untuk menggunakan AWS KMS kunci yang ada. 1. Untuk (Opsional) **Konfigurasi tambahan** —Tambahkan pola untuk menyertakan atau mengecualikan file tertentu. Semua jalur relatif terhadap bucket S3 lokasi sumber data. 1. **Mode sinkronisasi** —Pilih cara Anda ingin memperbarui indeks saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi opsional berikut: 1. **Pemetaan bidang default** —Pilih dari bidang sumber data default Amazon Kendra yang dihasilkan yang ingin Anda petakan ke indeks Anda. 1. **Tambahkan bidang** —Pilih untuk menambahkan bidang sumber data khusus untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Amazon S3** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) menggunakan API. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `S3` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **BucketName**—Nama ember yang berisi dokumen. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **IAM peran** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor S3 dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAM peran untuk sumber data S3](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan nama file tertentu, jenis file, jalur file. Anda menggunakan pola glob (pola yang dapat memperluas pola wildcard ke dalam daftar nama jalur yang cocok dengan pola yang diberikan). Sebagai contoh, lihat [Penggunaan Kecualikan dan Sertakan Filter](https://docs.aws.amazon.com/cli/latest/reference/s3/#use-of-exclude-and-include-filters) di Referensi Perintah AWS CLI. + **Metadata dokumen dan konfigurasi kontrol akses** —Tambahkan metadata dokumen dan file kontrol akses yang berisi informasi seperti URI sumber, pembuat dokumen, atau atribut/bidang dokumen kustom, dan pengguna Anda serta dokumen mana yang dapat mereka akses. Setiap file metadata berisi metadata tentang satu dokumen. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data S3 Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat [skema S3 template](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-s3-schema). ------ ### Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data S3 Anda, lihat: + [Cari jawaban secara akurat menggunakan Konektor Amazon Kendra S3 dengan dukungan VPC](https://aws.amazon.com/blogs/machine-learning/search-for-answers-accurately-using-amazon-kendra-s3-connector-with-vpc-support/) # Membuat sumber Amazon S3 data Contoh berikut menunjukkan pembuatan sumber Amazon S3 data. Contoh mengasumsikan bahwa Anda telah membuat indeks dan IAM peran dengan izin untuk membaca data dari indeks. Untuk informasi selengkapnya tentang IAM peran, lihat [peran IAM akses](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Untuk informasi selengkapnya tentang membuat indeks, lihat [Membuat indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html). ------ #### [ CLI ] ``` aws kendra create-data-source \ --index-id index ID \ --name example-data-source \ --type S3 \ --configuration '{"S3Configuration":{"BucketName":"bucket name"}}' --role-arn 'arn:aws:iam::account id:role:/role name ``` ------ #### [ Python ] Cuplikan kode Python berikut menciptakan sumber data. Amazon S3 Untuk contoh lengkap, lihat [Memulai (AWS SDK untuk Python (Boto3))](gs-python.md). ``` print("Create an Amazon S3 data source.") # Provide a name for the data source name = "getting-started-data-source" # Provide an optional description for the data source description = "Getting started data source." # Provide the IAM role ARN required for data sources role_arn = "arn:aws:iam::${accountID}:role/${roleName}" # Provide the data soource connection information s3_bucket_name = "S3-bucket-name" type = "S3" # Configure the data source configuration = {"S3DataSourceConfiguration": { "BucketName": s3_bucket_name } } data_source_response = kendra.create_data_source( Configuration = configuration, Name = name, Description = description, RoleArn = role_arn, Type = type, IndexId = index_id ) ``` ------ Proses pembuatan sumber data dapat memakan waktu lama. Anda dapat memantau kemajuan dengan menggunakan [DescribeDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DescribeDataSource.html)API. Jika status sumber data adalah `ACTIVE`, sumber data siap digunakan. Contoh berikut menunjukkan proses mendapatkan status sumber data. ------ #### [ CLI ] ``` aws kendra describe-data-source \ --index-id index ID \ --id data source ID ``` ------ #### [ Python ] Cuplikan kode Python berikut ini mendapatkan informasi tentang sumber data S3. Untuk contoh lengkap, lihat [Memulai (AWS SDK untuk Python (Boto3))](gs-python.md). ``` print("Wait for Amazon Kendra to create the data source.") while True: data_source_description = kendra.describe_data_source( Id = "data-source-id", IndexId = "index-id" ) status = data_source_description["Status"] print(" Creating data source. Status: "+status) time.sleep(60) if status != "CREATING": break ``` ------ Sumber data ini tidak memiliki jadwal, sehingga tidak berjalan secara otomatis. Untuk mengindeks sumber data, Anda memanggil [StartDataSourceSyncJob](https://docs.aws.amazon.com/kendra/latest/APIReference/API_StartDataSourceSyncJob.html)untuk menyinkronkan indeks dengan sumber data. Contoh berikut menunjukkan proses sinkronisasi sumber data. ------ #### [ CLI ] ``` aws kendra start-data-source-sync-job \ --index-id index ID \ --id data source ID ``` ------ #### [ Python ] Cuplikan kode Python berikut menyinkronkan sumber data. Amazon S3 Untuk contoh lengkap, lihat [Memulai (AWS SDK untuk Python (Boto3))](gs-python.md). ``` print("Synchronize the data source.") sync_response = kendra.start_data_source_sync_job( Id = "data-source-id", IndexId = "index-id" ) ``` ------ # Amazon S3 metadata dokumen Anda dapat menambahkan metadata, informasi tambahan tentang dokumen, ke dokumen dalam Amazon S3 bucket menggunakan file metadata. Setiap file metadata terkait dengan dokumen yang diindeks. File metadata harus disimpan dalam bucket yang sama dengan file yang diindeks. Anda dapat menentukan lokasi dalam bucket untuk file metadata menggunakan konsol atau `S3Prefix` bidang `DocumentsMetadataConfiguration` parameter saat membuat sumber Amazon S3 data. Jika Anda tidak menentukan Amazon S3 awalan, file metadata Anda harus disimpan di lokasi yang sama dengan dokumen yang diindeks. Jika Anda menentukan Amazon S3 awalan untuk file metadata Anda, mereka berada dalam struktur direktori paralel dengan dokumen yang diindeks. Amazon Kendra terlihat hanya di direktori yang ditentukan untuk metadata Anda. Jika metadata tidak terbaca, periksa apakah lokasi direktori sesuai dengan lokasi metadata. Contoh berikut menunjukkan bagaimana lokasi dokumen yang diindeks dipetakan ke lokasi file metadata. Perhatikan bahwa Amazon S3 kunci dokumen ditambahkan ke Amazon S3 awalan metadata dan kemudian diakhiran `.metadata.json` untuk membentuk jalur file metadata. Amazon S3 Amazon S3 Kunci gabungan, dengan Amazon S3 awalan dan `.metadata.json` akhiran metadata harus tidak lebih dari total 1024 karakter. Disarankan agar Anda menyimpan Amazon S3 kunci Anda di bawah 1000 karakter untuk memperhitungkan karakter tambahan saat menggabungkan kunci Anda dengan awalan dan akhiran. ``` Bucket name: s3://bucketName Document path: documents Metadata path: none File mapping s3://bucketName/documents/file.txt -> s3://bucketName/documents/file.txt.metadata.json ``` ``` Bucket name: s3://bucketName Document path: documents/legal Metadata path: metadata File mapping s3://bucketName/documents/legal/file.txt -> s3://bucketName/metadata/documents/legal/file.txt.metadata.json ``` Metadata dokumen ditentukan dalam file JSON. File harus berupa file teks UTF-8 tanpa penanda BOM. Nama file dari file JSON harus`..metadata.json`. Dalam contoh ini, “dokumen” adalah nama dokumen yang digunakan metadata dan “ekstensi” adalah ekstensi file untuk dokumen tersebut. ID dokumen harus unik di`..metadata.json`. Isi dari file JSON mengikuti templat berikut ini. Semua attributes/fields bersifat opsional, jadi tidak perlu menyertakan semua atribut. Anda harus memberikan nilai untuk setiap atribut yang ingin Anda sertakan; nilainya tidak boleh kosong. Jika Anda tidak menentukan`_source_uri`, maka tautan yang dikembalikan oleh Amazon Kendra dalam hasil pencarian mengarah ke Amazon S3 bucket yang berisi dokumen. `DocumentId`dipetakan ke bidang `s3_document_id` dan merupakan jalur absolut ke dokumen di S3. ``` { "DocumentId": "S3 document ID, the S3 path to doc", "Attributes": { "_category": "document category", "_created_at": "ISO 8601 encoded string", "_last_updated_at": "ISO 8601 encoded string", "_source_uri": "document URI", "_version": "file version", "_view_count": number of times document has been viewed, "custom attribute key": "custom attribute value", additional custom attributes }, "AccessControlList": [ { "Name": "user name", "Type": "GROUP | USER", "Access": "ALLOW | DENY" } ], "Title": "document title", "ContentType": "For example HTML | PDF. For supported content types, see [Types of documents](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html)." } ``` Bidang metadata `_created_at` dan `_last_updated_at` adalah tanggal yang dikodekan dengan ISO 8601. Misalnya, 2012-03-25T 12:30:10 \$101:00 adalah format tanggal-waktu ISO 8601 untuk 25 Maret 2012, pukul 12:30 (ditambah 10 detik) di zona waktu Eropa Tengah. Anda dapat menambahkan informasi ke bidang `Attributes` tentang dokumen yang digunakan untuk memfilter kueri atau respons kueri grup. Untuk informasi selengkapnya, lihat [Membuat bidang dokumen kustom](custom-attributes.md). Anda dapat menggunakan `AccessControlList` bidang untuk memfilter respons dari kueri. Dengan cara ini, hanya pengguna dan grup tertentu yang memiliki akses ke dokumen. Untuk informasi selengkapnya, lihat [Penyaringan pada konteks pengguna](user-context-filter.md). # Kontrol akses untuk sumber Amazon S3 data Anda dapat mengontrol akses ke dokumen dalam sumber Amazon S3 data menggunakan file konfigurasi. Anda menentukan file di konsol atau sebagai `AccessControlListConfiguration` parameter saat Anda memanggil [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html)atau [UpdateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateDataSource.html)API. File konfigurasi berisi struktur JSON yang mengidentifikasi prefiks S3 dan mencantumkan pengaturan akses untuk prefiks. Prefiks dapat berupa jalur, atau file individual. Jika prefiks berupa jalur, pengaturan akses berlaku untuk semua file di jalur tersebut. Ada jumlah maksimum awalan S3 dalam file konfigurasi JSON dan ukuran file maksimum default. Untuk informasi selengkapnya, lihat [Kuota untuk Amazon Kendra](quotas.md) Anda dapat menentukan pengguna dan grup dalam pengaturan akses. Saat melakukan kueri indeks, Anda menentukan informasi pengguna dan grup. Untuk informasi selengkapnya, lihat [Pemfilteran berdasarkan atribut](user-context-filter.md#context-filter-attribute). Struktur JSON untuk file konfigurasi harus dalam format berikut: ``` [ { "keyPrefix": "s3://BUCKETNAME/prefix1/", "aclEntries": [ { "Name": "user1", "Type": "USER", "Access": "ALLOW" }, { "Name": "group1", "Type": "GROUP", "Access": "DENY" } ] }, { "keyPrefix": "s3://prefix2", "aclEntries": [ { "Name": "user2", "Type": "USER", "Access": "ALLOW" }, { "Name": "user1", "Type": "USER", "Access": "DENY" }, { "Name": "group1", "Type": "GROUP", "Access": "DENY" } ] } ] ``` # Menggunakan Amazon VPC dengan sumber Amazon S3 data Topik ini memberikan step-by-step contoh yang menunjukkan cara menyambung ke bucket Amazon S3 dengan menggunakan konektor Amazon S3 melalui Amazon VPC. Contohnya mengasumsikan bahwa Anda memulai dengan bucket S3 yang ada. Kami menyarankan Anda mengunggah hanya beberapa dokumen ke bucket S3 Anda untuk menguji contoh. Anda dapat terhubung Amazon Kendra ke Amazon S3 ember Anda melalui Amazon VPC. Untuk melakukannya, Anda harus menentukan Amazon VPC subnet dan grup Amazon VPC keamanan saat membuat konektor sumber Amazon S3 data Anda. **penting** Agar Amazon Kendra Amazon S3 konektor dapat mengakses Amazon S3 bucket Anda, pastikan Anda telah menetapkan Amazon S3 titik akhir ke virtual private cloud (VPC) Anda. Amazon Kendra Untuk menyinkronkan dokumen dari Amazon S3 bucket Anda Amazon VPC, Anda harus menyelesaikan langkah-langkah berikut: + Siapkan Amazon S3 titik akhir untuk Amazon VPC. *Untuk informasi selengkapnya tentang cara menyiapkan Amazon S3 titik akhir, lihat [titik akhir Gateway Amazon S3](https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-s3.html) di AWS PrivateLink Panduan.* + (Opsional) Memeriksa kebijakan Amazon S3 bucket Anda untuk memastikan Amazon S3 bucket dapat diakses dari virtual private cloud (VPC) yang Anda tetapkan. Amazon Kendra*Untuk informasi selengkapnya, lihat [Mengontrol akses dari titik akhir VPC dengan kebijakan bucket di Panduan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies-vpc-endpoint.html) Pengguna Amazon S3* **Topics** + [Langkah 1: Konfigurasikan Amazon VPC](#s3-configure-vpc) + [(Opsional) Langkah 2: Konfigurasikan kebijakan Amazon S3 bucket](#s3-configure-bucket-policy) + [Langkah 3: Buat konektor sumber Amazon S3 data uji](#s3-connect-vpc) ## Langkah 1: Konfigurasikan Amazon VPC Buat jaringan VPC termasuk subnet pribadi dengan titik akhir Amazon S3 gateway dan grup keamanan untuk Amazon Kendra digunakan nanti. **Untuk mengonfigurasi VPC dengan subnet pribadi, titik akhir S3, dan grup keamanan** 1. Masuk ke Konsol Manajemen AWS dan buka Amazon VPC konsol di[https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/). 1. **Buat VPC dengan subnet pribadi dan titik akhir S3 untuk digunakan: Amazon Kendra ** Dari panel navigasi, pilih **Your VPCs**, lalu pilih **Create VPC**. 1. **Agar Sumber Daya dapat dibuat**, pilih **VPC dan lainnya**. 1. Untuk **tag Nama**, aktifkan **Auto-generate**, lalu masukkan**kendra-s3-example**. 1. Untuk **blokIPv4 / IPv6 CIDR**, pertahankan nilai default. 1. Untuk **Jumlah Availability Zones (AZs)**, pilih **nomor 1**. 1. Pilih **Sesuaikan AZs**, lalu pilih Availability Zone dari daftar **zona ketersediaan pertama**. Amazon Kendra hanya mendukung satu set Availability Zone tertentu. 1. Untuk **Jumlah subnet publik**, pilih **nomor 0**. 1. Untuk **Jumlah subnet pribadi**, pilih **nomor 1**. 1. **Untuk **gateway NAT**, pilih None.** 1. **Untuk **titik akhir VPC**, pilih gateway.Amazon S3 ** . 1. Biarkan sisa nilai pada pengaturan default mereka. 1. Pilih **Buat VPC**. Tunggu hingga alur kerja **Create VPC selesai**. Kemudian, pilih **Lihat VPC untuk memeriksa **VPC**** yang baru saja Anda buat. Anda sekarang telah membuat jaringan VPC dengan subnet pribadi, yang tidak memiliki akses ke internet publik. 1. **Salin ID titik akhir VPC Anda dari titik akhir Amazon S3 Anda:** 1. Dari panel navigasi, pilih **Titik akhir**. 1. Dalam daftar **Endpoints, temukan endpoint** Amazon S3 `kendra-s3-example-vpce-s3` yang baru saja Anda buat bersama dengan VPC Anda. 1. Catat ID titik **akhir VPC**. Anda sekarang telah membuat titik akhir gateway Amazon S3 untuk mengakses bucket Amazon S3 Anda melalui subnet. 1. **Buat **Grup Keamanan** Amazon Kendra untuk digunakan:** 1. Dari panel navigasi, pilih **Grup Keamanan**, lalu pilih **Buat grup keamanan**. 1. Untuk **Nama grup keamanan**, masukkan **s3-data-source-security-group**. 1. Pilih VPC Anda dari daftar. **Amazon VPC** 1. Biarkan **aturan masuk dan aturan** **keluar** sebagai default. 1. Pilih **Buat grup keamanan**. Anda sekarang telah membuat grup keamanan VPC. Anda menetapkan subnet dan grup keamanan yang Anda buat ke konektor sumber data Amazon S3 selama proses konfigurasi konektor. Amazon Kendra ## (Opsional) Langkah 2: Konfigurasikan kebijakan Amazon S3 bucket Pada langkah opsional ini, pelajari cara mengonfigurasi kebijakan bucket Amazon S3 sehingga bucket Amazon S3 Anda hanya dapat diakses dari VPC yang Anda tetapkan. Amazon Kendra Amazon Kendra menggunakan peran IAM untuk mengakses bucket Amazon S3 Anda dan tidak mengharuskan Anda mengonfigurasi kebijakan bucket Amazon S3. Namun, Anda mungkin merasa berguna untuk membuat kebijakan bucket jika ingin mengonfigurasi Amazon S3 konektor menggunakan bucket Amazon S3 yang memiliki kebijakan yang membatasi aksesnya dari internet publik. **Untuk mengonfigurasi kebijakan Amazon S3 bucket** 1. Buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 1. Dari panel navigasi, pilih **Bucket**. 1. Pilih nama bucket Amazon S3 yang ingin Anda sinkronkan. Amazon Kendra 1. Pilih tab **Izin**, gulir ke bawah ke **kebijakan Bucket**, lalu klik **Edit**. 1. Tambahkan atau ubah kebijakan bucket Anda untuk mengizinkan akses hanya dari titik akhir VPC yang Anda buat. Berikut ini adalah contoh kebijakan bucket. Ganti *`bucket-name`* dan *`vpce-id`* dengan nama bucket Amazon S3 Anda dan ID titik akhir Amazon S3 yang Anda catat sebelumnya. 1. Pilih **Simpan perubahan**. Bucket S3 Anda sekarang hanya dapat diakses dari VPC tertentu yang Anda buat. ## Langkah 3: Buat konektor sumber Amazon S3 data uji Untuk menguji Amazon VPC konfigurasi Anda, buat Amazon S3 konektor. Kemudian, konfigurasikan dengan VPC yang Anda buat dengan mengikuti langkah-langkah yang diuraikan. [Amazon S3](https://docs.aws.amazon.com/kendra/latest/dg/data-source-s3.html) Untuk nilai Amazon VPC konfigurasi, pilih nilai yang Anda buat selama contoh ini: + **Amazon VPC(VPC**) — `kendra-s3-example-vpc` + **Subnet** — `kendra-s3-example-subnet-private1-[availability zone]` + **Kelompok keamanan** - `s3-data-source-security-group` Tunggu konektor Anda selesai dibuat. Setelah Amazon S3 konektor dibuat, pilih **Sinkronkan sekarang** untuk memulai sinkronisasi. Mungkin perlu beberapa menit hingga beberapa jam untuk menyelesaikan sinkronisasi, tergantung pada berapa banyak dokumen yang ada di Amazon S3 ember Anda. Untuk menguji contoh, sebaiknya Anda mengunggah beberapa dokumen saja ke bucket S3 Anda. Jika konfigurasi Anda benar, pada akhirnya Anda akan melihat **status Sinkronisasi** **Selesai**. Jika Anda menemukan kesalahan, lihat [Memecahkan masalah koneksi Amazon VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-connector-troubleshoot.html). # Amazon Kendra Perayap Web Anda dapat menggunakan Amazon Kendra Web Crawler untuk merayapi dan mengindeks halaman web. Anda hanya dapat merayapi situs web publik atau situs web perusahaan internal yang menggunakan protokol komunikasi aman Hypertext Transfer Protocol Secure (HTTPS). Jika Anda menerima kesalahan saat merayapi situs web, bisa jadi situs web tersebut diblokir dari perayapan. Untuk merayapi situs web internal, Anda dapat mengatur proxy web. Proxy web harus menghadap publik. Anda juga dapat menggunakan otentikasi untuk mengakses dan merayapi situs web. *Saat memilih situs web untuk diindeks, Anda harus mematuhi [Kebijakan Penggunaan yang Diterima Amazon](https://aws.amazon.com/aup/) dan semua syarat Amazon lainnya. Ingat bahwa Anda hanya harus menggunakan Amazon Kendra Web Crawler untuk mengindeks halaman web Anda sendiri, atau halaman web yang Anda memiliki otorisasi untuk indeks. Untuk mempelajari cara menghentikan Amazon Kendra Web Crawler dari mengindeks situs web Anda, silakan lihat. [Mengkonfigurasi `robots.txt` file untuk Amazon Kendra Web Crawler](stop-web-crawler.md)* **catatan** **Menyalahgunakan Amazon Kendra Web Crawler untuk secara agresif merayapi situs web atau halaman web yang tidak Anda miliki dianggap penggunaan yang dapat diterima.** Amazon Kendra memiliki dua versi web crawler konektor. Fitur yang didukung dari setiap versi meliputi: **Amazon Kendra Konektor Web Crawler v1.0 /API [https://docs.aws.amazon.com/kendra/latest/dg/API_WebCrawlerConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_WebCrawlerConfiguration.html)** + Proksi web + Filter inklusi/pengecualian **Amazon Kendra Konektor Web Crawler v2.0/API [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)** + Pemetaan bidang + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Proksi web + Dasar, NTLM/Kerberos, SAMP, dan otentikasi formulir untuk situs web Anda + Cloud privat virtual (VPC) **penting** Pembuatan konektor Web Crawler v2.0 tidak didukung oleh. CloudFormation Gunakan konektor Web Crawler v1.0 jika Anda memerlukan CloudFormation dukungan. Untuk memecahkan masalah konektor sumber data crawler Amazon Kendra web Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Amazon Kendra Konektor Web Crawler v1.0](data-source-v1-web-crawler.md) + [Amazon Kendra Konektor Web Crawler v2.0](data-source-v2-web-crawler.md) + [Mengkonfigurasi `robots.txt` file untuk Amazon Kendra Web Crawler](stop-web-crawler.md) # Amazon Kendra Konektor Web Crawler v1.0 Anda dapat menggunakan Amazon Kendra Web Crawler untuk merayapi dan mengindeks halaman web. Anda hanya dapat merayapi situs web dan situs web yang menghadap publik yang menggunakan protokol komunikasi aman Hypertext Transfer Protocol Secure (HTTPS). Jika Anda menerima kesalahan saat merayapi situs web, bisa jadi situs web tersebut diblokir dari perayapan. Untuk merayapi situs web internal, Anda dapat mengatur proxy web. Proxy web harus menghadap publik. *Saat memilih situs web untuk diindeks, Anda harus mematuhi [Kebijakan Penggunaan yang Diterima Amazon](https://aws.amazon.com/aup/) dan semua syarat Amazon lainnya. Ingat bahwa Anda hanya harus menggunakan Amazon Kendra Web Crawler untuk mengindeks halaman web Anda sendiri, atau halaman web yang Anda memiliki otorisasi untuk indeks. Untuk mempelajari cara menghentikan Amazon Kendra Web Crawler dari mengindeks situs web Anda, silakan lihat. [Mengkonfigurasi `robots.txt` file untuk Amazon Kendra Web Crawler](stop-web-crawler.md)* **catatan** **Menyalahgunakan Amazon Kendra Web Crawler untuk secara agresif merayapi situs web atau halaman web yang tidak Anda miliki dianggap penggunaan yang dapat diterima.** Untuk memecahkan masalah konektor sumber data crawler Amazon Kendra web Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-v1-web-crawler) + [Prasyarat](#prerequisites-v1-web-crawler) + [Instruksi koneksi](#data-source-v1-procedure-web-crawler) + [Pelajari selengkapnya](#web-crawler-learn-more) ## Fitur yang didukung + Proksi web + Filter inklusi/pengecualian ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks situs web Anda, periksa detail situs web dan AWS akun Anda. **Untuk situs web Anda, pastikan Anda memiliki:** + Menyalin benih atau peta situs web URLs yang ingin Anda indeks. + **Untuk situs web yang memerlukan otentikasi dasar**: Mencatat nama pengguna dan kata sandi, dan menyalin nama host situs web dan nomor port. + **Opsional:** Menyalin nama host situs web dan nomor port jika Anda ingin menggunakan proxy web untuk terhubung ke situs web internal yang ingin dirayapi. Proxy web harus menghadap publik. Amazon Kendra mendukung koneksi ke server proxy web yang didukung oleh otentikasi dasar atau Anda dapat terhubung tanpa otentikasi. + Memeriksa setiap dokumen halaman web yang ingin Anda indeks adalah unik dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di AWS akun Anda, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebut IAM . **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benar AWS Secrets Manager . + Untuk situs web yang memerlukan otentikasi, atau jika menggunakan proxy web dengan otentikasi, menyimpan kredensyal otentikasi Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensyal dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber web crawler data Anda Amazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber web crawler data Anda, Anda harus memberikan rincian yang diperlukan dari sumber web crawler data Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi web crawler untuk Amazon Kendra lihat[Prasyarat](#prerequisites-v1-web-crawler). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke web crawler** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambah sumber data**, pilih **konektor web crawler**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor web crawler dengan tag** “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. Untuk **Sumber**, pilih antara **peta situs **Sumber URLs** dan Sumber** tergantung pada kasus penggunaan Anda dan masukkan nilai untuk masing-masing. Anda dapat menambahkan hingga 10 sumber URLs dan tiga peta situs. **catatan** Jika Anda ingin merayapi peta situs, periksa apakah URL dasar atau root sama dengan yang URLs tercantum di halaman peta situs Anda. Misalnya, jika URL peta situs Anda *https://example.com/sitemap-page.html*, yang URLs tercantum di halaman peta situs ini juga harus menggunakan URL dasar "”. https://example.com/ 1. (Opsional) Untuk **proxy Web** — masukkan informasi berikut: 1. **Nama host** —Nama host tempat proxy web diperlukan. 1. **Nomor port** —Port yang digunakan oleh protokol transport URL host. Nomor port harus berupa nilai numerik antara 0 dan 65535. 1. Untuk **kredensyal proxy Web** —Jika koneksi proxy web Anda memerlukan otentikasi, pilih rahasia yang ada atau buat rahasia baru untuk menyimpan kredensyal otentikasi Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-WebCrawler-' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **Nama Pengguna** dan **Kata Sandi** —Masukkan kredensyal otentikasi dasar ini untuk situs web Anda. 1. Pilih **Simpan**. 1. (Opsional) **Host dengan otentikasi** —Pilih untuk menambahkan host tambahan dengan otentikasi. 1. **IAM peran** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAM peran yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Rentang perayapan** —Pilih jenis halaman web yang ingin dirayapi. 1. **Kedalaman perayapan** —Pilih jumlah level dari URL seed yang Amazon Kendra seharusnya di-crawl. 1. **Pengaturan crawl lanjutan** dan **Konfigurasi tambahan** masukkan informasi berikut: 1. **Ukuran file maksimum** —Halaman web maksimum atau ukuran lampiran untuk dirayapi. Minimum 0,000001 MB (1 byte). Maksimal 50 MB. 1. **Tautan maksimum per halaman** —Jumlah maksimum tautan yang dirayapi per halaman. Tautan dirayapi dalam urutan kemunculan. Minimal 1link/page. Maximum 1000 links/page. 1. **Pelambatan maksimum** —Jumlah maksimum URLs crawled per nama host per menit. Minimal 1 URLs/host name/minute. Maximum 300 URLs/host name/minute. 1. Pola **Regex —Tambahkan pola** ekspresi reguler untuk menyertakan atau mengecualikan tertentu. URLs Anda dapat menambahkan hingga 100 pola. 1. Di **Jadwal berjalan Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke web crawler** Anda harus menentukan yang berikut menggunakan [WebCrawlerConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_WebCrawlerConfiguration.html)API: + **URLs**—Tentukan benih atau titik URLs awal situs web atau peta situs situs web URLs yang ingin Anda jelajahi menggunakan dan. [https://docs.aws.amazon.com/kendra/latest/dg/API_SeedUrlConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_SeedUrlConfiguration.html) **catatan** Jika Anda ingin merayapi peta situs, periksa apakah URL dasar atau root sama dengan yang URLs tercantum di halaman peta situs Anda. Misalnya, jika URL peta situs Anda *https://example.com/sitemap-page.html*, yang URLs tercantum di halaman peta situs ini juga harus menggunakan URL dasar "”. https://example.com/ + **Rahasia Nama Sumber Daya Amazon (ARN)** —Jika sebuah situs web memerlukan otentikasi dasar, Anda memberikan nama host, nomor port, dan rahasia yang menyimpan kredensyal otentikasi dasar nama pengguna dan kata sandi Anda. Anda memberikan ARN rahasia menggunakan API. [https://docs.aws.amazon.com/kendra/latest/dg/API_AuthenticationConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_AuthenticationConfiguration.html) Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "username": "user name", "password": "password" } ``` Anda juga dapat memberikan kredensyal proxy web menggunakan rahasia. AWS Secrets Manager Anda menggunakan [https://docs.aws.amazon.com/kendra/latest/dg/API_ProxyConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_ProxyConfiguration.html)API untuk memberikan nama host situs web dan nomor port, dan secara opsional rahasia yang menyimpan kredensyal proxy web Anda. + **IAM peran** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor perayap web dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAM peran untuk sumber data perayap web](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Mode perayapan** —Pilih apakah akan merayapi nama host situs web saja, atau nama host dengan subdomain, atau juga merayapi domain lain yang ditautkan halaman web. + 'Kedalaman' atau jumlah level dari tingkat benih hingga merangkak. Misalnya, halaman URL benih adalah kedalaman 1 dan hyperlink apa pun di halaman ini yang juga dirayapi adalah kedalaman 2. + Jumlah maksimum URLs pada satu halaman web untuk dirayapi. + Ukuran maksimum dalam MB halaman web untuk dirayapi. + Jumlah maksimum URLs crawled per host situs web per menit. + Host proxy web dan nomor port untuk terhubung ke dan merayapi situs web internal. Misalnya, nama host *https://a.example.com/page1.html*adalah "a.example.com" dan nomor port adalah 443, port standar untuk HTTPS. Jika kredensyal proxy web diperlukan untuk terhubung ke host situs web, Anda dapat membuat AWS Secrets Manager yang menyimpan kredensialnya. + Informasi autentikasi untuk mengakses dan merayapi situs web yang memerlukan autentikasi pengguna. + Anda dapat mengekstrak tag meta HTML sebagai bidang menggunakan alat *Pengayaan Dokumen Kustom*. Untuk informasi selengkapnya, lihat [Menyesuaikan metadata dokumen selama proses konsumsi.](https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html) Untuk contoh mengekstrak tag meta HTML, lihat contoh [CDE](https://github.com/aws-samples/amazon-kendra-cde-examples). + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan tertentu. URLs **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber web crawler data Anda, lihat: + [Bayangkan kembali penemuan pengetahuan menggunakan Web Amazon Kendra Crawler](https://aws.amazon.com/blogs/machine-learning/reimagine-knowledge-discovery-using-amazon-kendras-web-crawler/) # Amazon Kendra Konektor Web Crawler v2.0 Anda dapat menggunakan Amazon Kendra Web Crawler untuk merayapi dan mengindeks halaman web. Anda hanya dapat merayapi situs web publik atau situs web perusahaan internal yang menggunakan protokol komunikasi aman Hypertext Transfer Protocol Secure (HTTPS). Jika Anda menerima kesalahan saat merayapi situs web, bisa jadi situs web tersebut diblokir dari perayapan. Untuk merayapi situs web internal, Anda dapat mengatur proxy web. Proxy web harus menghadap publik. Anda juga dapat menggunakan otentikasi untuk mengakses dan merayapi situs web. Amazon Kendra Web Crawler v2.0 menggunakan paket perayap web Selenium dan driver Chromium. Amazon Kendra secara otomatis memperbarui versi Selenium dan driver Chromium menggunakan Continuous Integration (CI). *Saat memilih situs web untuk diindeks, Anda harus mematuhi [Kebijakan Penggunaan yang Diterima Amazon](https://aws.amazon.com/aup/) dan semua syarat Amazon lainnya. Ingat bahwa Anda hanya harus menggunakan Amazon Kendra Web Crawler untuk mengindeks halaman web Anda sendiri, atau halaman web yang Anda memiliki otorisasi untuk indeks. Untuk mempelajari cara menghentikan Amazon Kendra Web Crawler dari mengindeks situs web Anda, silakan lihat. [Mengkonfigurasi `robots.txt` file untuk Amazon Kendra Web Crawler](stop-web-crawler.md)* . **Menyalahgunakan Amazon Kendra Web Crawler untuk secara agresif merayapi situs web atau halaman web yang tidak Anda miliki dianggap penggunaan yang dapat diterima.** Untuk memecahkan masalah konektor sumber data crawler Amazon Kendra web Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **catatan** Konektor Web Crawler v2.0 *tidak* mendukung crawling daftar situs web dari AWS KMS bucket terenkripsi. Amazon S3 Ini hanya mendukung enkripsi sisi server dengan Amazon S3 kunci terkelola. **penting** Pembuatan konektor Web Crawler v2.0 tidak didukung oleh. CloudFormation Gunakan konektor Web Crawler v1.0 jika Anda memerlukan CloudFormation dukungan. **Topics** + [Fitur yang didukung](#supported-features-v2-web-crawler) + [Prasyarat](#prerequisites-v2-web-crawler) + [Instruksi koneksi](#data-source-v2-procedure-web-crawler) ## Fitur yang didukung + Pemetaan bidang + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Proksi web + Dasar, NTLM/Kerberos, SAMP, dan otentikasi formulir untuk situs web Anda + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks situs web Anda, periksa detail situs web dan AWS akun Anda. **Untuk situs web Anda, pastikan Anda memiliki:** + Menyalin benih atau peta situs web URLs yang ingin Anda indeks. Anda dapat menyimpan URLs dalam file teks dan mengunggahnya ke Amazon S3 ember. Setiap URL dalam file teks harus diformat pada baris terpisah. Jika Anda ingin menyimpan peta situs Anda dalam sebuah Amazon S3 bucket, pastikan Anda telah menyalin XMLsitemap dan menyimpannya dalam file XHTML. Anda juga dapat memasukkan beberapa file XMLpeta situs ke dalam file ZIP. **catatan** (On-premise/server) Amazon Kendra memeriksa apakah informasi titik akhir yang disertakan sama dengan informasi titik akhir yang AWS Secrets Manager ditentukan dalam detail konfigurasi sumber data Anda. Ini membantu melindungi dari [masalah wakil yang membingungkan](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html), yang merupakan masalah keamanan di mana pengguna tidak memiliki izin untuk melakukan tindakan tetapi menggunakan Amazon Kendra sebagai proxy untuk mengakses rahasia yang dikonfigurasi dan melakukan tindakan. Jika nanti Anda mengubah informasi titik akhir Anda, Anda harus membuat rahasia baru untuk menyinkronkan informasi ini. + **Untuk situs web yang memerlukan otentikasi dasar, NTLM, atau** Kerberos: + Mencatat kredensi otentikasi situs web Anda, yang mencakup nama pengguna dan kata sandi. **catatan** Amazon Kendra Web Crawler v2.0 mendukung protokol otentikasi NTLM yang mencakup hashing kata sandi, dan protokol otentikasi Kerberos yang mencakup enkripsi kata sandi. + **Untuk situs web yang memerlukan SAMP atau otentikasi formulir login**: + Mencatat kredensi otentikasi situs web Anda, yang mencakup nama pengguna dan kata sandi. + Menyalin XPaths (XMLPath Language) dari bidang nama pengguna (dan tombol nama pengguna jika menggunakan SAMP), bidang kata sandi dan tombol, dan menyalin URL halaman login. Anda dapat menemukan XPaths elemen menggunakan alat pengembang browser web Anda. XPaths biasanya mengikuti format ini:`//tagname[@Attribute='Value']`. **catatan** Amazon Kendra Web Crawler v2.0 menggunakan browser Chrome tanpa kepala dan informasi dari formulir untuk mengautentikasi dan mengotorisasi akses dengan URL yang dilindungi 2.0. OAuth + **Opsional**: Menyalin nama host dan nomor port server proxy web jika Anda ingin menggunakan proxy web untuk terhubung ke situs web internal yang ingin dirayapi. Proxy web harus menghadap publik. Amazon Kendra mendukung koneksi ke server proxy web yang didukung oleh otentikasi dasar atau Anda dapat terhubung tanpa otentikasi. + **Opsional**: Menyalin ID subnet virtual private cloud (VPC) jika Anda ingin menggunakan VPC untuk terhubung ke situs web internal yang ingin dirayapi. Untuk informasi selengkapnya, lihat [Mengonfigurasi file Amazon VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html). + Memeriksa setiap dokumen halaman web yang ingin Anda indeks adalah unik dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di AWS akun Anda, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat Nama Sumber Daya Amazon dari IAM peran tersebut. **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benar AWS Secrets Manager . + Untuk situs web yang memerlukan otentikasi, atau jika menggunakan proxy web dengan otentikasi, menyimpan kredensyal otentikasi Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensyal dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber web crawler data Anda Amazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber web crawler data Anda, Anda harus memberikan rincian yang diperlukan dari sumber web crawler data Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi web crawler untuk Amazon Kendra lihat[Prasyarat](#prerequisites-v2-web-crawler). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke web crawler** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambah sumber data**, pilih **konektor web crawler**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor web crawler dengan tag** “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **Sumber** —Pilih salah satu **Sumber URLs**, **Peta situs Sumber, ** URLsFile sumber, file** peta** situs **Sumber**. Jika Anda memilih untuk menggunakan file teks yang menyertakan daftar hingga 100 seed URLs, Anda menentukan path ke Amazon S3 bucket tempat file Anda disimpan. Jika Anda memilih untuk menggunakan file XMLpeta situs, Anda menentukan path ke Amazon S3 bucket tempat file Anda disimpan. Anda juga dapat memasukkan beberapa file XMLpeta situs ke dalam file ZIP. Jika tidak, Anda dapat memasukkan hingga 10 benih atau titik awal secara manual URLs, dan hingga tiga peta situs URLs. **catatan** Jika Anda ingin merayapi peta situs, periksa apakah URL dasar atau root sama dengan yang URLs tercantum di halaman peta situs Anda. Misalnya, jika URL peta situs Anda *https://example.com/sitemap-page.html*, yang URLs tercantum di halaman peta situs ini juga harus menggunakan URL dasar "”. https://example.com/ Jika situs web Anda memerlukan otentikasi untuk mengakses situs web, Anda dapat memilih ether basic, NTLM/Kerberos, SAMP, atau otentikasi formulir. Jika tidak, pilih opsi untuk tidak ada otentikasi. **catatan** Jika Anda ingin mengedit sumber data nanti untuk mengubah seed Anda URLs dengan otentikasi ke peta situs, Anda harus membuat sumber data baru. Amazon Kendra mengonfigurasi sumber data menggunakan informasi URLs titik akhir benih dalam Secrets Manager rahasia untuk otentikasi, dan oleh karena itu tidak dapat mengonfigurasi ulang sumber data saat mengubah ke peta situs. 1. AWS Secrets Manager Jika situs web Anda memerlukan otentikasi yang sama untuk mengakses situs web, pilih **rahasia** yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal situs web Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. Jika Anda memilih otentikasi **Dasar** atau **NTML/KerberOS**, masukkan nama untuk rahasia, ditambah nama pengguna dan kata sandi. Protokol otentikasi NTLM mencakup hashing kata sandi, dan protokol otentikasi Kerberos mencakup enkripsi kata sandi. Jika Anda memilih **SAMP** atau otentikasi **Formulir**, masukkan nama untuk rahasia, ditambah nama pengguna dan kata sandi. Gunakan XPath untuk bidang nama pengguna (dan XPath untuk tombol nama pengguna jika menggunakan SAFL). Gunakan XPaths untuk bidang kata sandi dan tombol, dan URL halaman login. Anda dapat menemukan XPaths (Bahasa Jalur XHTML) elemen menggunakan alat pengembang browser web Anda. XPaths biasanya mengikuti format ini:`//tagname[@Attribute='Value']`. 1. (Opsional) **Web proxy** —Masukkan nama host dan nomor port dari proxy sever yang ingin Anda gunakan untuk terhubung ke situs web internal. Misalnya, nama host *https://a.example.com/page1.html*adalah "a.example.com" dan nomor port adalah 443, port standar untuk HTTPS. Jika kredensyal proxy web diperlukan untuk terhubung ke host situs web, Anda dapat membuat AWS Secrets Manager yang menyimpan kredensialnya. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **IAM peran** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAM peran yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Lingkup sinkronisasi** —Tetapkan batas untuk merayapi halaman web termasuk domain, ukuran file, dan tautannya; dan filter URLs menggunakan pola regex. 1. (Opsional) **Rentang domain crawl** —Pilih apakah akan merayapi domain situs web saja, domain dengan subdomain, atau juga merayapi domain lain yang ditautkan oleh halaman web. Secara default, Amazon Kendra hanya merayapi domain situs web yang ingin Anda jelajahi. 1. (Opsional) **Konfigurasi tambahan** —Atur pengaturan berikut: + **Kedalaman merangkak** —' Kedalaman 'atau jumlah level dari tingkat benih hingga merangkak. Misalnya, halaman URL benih adalah kedalaman 1 dan hyperlink apa pun di halaman ini yang juga dirayapi adalah kedalaman 2. + **Ukuran file maksimum** —Ukuran maksimum dalam MB halaman web atau lampiran untuk dirayapi. + **Tautan maksimum per halaman** —Jumlah maksimum URLs pada satu halaman web untuk dirayapi. + **Pelambatan maksimum kecepatan perayapan —Jumlah maksimum URLs crawl** per host situs web per menit. + **File** —Pilih untuk merayapi file yang ditautkan ke halaman web. + **Crawl dan index URLs** —Tambahkan pola ekspresi reguler untuk menyertakan atau mengecualikan crawling tertentu URLs, dan mengindeks hyperlink apa pun di halaman web URL ini. 1. **Mode sinkronisasi** —Pilih cara Anda ingin memperbarui indeks saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. **Sinkronkan jadwal berjalan** —Untuk **Frekuensi**, pilih seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang default Amazon Kendra yang dihasilkan dari halaman web dan file yang ingin Anda petakan ke indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke web crawler** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-web-crawler-schema) menggunakan API. [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `WEBCRAWLERV2` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **URLs**—Tentukan benih atau titik URLs awal situs web atau peta situs situs web URLs yang ingin dirayapi. Anda dapat menentukan jalur ke Amazon S3 ember yang menyimpan daftar benih Anda URLs. Setiap URL dalam file teks untuk seed URLs harus diformat pada baris terpisah. Anda juga dapat menentukan path ke Amazon S3 bucket yang menyimpan file XHTML sitemap Anda. Anda dapat menggabungkan beberapa file peta situs ke dalam file ZIP dan menyimpan file ZIP di bucket Anda Amazon S3 . **catatan** Jika Anda ingin merayapi peta situs, periksa apakah URL dasar atau root sama dengan yang URLs tercantum di halaman peta situs Anda. Misalnya, jika URL peta situs Anda *https://example.com/sitemap-page.html*, yang URLs tercantum di halaman peta situs ini juga harus menggunakan URL dasar "”. https://example.com/ + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Otentikasi** — Jika situs web Anda memerlukan otentikasi yang sama, tentukan salah satu,, `BasicAuth` `NTLM_Kerberos``SAML`, atau otentikasi. `Form` Jika situs web Anda tidak memerlukan otentikasi, tentukan`NoAuthentication`. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Jika situs web Anda memerlukan otentikasi dasar, NTLM, atau Kerberos, Anda memberikan rahasia yang menyimpan kredensyal otentikasi nama pengguna dan kata sandi Anda. Anda memberikan Nama Sumber Daya Amazon (ARN) dari sebuah AWS Secrets Manager rahasia. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "seedUrlsHash": "Hash representation of all seed URLs", "userName": "user name", "password": "password" } ``` Jika situs web Anda memerlukan otentikasi SAMP, rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "seedUrlsHash": "Hash representation of all seed URLs", "userName": "user name", "password": "password", "userNameFieldXpath": "XPath for user name field", "userNameButtonXpath": "XPath for user name button", "passwordFieldXpath": "XPath for password field", "passwordButtonXpath": "XPath for password button", "loginPageUrl": "Full URL for website login page" } ``` Jika situs web Anda memerlukan otentikasi formulir, rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "seedUrlsHash": "Hash representation of all seed URLs", "userName": "user name", "password": "password", "userNameFieldXpath": "XPath for user name field", "passwordFieldXpath": "XPath for password field", "passwordButtonXpath": "XPath for password button", "loginPageUrl": "Full URL for website login page" } ``` Anda dapat menemukan XPaths (Bahasa Jalur XHTML) elemen menggunakan alat pengembang browser web Anda. XPaths biasanya mengikuti format ini:`//tagname[@Attribute='Value']`. Anda juga dapat memberikan kredensyal proxy web menggunakan dan AWS Secrets Manager rahasia. + **IAM peran** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor perayap web dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAM peran untuk sumber data perayap web](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Rentang domain** —Pilih apakah akan merayapi domain situs web dengan subdomain saja, atau juga merayapi domain lain yang ditautkan ke halaman web. Secara default, Amazon Kendra hanya merayapi domain situs web yang ingin Anda jelajahi. + 'Kedalaman' atau jumlah level dari tingkat benih hingga merangkak. Misalnya, halaman URL benih adalah kedalaman 1 dan hyperlink apa pun di halaman ini yang juga dirayapi adalah kedalaman 2. + Jumlah maksimum URLs pada satu halaman web untuk dirayapi. + Ukuran maksimum dalam MB halaman web atau lampiran untuk dirayapi. + Jumlah maksimum URLs crawled per host situs web per menit. + Host proxy web dan nomor port untuk terhubung ke dan merayapi situs web internal. Misalnya, nama host *https://a.example.com/page1.html*adalah "a.example.com" dan nomor port adalah 443, port standar untuk HTTPS. Jika kredensyal proxy web diperlukan untuk terhubung ke host situs web, Anda dapat membuat AWS Secrets Manager yang menyimpan kredensialnya. + **Filter penyertaan dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan perayapan tertentu URLs dan mengindeks hyperlink apa pun di halaman web URL ini. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Pemetaan bidang** —Pilih untuk memetakan bidang halaman web dan file halaman web ke bidang indeks Anda Amazon Kendra . Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat Skema [template Amazon Kendra Web Crawler](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-web-crawler). ------ # Mengkonfigurasi `robots.txt` file untuk Amazon Kendra Web Crawler Amazon Kendra adalah layanan pencarian cerdas yang digunakan AWS pelanggan untuk mengindeks dan mencari dokumen pilihan mereka. Untuk mengindeks dokumen di web, pelanggan dapat menggunakan Amazon Kendra Web Crawler, yang menunjukkan URL mana yang harus diindeks dan parameter operasional lainnya. Amazon Kendra pelanggan diharuskan untuk mendapatkan otorisasi sebelum mengindeks situs web tertentu. Amazon Kendra Web Crawler menghormati arahan robots.txt standar seperti dan. `Allow` `Disallow` Anda dapat memodifikasi `robots.txt` file situs web Anda untuk mengontrol bagaimana Amazon Kendra Web Crawler merayapi situs web Anda. ## Mengkonfigurasi bagaimana Amazon Kendra Web Crawler mengakses situs web Anda Anda dapat mengontrol bagaimana Amazon Kendra Web Crawler mengindeks situs web Anda menggunakan `Allow` dan `Disallow` arahan. Anda juga dapat mengontrol halaman web mana yang diindeks dan halaman web mana yang tidak dirayapi. **Untuk mengizinkan Amazon Kendra Web Crawler merayapi semua halaman web kecuali halaman web yang tidak diizinkan, gunakan arahan berikut:** ``` User-agent: amazon-kendra # Amazon Kendra Web Crawler Disallow: /credential-pages/ # disallow access to specific pages ``` **Untuk mengizinkan Amazon Kendra Web Crawler merayapi hanya halaman web tertentu, gunakan arahan berikut:** ``` User-agent: amazon-kendra # Amazon Kendra Web Crawler Allow: /pages/ # allow access to specific pages ``` **Untuk memungkinkan Amazon Kendra Web Crawler merayapi semua konten situs web dan melarang perayapan untuk robot lain, gunakan arahan berikut:** ``` User-agent: amazon-kendra # Amazon Kendra Web Crawler Allow: / # allow access to all pages User-agent: * # any (other) robot Disallow: / # disallow access to any pages ``` ## Menghentikan Amazon Kendra Web Crawler dari merayapi situs web Anda Anda dapat menghentikan Amazon Kendra Web Crawler dari mengindeks situs web Anda menggunakan arahan. `Disallow` Anda juga dapat mengontrol halaman web mana yang dirayapi dan mana yang tidak. **Untuk menghentikan Amazon Kendra Web Crawler merayapi situs web, gunakan arahan berikut:** ``` User-agent: amazon-kendra # Amazon Kendra Web Crawler Disallow: / # disallow access to any pages ``` Jika Anda memiliki pertanyaan atau kekhawatiran tentang Amazon Kendra Web Crawler, Anda dapat menghubungi [tim AWS dukungan](https://aws.amazon.com/contact-us/?nc1=f_m). # Box Box adalah layanan penyimpanan cloud yang menawarkan kemampuan hosting file. Anda dapat menggunakan Amazon Kendra untuk mengindeks konten dalam konten Box Anda, termasuk komentar, tugas, dan tautan web. Anda dapat terhubung Amazon Kendra ke sumber data Box menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [BoxConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BoxConfiguration.html)API. Untuk memecahkan masalah konektor sumber data Amazon Kendra Box, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-box) + [Prasyarat](#prerequisites-box) + [Instruksi koneksi](#data-source-procedure-box) + [Pelajari selengkapnya](#box-learn-more) + [Catatan](#box-notes) ## Fitur yang didukung Amazon KendraKonektor sumber data kotak mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Ubah log, sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Box Anda, buat perubahan ini di Kotak dan AWS akun Anda. **Di Box, pastikan Anda memiliki:** + Akun Box Enterprise atau Box Enterprise Plus. + Mengkonfigurasi aplikasi kustom Box di Box Developer Console, dengan otentikasi sisi Server menggunakan JSON Web Tokens (JWT). Lihat [Dokumentasi kotak tentang membuat Dokumentasi Aplikasi dan Kotak Kustom](https://developer.box.com/guides/applications/app-types/platform-apps/) [untuk mengonfigurasi JWT Auth](https://developer.box.com/guides/authentication/jwt/) untuk detail selengkapnya. + **Setel Level Akses Aplikasi** Anda ke **App \$1 Enterprise Access** dan izinkan **melakukan panggilan API menggunakan header as-user**. + Menggunakan pengguna admin untuk menambahkan **Lingkup Aplikasi** berikut di aplikasi Box Anda: + Menulis semua file dan folder yang disimpan dalam Kotak + Mengelola pengguna + Kelola grup + Kelola properti perusahaan + Public/Private Key pair yang dikonfigurasi termasuk ID klien, rahasia klien, ID kunci publik, ID kunci pribadi, frasa lulus, dan ID perusahaan untuk digunakan sebagai kredensyal otentikasi Anda. Lihat [public dan private key pair](https://developer.box.com/guides/authentication/jwt/jwt-setup/#public-and-private-key-pair) untuk detail selengkapnya. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + Menyalin ID perusahaan Box Anda baik dari pengaturan Box Developer Console atau dari aplikasi Box Anda. Misalnya, *801234567*. + Memeriksa setiap dokumen unik di Box dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi Box Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat menghubungkan sumber data BoxAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Box Anda, Anda harus memberikan rincian yang diperlukan dari sumber data Box Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Box forAmazon Kendra, lihat[Prasyarat](#prerequisites-box). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Box** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **Konektor kotak**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **Konektor kotak** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **Kotak ID perusahaan** —Masukkan ID Kotak Perusahaan Anda. Misalnya, *801234567*. 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal otentikasi Kotak Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-Box-' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **ID Klien**, **Rahasia Klien**, **ID Kunci Publik**, **ID Kunci Pribadi**, dan **Frasa Lulus** —Masukkan nilai dari Public/Private Kunci yang Anda konfigurasikan di Kotak. 1. Tambahkan dan simpan rahasia Anda. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. 1. **IAMperan** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensyal repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **File kotak** —Pilih apakah akan merayapi tautan web, komentar, dan tugas. 1. Untuk **konfigurasi Tambahan** —Tambahkan pola ekspresi reguler untuk menyertakan atau mengecualikan konten tertentu. 1. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Di **Sinkronkan jadwal lari** untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Bidang **sumber data default —Pilih dari bidang** sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Box** Anda harus menentukan yang berikut menggunakan [BoxConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BoxConfiguration.html)API: **ID perusahaan kotak** —Berikan ID Perusahaan Kotak Anda. Anda dapat menemukan ID perusahaan di setelan Box Developer Console atau saat Anda mengonfigurasi aplikasi di Box. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi untuk akun Box Anda. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "clientID": "client-id", "clientSecret": "client-secret", "publicKeyID": "public-key-id", "privateKey": "private-key", "passphrase": "pass-phrase" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Box dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk Sumber data Kotak](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC)** —Tentukan `VpcConfiguration` sebagai bagian dari konfigurasi sumber data. Lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html). + **Ubah log** —Apakah Amazon Kendra harus menggunakan mekanisme log perubahan sumber data Kotak untuk menentukan apakah dokumen harus diperbarui dalam indeks. **catatan** Gunakan log perubahan jika Anda tidak Amazon Kendra ingin memindai semua dokumen. Jika log perubahan Anda besar, mungkin perlu waktu Amazon Kendra lebih sedikit untuk memindai dokumen di sumber data Kotak daripada memproses log perubahan. Jika Anda menyinkronkan sumber data Box dengan indeks untuk pertama kalinya, semua dokumen dipindai. + **Komentar, tugas, tautan web** —Tentukan apakah akan merayapi jenis konten ini. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan file dan folder Kotak tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Kotak Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Box Anda, lihat: + [Memulai dengan konektor Amazon Kendra Box](https://aws.amazon.com/blogs/machine-learning/getting-started-with-the-amazon-kendra-box-connector/) ## Catatan + Saat Daftar Kontrol Akses (ACLs) diaktifkan, opsi “Sinkronkan hanya konten baru atau yang dimodifikasi” tidak tersedia karena keterbatasan Box API. Sebaiknya gunakan mode “Sinkronisasi penuh” atau “Sinkronisasi konten baru, dimodifikasi, atau dihapus” sebagai gantinya, atau nonaktifkan ACLs jika Anda perlu menggunakan mode sinkronisasi ini. # Confluence Confluence adalah alat manajemen kerja kolaboratif yang dirancang untuk berbagi, menyimpan, dan mengerjakan perencanaan proyek, pengembangan perangkat lunak, dan manajemen produk. Amazon Kendra mendukung Confluence Server/Data Center dan Confluence Cloud. Anda dapat menggunakan Amazon Kendra untuk mengindeks entitas Confluence berikut: + **Spaces** — Area yang ditunjuk tingkat atas untuk mengatur konten terkait. Setiap ruang berfungsi sebagai wadah, mampu menampung banyak halaman, blog, dan lampiran. + **Halaman** — Dokumen individual dalam ruang tempat pengguna membuat dan mengelola konten. Halaman dapat berisi teks, gambar, tabel, dan elemen multimedia, dan dapat memiliki sub-halaman bersarang. Setiap halaman dianggap sebagai satu dokumen. + **Blog** — Konten yang mirip dengan halaman, biasanya digunakan untuk pembaruan atau pengumuman. Setiap posting blog dianggap sebagai satu dokumen. + **Komentar** - Memungkinkan pengguna untuk memberikan umpan balik atau terlibat dalam diskusi tentang konten tertentu dalam halaman atau posting blog. + **Lampiran** — File yang diunggah ke halaman atau posting blog di Confluence, seperti gambar, dokumen, atau jenis file lainnya. Secara default, Amazon Kendra tidak mengindeks arsip Confluence dan ruang pribadi. Anda dapat memilih untuk mengindeksnya ketika membuat sumber data. Jika Anda tidak ingin Amazon Kendra mengindeks spasi, tandai secara pribadi di Confluence. Anda dapat terhubung Amazon Kendra ke sumber data Confluence menggunakan [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/), [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API, atau API. [ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html) Amazon Kendra memiliki dua versi konektor Confluence. Fitur-fitur berikut didukung. ****Konektor pertemuan V2.0 /API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)**** + Pemetaan bidang + Kontrol akses pengguna + Pola inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ****Konektor pertemuan V1.0 [ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html)/API** (tidak lagi didukung)** + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + (Hanya Server Confluence) Cloud pribadi virtual (VPC) **catatan** Konektor pertemuan V1.0/ ConfluenceConfiguration API berakhir pada 2023. Kami merekomendasikan untuk bermigrasi ke atau menggunakan konektor Confluence V2.0/API. TemplateConfiguration Untuk memecahkan masalah konektor sumber data Amazon Kendra Confluence, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [ACLs di Confluence Connector](#data-source-confluence-acls) + [Konektor pertemuan V2.0](data-source-v2-confluence.md) + [Konektor pertemuan V1.0](data-source-v1-confluence.md) ## ACLs di Confluence Connector Konektor mendukung perayapan Daftar Kontrol Akses (ACLs) dan mengidentifikasi informasi jika berlaku berdasarkan sumber data. Jika Anda mengindeks dokumen tanpa ACLs, semua dokumen dianggap publik. Mengindeks dokumen dengan ACLs memastikan keamanan data. Konektor Amazon Kendra Confluence memindai ruang untuk mengumpulkan halaman dan posting blog bersama dengan mereka. ACLs Jika tidak ada batasan yang diterapkan pada halaman atau blog, konektor mewarisi izin dari ruangnya. Jika pembatasan pengguna atau grup tertentu diterapkan pada halaman, hanya pengguna tersebut yang dapat mengakses halaman tersebut. Jika halaman bersarang, halaman bersarang mewarisi izin halaman induk jika tidak ada batasan yang diterapkan. Model izin serupa berlaku untuk blog; Namun, Confluence tidak mendukung blog bersarang. Selain itu, konektor Amazon Kendra Confluence merayapi informasi utama pengguna (alias pengguna lokal, grup lokal dan konfigurasi identitas grup federasi) dan izinnya untuk setiap ruang yang dikonfigurasi. **catatan** Konektor Confluence Cloud tidak mendukung crawling makro, papan tulis, atau database. Konektor Amazon Kendra Confluence memperbarui perubahan ACL setiap kali meng-crawl konten sumber data Anda. Untuk memastikan pengguna yang benar memiliki akses ke konten yang benar, sinkronkan ulang sumber data Anda secara teratur untuk menangkap pembaruan ACL apa pun. # Konektor pertemuan V2.0 Confluence adalah alat manajemen kerja kolaboratif yang dirancang untuk berbagi, menyimpan, dan mengerjakan perencanaan proyek, pengembangan perangkat lunak, dan manajemen produk. Anda dapat menggunakan Amazon Kendra untuk mengindeks ruang Confluence Anda, halaman (termasuk halaman bersarang), blog, dan komentar dan lampiran ke halaman dan blog yang diindeks. Untuk memecahkan masalah konektor sumber data Amazon Kendra Confluence, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-v2-confluence) + [Prasyarat](#prerequisites-v2-confluence) + [Instruksi koneksi](#data-source-procedure-v2-confluence) ## Fitur yang didukung Amazon Kendra Konektor sumber data pertemuan mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Pola inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Confluence Anda, buat perubahan ini di Confluence dan akun Anda. AWS **Di Confluence, pastikan Anda memiliki:** + Menyalin URL instans Confluence Anda. Misalnya:*https://example.confluence.com*, atau*https://www.example.confluence.com/*, atau*https:// atlassian.net/*. Anda memerlukan URL instans Confluence untuk terhubung. Amazon Kendra Jika Anda menggunakan Confluence Cloud, URL host Anda harus diakhiri dengan. *atlassian.net/* **catatan** Format URL berikut **tidak** didukung: *https://example.confluence.com/xyz* *https://www.example.confluence.com//wiki/spacekey/xxx* *https://atlassian.net/xyz* **catatan** (On-premise/server) Amazon Kendra memeriksa apakah informasi titik akhir yang disertakan sama dengan informasi titik akhir yang AWS Secrets Manager ditentukan dalam detail konfigurasi sumber data Anda. Ini membantu melindungi dari [masalah wakil yang membingungkan](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html), yang merupakan masalah keamanan di mana pengguna tidak memiliki izin untuk melakukan tindakan tetapi menggunakan Amazon Kendra sebagai proxy untuk mengakses rahasia yang dikonfigurasi dan melakukan tindakan. Jika nanti Anda mengubah informasi titik akhir Anda, Anda harus membuat rahasia baru untuk menyinkronkan informasi ini. + Kredensyal otentikasi dasar yang dikonfigurasi yang berisi nama pengguna (ID email yang digunakan untuk masuk ke Confluence) dan kata sandi (Token Confluence API sebagai kata sandi). Lihat [Mengelola token API untuk akun Atlassian](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/#Create-an-API-token) Anda. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **Opsional:** Kredensi OAuth 2.0 yang dikonfigurasi yang berisi kunci aplikasi Confluence, rahasia aplikasi Confluence, token akses Confluence, dan token penyegaran Confluence untuk memungkinkan Anda terhubung ke instans Confluence Anda. Amazon Kendra Jika token akses Anda kedaluwarsa, Anda dapat menggunakan token penyegaran untuk membuat ulang token akses dan menyegarkan pasangan token. Atau, Anda dapat mengulangi proses otorisasi. Untuk informasi selengkapnya tentang token akses, lihat [Mengelola token OAuth akses](https://support.atlassian.com/confluence-cloud/docs/manage-oauth-access-tokens/). + (Hanya untuk Confluence Server/Data Center) **Opsional:** Mengkonfigurasi Token Akses Pribadi (PAT) di Confluence. Lihat [Menggunakan Token Akses Pribadi](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html). **Di dalam Anda Akun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebut IAM . **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benar AWS Secrets Manager . + Menyimpan kredensi otentikasi Confluence Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data Confluence Anda. Amazon Kendra Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Confluence Anda, Anda harus memberikan rincian yang diperlukan dari sumber data Confluence Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Confluence untuk Amazon Kendra lihat. [Prasyarat](#prerequisites-v2-confluence) ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Confluence** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Add data source**, pilih **Confluence connector**, lalu pilih **Add** connector. Jika menggunakan versi 2 (jika ada), pilih **konektor Confluence** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. Di **Source**, pilih **Confluence Cloud atau ** Server/Data Confluence**** Center. 1. URL **Confluence —Masukkan URL** host Confluence. Misalnya, *https://example.confluence.com*. 1. (Hanya untuk Confluence Server/Data Center) **Lokasi sertifikat SSL - *opsional*** —Masukkan Amazon S3 jalur ke file sertifikat SSL Anda untuk Confluence Server. 1. (Hanya untuk Confluence Server/Data Center) **Proxy web - *opsional*** —Masukkan nama host proxy web (tanpa `https://` protokol `http://` atau) dan nomor port (port yang digunakan oleh protokol transport URL host). Nomor port harus berupa nilai numerik antara 0 dan 65535. 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. **Otentikasi** **—Pilih otentikasi **Dasar, otentikasi** **Oauth 2.0, atau (Hanya untuk Pusat Konfluensi Server/Data ) otentikasi** Token Akses Pribadi.** 1. **AWS Secrets Manager rahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensi otentikasi Confluence Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. Masukkan informasi berikut di jendela: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-Confluence-' secara otomatis ditambahkan ke nama rahasia Anda. 1. Jika menggunakan **Otentikasi Dasar** —Masukkan nama rahasia, nama pengguna, dan kata sandi (Token Confluence API sebagai kata sandi) yang Anda konfigurasikan di Confluence. Jika menggunakan **Otentikasi OAuth2 .0** —Masukkan nama rahasia, kunci aplikasi, rahasia aplikasi, token akses, dan token penyegaran yang Anda konfigurasikan di Confluence. (Hanya Server/Data Pusat Konfluensi) Jika menggunakan **otentikasi Token Akses Pribadi —Masukkan nama rahasia dan token** Confluence yang Anda konfigurasikan di Confluence Anda. 1. Simpan dan tambahkan rahasia Anda. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. 1. **IAM peran** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAM peran yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Dalam **lingkup Sinkronisasi**, untuk **Sinkronkan konten** —Pilih untuk menyinkronkan dari jenis konten berikut: Halaman, komentar halaman, lampiran halaman, blog, komentar blog, lampiran blog, ruang pribadi, dan ruang yang diarsipkan. **catatan** **Komentar halaman dan lampiran halaman hanya dapat dipilih jika Anda memilih untuk menyinkronkan Halaman.** **Komentar blog dan lampiran blog hanya dapat dipilih jika Anda memilih untuk menyinkronkan Blog.** **penting** Jika Anda tidak menentukan pola regex kunci spasi dalam **konfigurasi Tambahan**, semua halaman dan blog akan dirayapi secara default. 1. Dalam **Konfigurasi tambahan**, untuk **Ukuran file maksimum** —Tentukan batas ukuran file MBs yang Amazon Kendra akan dirayapi. Amazon Kendra akan merayapi hanya file dalam batas ukuran yang Anda tentukan. Ukuran file default adalah 50 MB. Ukuran file maksimum harus lebih besar dari 0 MB dan kurang dari atau sama dengan 50 MB. Untuk **pola regex Spaces** —Tentukan apakah akan menyertakan atau mengecualikan spasi tertentu dalam indeks Anda menggunakan: + Tombol spasi (misalnya,*my-space-123*) **catatan** Jika Anda tidak menentukan pola regex kunci spasi, semua halaman dan blog akan dirayapi secara default. + URL (misalnya,*.\$1/MySite/MyDocuments/*) + Jenis file (misalnya,*.\$1\$1.pdf, .\$1\$1.txt*) Untuk **pola regex judul Entitas** —Tentukan pola ekspresi reguler untuk menyertakan atau mengecualikan blog, halaman, komentar, dan lampiran tertentu berdasarkan judul. **catatan** Jika Anda ingin menyertakan atau mengecualikan perayapan halaman atau subhalaman tertentu, Anda dapat menggunakan pola regex judul halaman. 1. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda. Untuk menambahkan bidang sumber data kustom, buat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Confluence** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-confluence-schema) menggunakan API. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `CONFLUENCEV2` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **URL Host** —Tentukan instance URL host Confluence. Misalnya, *https://example.confluence.com*. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Jenis otentikasi** —Tentukan jenis otentikasi, apakah, `Basic``OAuth2`, (hanya Server Confluence). `Personal-token` + (Opsional—Hanya untuk Confluence Server) **Lokasi sertifikat SSL —Spesifik dan yang Anda gunakan untuk menyimpan sertifikat** SSL Anda. `S3bucketName` `s3certificateName` + **Rahasia Nama Sumber Daya Amazon (ARN) —Berikan** Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi yang Anda konfigurasikan di Confluence. Jika Anda menggunakan otentikasi dasar, rahasia disimpan dalam struktur JSON dengan kunci berikut: ``` { "username": "email ID or user name", "password": "Confluence API token" } ``` Jika Anda menggunakan otentikasi OAuth 2.0, rahasia disimpan dalam struktur JSON dengan kunci berikut: ``` { "confluenceAppKey": "app key", "confluenceAppSecret": "app secret", "confluenceAccessToken": "access token", "confluenceRefreshToken": "refresh token" } ``` (Hanya untuk Confluence Server) Jika Anda menggunakan otentikasi dasar, rahasia disimpan dalam struktur JSON dengan kunci berikut: ``` { "hostUrl": "Confluence Server host URL", "username": "Confluence Server user name", "password": "Confluence Server password" } ``` (Hanya untuk Server Confluence) Jika Anda menggunakan otentikasi Token Akses Pribadi, rahasia disimpan dalam struktur JSON dengan kunci berikut: ``` { "hostUrl": "Confluence Server host URL", "patToken": "personal access token" } ``` + **IAM peran** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Confluence dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAM peran untuk sumber data Confluence](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Ukuran file** —Tentukan ukuran file maximun untuk dirayapi. + **Jenis dokumen/konten** —Tentukan apakah akan merayapi halaman, komentar halaman, lampiran halaman, blog, komentar blog, lampiran blog, spasi, dan ruang yang diarsipkan. + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan spasi, halaman, blog, serta komentar dan lampirannya tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Web proxy** —Tentukan informasi proxy web Anda jika Anda ingin terhubung ke instance URL Confluence Anda melalui proxy web. Anda dapat menggunakan opsi ini untuk Confluence Server. + **Daftar kontrol akses (ACL)** —Tentukan apakah akan merayapi informasi ACL untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). + **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Confluence Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat Skema template [Confluence.](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-confluence-schema) ------ ### Catatan + Token Akses Pribadi (PAT) tidak tersedia untuk Confluence Cloud. # Konektor pertemuan V1.0 Confluence adalah alat manajemen kerja kolaboratif yang dirancang untuk berbagi, menyimpan, dan mengerjakan perencanaan proyek, pengembangan perangkat lunak, dan manajemen produk. Anda dapat menggunakan Amazon Kendra untuk mengindeks ruang Confluence Anda, halaman (termasuk halaman bersarang), blog, dan komentar dan lampiran ke halaman dan blog yang diindeks. **catatan** Konektor pertemuan V1.0/ ConfluenceConfiguration API berakhir pada 2023. Kami merekomendasikan untuk bermigrasi ke atau menggunakan konektor Confluence V2.0/API. TemplateConfiguration Untuk memecahkan masalah konektor sumber data Amazon Kendra Confluence, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-v1-confluence) + [Prasyarat](#prerequisites-v1-confluence) + [Instruksi koneksi](#data-source-procedure-v1-confluence) + [Pelajari selengkapnya](#confluence-v1-learn-more) ## Fitur yang didukung Amazon Kendra Konektor sumber data pertemuan mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + (Hanya untuk Server Confluence) Virtual private cloud (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Confluence Anda, buat perubahan ini di Confluence dan akun Anda. AWS **Di Confluence, pastikan Anda memiliki:** + Memberikan Amazon Kendra izin untuk melihat semua konten dalam instance Confluence Anda dengan: + Amazon Kendra Membuat anggota `confluence-administrators` kelompok. + Memberikan izin situs-admin untuk semua ruang, blog, dan halaman yang ada. + Menyalin URL instance Confluence Anda. + **Untuk pengguna SSO (Single Sign-On):** Mengaktifkan **halaman Show on login** untuk nama pengguna dan kata sandi saat Anda mengonfigurasi metode Confluence **Authentication di Confluence Data Center.** + **Untuk Server Confluence** + Mencatat kredensyal otentikasi dasar Anda yang berisi nama pengguna dan kata sandi akun administratif Confluence Anda untuk terhubung. Amazon Kendra **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **Opsional:** Membuat token akses pribadi di akun Confluence Anda untuk terhubung. Amazon Kendra Untuk informasi selengkapnya, lihat [Dokumentasi pertemuan tentang pembuatan token akses pribadi](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html). + **Untuk Confluence Cloud** + Mencatat kredensyal otentikasi dasar Anda yang berisi nama pengguna dan kata sandi akun administratif Confluence Anda untuk terhubung. Amazon Kendra + Memeriksa setiap dokumen unik di Confluence dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam Anda Akun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebut IAM . **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benar AWS Secrets Manager . + Menyimpan kredensi otentikasi Confluence Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data Confluence Anda. Amazon Kendra Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Confluence Anda, Anda harus memberikan rincian kredenal Confluence Anda sehingga dapat mengakses data Anda. Amazon Kendra Jika Anda belum mengkonfigurasi Confluence untuk Amazon Kendra lihat. [Prasyarat](#prerequisites-v1-confluence) ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Confluence** 1. Masuk ke Konsol AWS Manajemen dan buka [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **Konektor Confluence V1.0**, lalu pilih **Tambahkan** sumber data. 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. Pilih antara **Confluence Cloud** dan **Confluence** Server. 1. Jika Anda memilih **Confluence Cloud**, masukkan informasi berikut: 1. URL **Confluence —URL** Pertemuan Anda. 1. **AWS Secrets Manager rahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensi otentikasi Confluence Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-Confluence-' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **Nama Pengguna** dan **Kata Sandi** —Masukkan nama pengguna dan kata sandi Confluence Anda. 1. Pilih **Simpan otentikasi.** 1. Jika Anda memilih **Confluence Server**, masukkan informasi berikut: 1. **URL Confluence —Nama pengguna** dan kata sandi Confluence Anda. 1. (Opsional) Untuk **proxy Web** masukkan informasi berikut: 1. **Nama host —Nama** host untuk akun Confluence Anda. 1. **Nomor port** —Port yang digunakan oleh protokol transport URL host. 1. **Untuk **Otentikasi**, Pilih **otentikasi Dasar** atau (hanya Server Confluence) Token Akses Pribadi.** 1. **AWS Secrets Manager rahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensi otentikasi Confluence Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-Confluence-' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **Nama Pengguna** dan **Kata Sandi** —Masukkan nilai kredensi otentikasi yang Anda konfigurasikan di Confluence. Jika menggunakan otentikasi dasar, gunakan nama pengguna Confluence Anda (ID email) dan kata sandi (token API). Jika menggunakan token akses pribadi, masukkan detail **Token Akses Pribadi** yang Anda konfigurasikan di akun Confluence. 1. Simpan dan tambahkan rahasia Anda. 1. **IAM peran** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAM peran yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Untuk **Sertakan ruang pribadi** dan **Sertakan ruang yang diarsipkan** —Pilih jenis ruang opsional untuk disertakan dalam sumber data ini. 1. Untuk **konfigurasi tambahan** —Tentukan pola ekspresi reguler untuk menyertakan atau mengecualikan konten tertentu. Anda dapat menambahkan hingga 100 pola. 1. Anda juga dapat memilih untuk **Merayapi lampiran dalam ruang yang dipilih**. 1. Di **Jadwal berjalan Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Untuk **Spasi**, **Halaman**, **Blog** —Pilih dari bidang sumber data default Amazon Kendra yang dihasilkan atau **Pemetaan bidang yang disarankan tambahan** untuk menambahkan bidang indeks. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Confluence** Anda harus menentukan yang berikut menggunakan [ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html)API: + **Versi Confluence** —Tentukan versi instance Confluence yang Anda gunakan sebagai atau. `CLOUD` `SERVER` + **Rahasia Nama Sumber Daya Amazon (ARN) —Berikan** Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensi otentikasi Confluence Anda. Jika Anda menggunakan Confluence Server, Anda dapat menggunakan nama pengguna dan kata sandi Confluence Anda, atau token akses pribadi Anda sebagai kredensyal otentikasi. Jika Anda menggunakan nama pengguna dan kata sandi Confluence sebagai kredensyal otentikasi, Anda menyimpan kredensyal berikut sebagai struktur JSON dalam rahasia Anda: Secrets Manager ``` { "username": "user name", "password": "password" } ``` Jika Anda menggunakan token akses pribadi untuk menghubungkan Confluence Server Amazon Kendra, Anda menyimpan kredensyal berikut sebagai struktur JSON dalam rahasia Anda: Secrets Manager ``` { "patToken": "personal access token" } ``` Jika Anda menggunakan Confluence Cloud, Anda menggunakan nama pengguna Confluence dan token API, yang dikonfigurasi di Confluence, sebagai kata sandi Anda. Anda menyimpan kredensyal berikut sebagai struktur JSON dalam rahasia Anda: Secrets Manager ``` { "username": "user name", "password": "API token" } ``` + **IAM peran** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Confluence dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAM peran untuk sumber data Confluence](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Web proxy** —Apakah akan terhubung ke instans URL Confluence Anda melalui proxy web. Anda dapat menggunakan opsi ini untuk Confluence Server. + (Hanya untuk Confluence Server) **Virtual Private Cloud (**VPC) `VpcConfiguration` —Tentukan sebagai bagian dari konfigurasi sumber data. Lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html). + **Filter inklusi dan pengecualian** —Tentukan pola ekspresi reguler untuk menyertakan atau mengecualikan spasi, posting blog, halaman, spasi, dan lampiran tertentu. Jika Anda memilih untuk mengindeks lampiran, hanya lampiran ke halaman dan blog terindeks yang akan diindeks. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Confluence Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. + **Pemfilteran konteks pengguna dan kontrol akses** —Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Confluence Anda, lihat: + [Mengkonfigurasi konektor Amazon Kendra Confluence Server Anda](https://aws.amazon.com/blogs/machine-learning/configuring-your-amazon-kendra-confluence-server-connector/) # Konektor sumber data khusus Gunakan sumber data kustom ketika Anda memiliki repositori yang Amazon Kendra belum menyediakan konektor sumber data untuk. Anda dapat menggunakannya untuk melihat metrik riwayat proses yang sama yang disediakan sumber Amazon Kendra data bahkan ketika Anda tidak dapat menggunakan Amazon Kendra sumber data untuk menyinkronkan repositori Anda. Gunakan ini untuk membuat pengalaman pemantauan sinkronisasi yang konsisten antara sumber Amazon Kendra data dan sumber khusus. Secara khusus, gunakan sumber data khusus untuk melihat metrik sinkronisasi untuk konektor sumber data yang Anda buat menggunakan [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)dan [BatchDeleteDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchDeleteDocument.html) APIs. Untuk memecahkan masalah konektor sumber data kustom Amazon Kendra, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) Saat Anda membuat sumber data kustom, Anda memiliki kontrol penuh atas bagaimana dokumen yang akan diindeks dipilih. Amazon Kendra hanya menyediakan informasi metrik yang dapat Anda gunakan untuk memantau pekerjaan sinkronisasi sumber data Anda. Anda harus membuat dan menjalankan crawler yang menentukan dokumen yang diindeks sumber data Anda. Anda harus menentukan judul utama dokumen Anda menggunakan objek [Dokumen](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Document.html), dan `_source_uri` untuk memiliki `DocumentTitle` dan `DocumentURI` termasuk dalam respons `Query` hasil. [DocumentAttribute](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DocumentAttribute.html) Anda membuat pengenal untuk sumber data kustom Anda menggunakan konsol atau dengan menggunakan [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html)API. Untuk menggunakan konsol tersebut, beri nama sumber data Anda, serta deskripsi dan tanda sumber daya, jika perlu. Setelah sumber data dibuat, ID sumber data ditampilkan. Salin ID ini untuk digunakan saat Anda menyinkronkan sumber data dengan indeks. ![\[Form for specifying data source details, including name, description, and optional tags.\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/images/CustomDataSource.png) Anda juga dapat membuat sumber data kustom menggunakan `CreateDataSource` API. API mengembalikan ID yang akan digunakan saat Anda menyinkronkan sumber data. Bila Anda menggunakan `CreateDataSource` API untuk membuat sumber data kustom, Anda tidak dapat mengatur`Configuration`, `RoleArn` atau `Schedule` parameter. Jika Anda mengatur parameter ini, Amazon Kendra mengembalikan `ValidationException` pengecualian. Untuk menggunakan sumber data khusus, buat aplikasi yang bertanggung jawab untuk memperbarui Amazon Kendra indeks. Aplikasi tersebut bergantung pada crawler yang Anda buat. Crawler membaca dokumen di repositori Anda dan menentukan mana yang harus dikirim. Amazon Kendra Aplikasi Anda harus melakukan langkah-langkah berikut: 1. Crawl repositori Anda dan buat daftar dokumen di repositori Anda yang ditambahkan, diperbarui, atau dihapus. 1. Panggil [StartDataSourceSyncJob](https://docs.aws.amazon.com/kendra/latest/APIReference/API_StartDataSourceSyncJob.html)API untuk memberi sinyal bahwa pekerjaan sinkronisasi dimulai. Anda memberikan ID sumber data untuk mengidentifikasi sumber data yang disinkronkan. Amazon Kendra mengembalikan ID eksekusi untuk mengidentifikasi pekerjaan sinkronisasi tertentu. 1. Panggil [BatchDeleteDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchDeleteDocument.html)API untuk menghapus dokumen dari indeks. Berikan ID sumber data dan ID eksekusi untuk mengidentifikasi sumber data yang sedang disinkronkan dan tugas yang terkait dengan pembaruan ini. 1. Panggil [StopDataSourceSyncJob](https://docs.aws.amazon.com/kendra/latest/APIReference/API_StopDataSourceSyncJob.html)API untuk memberi sinyal akhir dari pekerjaan sinkronisasi. Setelah Anda memanggil `StopDataSourceSyncJob` API, ID eksekusi terkait tidak lagi valid. 1. Panggil [ListDataSourceSyncJobs](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ListDataSourceSyncJobs.html)API dengan pengenal indeks dan sumber data untuk mencantumkan pekerjaan sinkronisasi sumber data dan untuk melihat metrik untuk pekerjaan sinkronisasi. Setelah menyelesaikan tugas sinkronisasi, Anda dapat memulai tugas sinkronisasi baru. Mungkin perlu waktu beberapa lama sebelum semua dokumen yang dikirim ditambahkan ke indeks. Gunakan `ListDataSourceSyncJobs` API untuk melihat status pekerjaan sinkronisasi. Jika `Status` yang dikembalikan untuk tugas sinkronisasi adalah `SYNCING_INDEXING`, beberapa dokumen masih diindeks. Anda dapat memulai pekerjaan sinkronisasi baru ketika status pekerjaan sebelumnya adalah `FAILED` atau`SUCCEEDED`. Setelah memanggil `StopDataSourceSyncJob` API, Anda tidak dapat menggunakan pengenal pekerjaan sinkronisasi dalam panggilan ke `BatchPutDocument` or `BatchDeleteDocument` APIs. Jika Anda melakukannya, semua dokumen yang dikirimkan akan dikembalikan dalam pesan `FailedDocuments` respons dari API. ## Atribut yang diperlukan Saat Anda mengirimkan dokumen untuk Amazon Kendra menggunakan `BatchPutDocument` API, setiap dokumen memerlukan dua atribut untuk mengidentifikasi sumber data dan menjalankan sinkronisasi yang dimilikinya. Anda harus memberikan dua atribut berikut untuk memetakan dokumen dari sumber data kustom Anda dengan benar ke Amazon Kendra indeks: + `_data_source_id`—Pengidentifikasi sumber data. Ini dikembalikan saat Anda membuat sumber data dengan konsol atau `CreateDataSource` API. + `_data_source_sync_job_execution_id`—Pengidentifikasi proses sinkronisasi. Ini dikembalikan saat Anda memulai sinkronisasi indeks dengan `StartDataSourceSyncJob` API. Berikut ini adalah JSON yang diperlukan untuk indeks dokumen menggunakan sumber data kustom. ``` { "Documents": [ { "Attributes": [ { "Key": "_data_source_id", "Value": { "StringValue": "data source identifier" } }, { "Key": "_data_source_sync_job_execution_id", "Value": { "StringValue": "sync job identifier" } } ], "Blob": "document content", "ContentType": "content type", "Id": "document identifier", "Title": "document title" } ], "IndexId": "index identifier", "RoleArn": "IAM role ARN" } ``` Saat Anda menghapus dokumen dari indeks menggunakan `BatchDeleteDocument` API, Anda perlu menentukan dua bidang berikut dalam `DataSourceSyncJobMetricTarget` parameter: + `DataSourceId`—Pengidentifikasi sumber data. Ini dikembalikan saat Anda membuat sumber data dengan konsol atau `CreateDataSource` API. + `DataSourceSyncJobId`—Pengidentifikasi proses sinkronisasi. Ini dikembalikan saat Anda memulai sinkronisasi indeks dengan `StartDataSourceSyncJob` API. Berikut ini adalah JSON yang diperlukan untuk menghapus dokumen dari indeks menggunakan `BatchDeleteDocument` API. ``` { "DataSourceSyncJobMetricTarget": { "DataSourceId": "data source identifier", "DataSourceSyncJobId": "sync job identifier" }, "DocumentIdList": [ "document identifier" ], "IndexId": "index identifier" } ``` ## Melihat metrik Setelah pekerjaan sinkronisasi selesai, Anda dapat menggunakan [DataSourceSyncJobMetrics](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DataSourceSyncJobMetrics.html)API untuk mendapatkan metrik yang terkait dengan pekerjaan sinkronisasi. Gunakan ini untuk memantau sinkronisasi sumber data kustom Anda. Jika Anda mengirimkan dokumen yang sama beberapa kali, baik sebagai bagian dari `BatchPutDocument` API, `BatchDeleteDocument` API, atau jika dokumen dikirimkan untuk penambahan dan penghapusan, dokumen hanya dihitung satu kali dalam metrik. + `DocumentsAdded`—Jumlah dokumen yang dikirimkan menggunakan `BatchPutDocument` API yang terkait dengan pekerjaan sinkronisasi ini ditambahkan ke indeks untuk pertama kalinya. Jika dokumen dikirimkan untuk penambahan lebih dari sekali dalam sinkronisasi, dokumen hanya dihitung satu kali dalam metrik. + `DocumentsDeleted`—Jumlah dokumen yang dikirimkan menggunakan `BatchDeleteDocument` API yang terkait dengan pekerjaan sinkronisasi ini dihapus dari indeks. Jika dokumen dikirimkan untuk penghapusan lebih dari sekali dalam sinkronisasi, dokumen hanya dihitung satu kali dalam metrik. + `DocumentsFailed`—Jumlah dokumen yang terkait dengan pekerjaan sinkronisasi ini yang gagal pengindeksan. Ini adalah dokumen yang diterima oleh Amazon Kendra untuk pengindeksan tetapi tidak dapat diindeks atau dihapus. Jika dokumen tidak diterima oleh Amazon Kendra, pengenal untuk dokumen dikembalikan dalam properti `FailedDocuments` respon `BatchPutDocument` dan `BatchDeleteDocument` APIs. + `DocumentsModified`—Jumlah dokumen yang dimodifikasi yang dikirimkan menggunakan `BatchPutDocument` API yang terkait dengan pekerjaan sinkronisasi ini yang dimodifikasi dalam Amazon Kendra indeks. Amazon Kendra juga memancarkan Amazon CloudWatch metrik saat mengindeks dokumen. Untuk informasi lebih lanjut, lihat [Memantau Amazon Kendra dengan Amazon CloudWatch](https://docs.aws.amazon.com/kendra/latest/dg/cloudwatch-metrics.html). Amazon Kendra tidak mengembalikan `DocumentsScanned` metrik untuk sumber data khusus. Ini juga memancarkan CloudWatch metrik yang tercantum dalam dokumen [Metrik untuk Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/cloudwatch-metrics.html#cloudwatch-metrics-data-source) sumber data. ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data kustom Anda, lihat: + [Menambahkan sumber data khusus ke Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/adding-custom-data-sources-to-amazon-kendra/) # Sumber data kustom (Java) Kode berikut memberikan contoh implementasi sumber data kustom menggunakan Java. Program pertama membuat sumber data kustom dan kemudian menyinkronkan dokumen yang baru ditambahkan ke indeks dengan sumber data kustom. Kode berikut menunjukkan pembuatan dan penggunaan sumber data kustom. Bila Anda menggunakan sumber data kustom dalam aplikasi Anda, Anda tidak perlu membuat sumber data baru (proses satu kali) setiap kali Anda menyinkronkan indeks Anda dengan sumber data Anda. Anda menggunakan ID indeks dan ID sumber data untuk menyinkronkan data Anda. ``` package com.amazonaws.kendra; import java.util.concurrent.TimeUnit; import software.amazon.awssdk.services.kendra.KendraClient; import csoftware.amazon.awssdk.services.kendra.model.BatchPutDocumentRequest; import csoftware.amazon.awssdk.services.kendra.model.BatchPutDocumentResponse; import software.amazon.awssdk.services.kendra.model.CreateDataSourceRequest; import software.amazon.awssdk.services.kendra.model.CreateDataSourceResponse; import software.amazon.awssdk.services.kendra.model.DataSourceType; import software.amazon.awssdk.services.kendra.model.Document; import software.amazon.awssdk.services.kendra.model.ListDataSourceSyncJobsRequest; import software.amazon.awssdk.services.kendra.model.ListDataSourceSyncJobsResponse; import software.amazon.awssdk.services.kendra.model.StartDataSourceSyncJobRequest; import software.amazon.awssdk.services.kendra.model.StartDataSourceSyncJobResponse; import software.amazon.awssdk.services.kendra.model.StopDataSourceSyncJobRequest; import software.amazon.awssdk.services.kendra.model.StopDataSourceSyncJobResponse; public class SampleSyncForCustomDataSource { public static void main(String[] args) { KendraClient kendra = KendraClient.builder().build(); String myIndexId = "yourIndexId"; String dataSourceName = "custom data source"; String dataSourceDescription = "Amazon Kendra custom data source connector" // Create custom data source CreateDataSourceRequest createDataSourceRequest = CreateDataSourceRequest .builder() .indexId(myIndexId) .name(dataSourceName) .description(dataSourceDescription) .type(DataSourceType.CUSTOM) .build(); CreateDataSourceResponse createDataSourceResponse = kendra.createDataSource(createDataSourceRequest); System.out.println(String.format("Response of creating data source: %s", createDataSourceResponse)); // Get the data source ID from createDataSourceResponse String dataSourceId = createDataSourceResponse.Id(); // Wait for the custom data source to become active System.out.println(String.format("Waiting for Amazon Kendra to create the data source %s", dataSourceId)); // You can use the DescribeDataSource API to check the status DescribeDataSourceRequest describeDataSourceRequest = DescribeDataSourceRequest .builder() .indexId(myIndexId) .id(dataSourceId) .build(); while (true) { DescribeDataSourceResponse describeDataSourceResponse = kendra.describeDataSource(describeDataSourceRequest); DataSourceStatus status = describeDataSourceResponse.status(); System.out.println(String.format("Creating data source. Status: %s", status)); if (status != DataSourceStatus.CREATING) { break; } TimeUnit.SECONDS.sleep(60); } // Start syncing yor data source by calling StartDataSourceSyncJob and providing your index ID // and your custom data source ID System.out.println(String.format("Synchronize the data source %s", dataSourceId)); StartDataSourceSyncJobRequest startDataSourceSyncJobRequest = StartDataSourceSyncJobRequest .builder() .indexId(myIndexId) .id(dataSourceId) .build(); StartDataSourceSyncJobResponse startDataSourceSyncJobResponse = kendra.startDataSourceSyncJob(startDataSourceSyncJobRequest); // Get the sync job execution ID from startDataSourceSyncJobResponse String executionId = startDataSourceSyncJobResponse.ExecutionId(); System.out.println(String.format("Waiting for the data source to sync with the index %s for execution ID %s", indexId, startDataSourceSyncJobResponse.executionId())); // Add 2 documents uploaded to S3 bucket to your index using the BatchPutDocument API // The added documents should sync with your custom data source Document pollyDoc = Document .builder() .s3Path( S3Path.builder() .bucket("amzn-s3-demo-bucket") .key("what_is_Amazon_Polly.docx") .build()) .title("What is Amazon Polly?") .id("polly_doc_1") .build(); Document rekognitionDoc = Document .builder() .s3Path( S3Path.builder() .bucket("amzn-s3-demo-bucket") .key("what_is_amazon_rekognition.docx") .build()) .title("What is Amazon rekognition?") .id("rekognition_doc_1") .build(); BatchPutDocumentRequest batchPutDocumentRequest = BatchPutDocumentRequest .builder() .indexId(myIndexId) .documents(pollyDoc, rekognitionDoc) .build(); BatchPutDocumentResponse result = kendra.batchPutDocument(batchPutDocumentRequest); System.out.println(String.format("BatchPutDocument result: %s", result)); // Once custom data source synced, stop the sync job using the StopDataSourceSyncJob API StopDataSourceSyncJobResponse stopDataSourceSyncJobResponse = kendra.stopDataSourceSyncJob( StopDataSourceSyncJobRequest() .indexId(myIndexId) .id(dataSourceId) ); // List your sync jobs ListDataSourceSyncJobsRequest listDataSourceSyncJobsRequest = ListDataSourceSyncJobsRequest .builder() .indexId(myIndexId) .id(dataSourceId) .build(); while (true) { ListDataSourceSyncJobsResponse listDataSourceSyncJobsResponse = kendra.listDataSourceSyncJobs(listDataSourceSyncJobsRequest); DataSourceSyncJob job = listDataSourceSyncJobsResponse.history().get(0); System.out.println(String.format("Status: %s", job.status())); } } } ``` # Dropbox Dropbox adalah layanan hosting file yang menawarkan penyimpanan cloud, organisasi dokumen, dan layanan template dokumen. Jika Anda pengguna Dropbox, Anda dapat menggunakannya Amazon Kendra untuk mengindeks file Dropbox, Dropbox Paper, Template Dropbox Paper, dan pintasan tersimpan ke halaman web. Anda juga dapat mengonfigurasi Amazon Kendra untuk mengindeks file Dropbox tertentu, Dropbox Paper, Template Dropbox Paper, dan pintasan tersimpan ke halaman web. Amazon Kendramendukung Dropbox dan Dropbox Advanced untuk Dropbox Business. Anda dapat terhubung Amazon Kendra ke sumber data Dropbox menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Untuk mengatasi masalah konektor sumber data Amazon Kendra Dropbox Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-dropbox) + [Prasyarat](#prerequisites-dropbox) + [Instruksi koneksi](#data-source-procedure-dropbox) + [Pelajari selengkapnya](#dropbox-learn-more) + [Catatan](#dropbox-notes) ## Fitur yang didukung Amazon KendraKonektor sumber data Dropbox mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum dapat digunakan Amazon Kendra untuk mengindeks sumber data Dropbox Anda, lakukan perubahan ini di Dropbox dan AWS akun Anda. **Di Dropbox, pastikan Anda memiliki:** + Membuat akun Dropbox Advanced dan menyiapkan pengguna admin. + Mengonfigurasi aplikasi Dropbox dengan **nama Aplikasi** unik, mengaktifkan **Scoped** Access. Lihat [dokumentasi Dropbox tentang membuat aplikasi](https://www.dropbox.com/developers/reference/getting-started#app%20console). + **Aktifkan izin Dropbox Lengkap** di konsol Dropbox dan menambahkan izin berikut: + file.content.read + files.metadata.read + berbagi.baca + file\$1requests.read + kelompok.baca + team\$1info.read + team\$1data.content.read + Mencatat kunci aplikasi Dropbox Anda, rahasia aplikasi Dropbox, dan token akses Dropbox untuk kredensi otentikasi dasar. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + Mengonfigurasi dan menyalin token akses Oauth 2.0 sementara untuk aplikasi Dropbox Anda. Token ini bersifat sementara dan kedaluwarsa setelah 4 jam. Lihat [dokumentasi Dropbox tentang OAuth autentikasi](https://developers.dropbox.com/oauth-guide). **catatan** Anda disarankan untuk membuat token akses penyegaran Dropbox yang tidak pernah kedaluwarsa, alih-alih mengandalkan token akses satu kali yang kedaluwarsa setelah 4 jam. Token akses penyegaran bersifat permanen dan tidak pernah kedaluwarsa sehingga Anda dapat terus menyinkronkan sumber data Anda di masa mendatang. + **Direkomendasikan:** Mengonfigurasi token penyegaran permanen Dropbox yang tidak pernah kedaluwarsa untuk memungkinkan Amazon Kendra untuk terus menyinkronkan sumber data Anda tanpa gangguan apa pun. Lihat [dokumentasi Dropbox tentang token penyegaran](https://developers.dropbox.com/oauth-guide). + Memeriksa setiap dokumen unik di Dropbox dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi Dropbox Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasianya. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data Dropbox Anda. Amazon Kendra Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Dropbox Anda, Anda harus memberikan rincian yang diperlukan dari sumber data Dropbox Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengonfigurasi DropboxAmazon Kendra, lihat[Prasyarat](#prerequisites-dropbox). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Dropbox** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambah sumber data**, pilih **konektor Dropbox**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Dropbox dengan tag** “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen menggantikan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. **Jenis token otentikasi** —Pilih token permanen (disarankan) atau token akses sementara. 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensi otentikasi Dropbox Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-Dropbox-' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **kunci Aplikasi**, **Rahasia aplikasi**, dan informasi token (permanen atau sementara) —Masukkan nilai kredensi otentikasi yang dikonfigurasi di Dropbox. 1. Simpan dan tambahkan rahasia Anda. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Untuk **Pilih entitas atau jenis konten** —Pilih entitas Dropbox atau jenis konten yang ingin dirayapi. 1. Dalam **konfigurasi tambahan** untuk pola **Regex —Tambahkan pola** ekspresi reguler untuk menyertakan atau mengecualikan file tertentu. 1. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. **Templat **file**, **Dropbox Paper**, dan Dropbox Paper** —Pilih dari bidang sumber data default Amazon Kendra yang dihasilkan yang ingin Anda petakan ke indeks Anda. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Dropbox** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-dropbox-schema) menggunakan API. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `DROPBOX` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Juga tentukan sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Jenis token akses** —Tentukan apakah Anda ingin menggunakan token akses permanen atau sementara untuk AWS Secrets Manager rahasia Anda yang menyimpan krednetial otentikasi Anda. **catatan** Anda disarankan untuk membuat token akses penyegaran yang tidak pernah kedaluwarsa di Dropbox daripada mengandalkan token akses satu kali yang kedaluwarsa setelah 4 jam. Anda membuat aplikasi dan token akses refresh di konsol pengembang Dropbox dan menyediakan token akses dalam rahasia Anda. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensi otentikasi untuk akun Dropbox Anda. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "appKey": "Dropbox app key", "appSecret": "Dropbox app secret", "accesstoken": "temporary access token or refresh access token" } ``` + **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Dropbox dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Dropbox](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Jenis dokumen/konten** —Tentukan apakah akan merayapi file di Dropbox, dokumen Dropbox Paper, templat Dropbox Paper, dan pintasan halaman web yang disimpan di Dropbox Anda. + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan file tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Daftar kontrol akses (ACL)** —Tentukan apakah akan merayapi informasi ACL untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Dropbox Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat Skema [templat Dropbox](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-dropbox-schema). ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Dropbox Anda, lihat: + [Indeks konten Dropbox Anda menggunakan konektor Dropbox untuk Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/index-your-dropbox-content-using-the-dropbox-connector-for-amazon-kendra/) ## Catatan + Saat Daftar Kontrol Akses (ACLs) diaktifkan, opsi “Sinkronkan hanya konten baru atau yang dimodifikasi” tidak tersedia karena keterbatasan API Dropbox. Sebaiknya gunakan mode “Sinkronisasi penuh” atau “Sinkronisasi konten baru, dimodifikasi, atau dihapus” sebagai gantinya, atau nonaktifkan ACLs jika Anda perlu menggunakan mode sinkronisasi ini. # Drupal **catatan** Konektor Drupal tetap didukung penuh untuk pelanggan yang sudah ada hingga 31 Mei 2026. Meskipun konektor ini tidak lagi tersedia untuk pengguna baru, pengguna saat ini dapat terus menggunakannya tanpa gangguan. Kami terus mengembangkan portofolio konektor kami untuk menawarkan solusi yang lebih terukur dan dapat disesuaikan. Untuk integrasi masa depan, sebaiknya jelajahi Amazon Kendra Custom Connector Framework [1], yang dirancang untuk mendukung rangkaian kasus penggunaan perusahaan yang lebih luas dengan fleksibilitas yang ditingkatkan. Drupal adalah sistem manajemen konten open-source (CMS) yang dapat Anda gunakan untuk membuat situs web dan aplikasi web. Anda dapat menggunakan Amazon Kendra untuk mengindeks berikut ini di Drupal: + Konten—Artikel, Halaman dasar, Blok dasar, Jenis konten yang ditentukan pengguna, Jenis blok yang ditentukan pengguna, Jenis konten khusus, Jenis blok kustom + Komentar—Untuk semua jenis Konten dan jenis Blok + Lampiran—Untuk semua jenis Konten dan jenis Blok Anda dapat terhubung Amazon Kendra ke sumber data Drupal Anda menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) atau [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber data Amazon Kendra Drupal Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-drupal) + [Prasyarat](#prerequisites-drupal) + [Instruksi koneksi](#data-source-procedure-drupal) + [Catatan](#drupal-notes) ## Fitur yang didukung Amazon KendraKonektor sumber data Drupal mendukung fitur-fitur berikut: + Pemetaan bidang + Pemfilteran konteks pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Drupal Anda, buat perubahan ini di Drupal dan AWS akun Anda. **Di Drupal, pastikan Anda memiliki:** + Membuat akun Drupal (Standard) Suite dan pengguna dengan peran administrator. + Menyalin nama situs Drupal Anda dan mengkonfigurasi url host. Misalnya, *https:///*. + Kredensial otentikasi dasar yang dikonfigurasi yang berisi nama pengguna (nama pengguna login situs web Drupal) dan kata sandi (kata sandi situs web Drupal). + **Direkomendasikan:** Dikonfigurasi token kredenal OAuth 2.0. Gunakan token ini bersama dengan pemberian kata sandi Drupal Anda, id klien, rahasia klien, nama pengguna (nama pengguna login situs web Drupal) dan kata sandi (kata sandi situs web Drupal) untuk terhubung. Amazon Kendra + Menambahkan izin berikut di akun Drupal Anda menggunakan peran administrator: + mengelola blok + mengelola tampilan block\$1content + mengelola bidang block\$1content + mengelola tampilan formulir block\$1content + mengelola pandangan + melihat alamat email pengguna + melihat konten yang tidak dipublikasikan sendiri + lihat revisi halaman + lihat revisi artikel + lihat semua revisi + melihat tema administrasi + mengakses konten + akses ikhtisar konten + akses komentar + konten pencarian + ikhtisar file akses + mengakses tautan kontekstual **catatan** Jika ada jenis konten yang ditentukan pengguna atau jenis blok yang ditentukan pengguna, atau tampilan dan blok apa pun ditambahkan ke situs web Drupal, mereka harus dilengkapi dengan akses administrator. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi Drupal Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasianya. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data Drupal Anda. Amazon Kendra Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Drupal Anda, Anda harus memberikan rincian kredenal Drupal Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Drupal untuk Amazon Kendra lihat[Prasyarat](#prerequisites-drupal). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Drupal** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambah sumber data**, pilih **konektor Drupal**, dan kemudian pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Drupal dengan tag** “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. Di **Sumber**, untuk **URL Host —URL** host situs Drupal Anda. Misalnya, *https:///*. 1. Untuk **lokasi sertifikat SSL** —Masukkan jalur ke sertifikat SSL yang disimpan di bucket Anda. Amazon S3 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. Untuk **Otentikasi** —Pilih antara **otentikasi Dasar dan otentikasi OAuth ** **2.0 berdasarkan kasus** penggunaan Anda. 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensi otentikasi Drupal Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. Jika Anda memilih **otentikasi Dasar**, masukkan **Nama Rahasia, Nama** **Pengguna, (nama pengguna** situs Drupal), dan **Kata Sandi (kata sandi** situs Drupal) yang Anda salin dan pilih **Simpan** dan tambahkan rahasia. 1. Jika Anda memilih **otentikasi OAuth 2.0**, masukkan **Nama Rahasia, Nama** pengguna (**nama pengguna** situs Drupal), **Kata Sandi (kata sandi** situs Drupal), **ID Klien, dan **rahasia Klien**** yang dihasilkan di akun Drupal Anda dan pilih **Simpan** dan tambahkan rahasia. 1. Pilih **Simpan**. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. 1. **IAMperan** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Untuk **cakupan Sinkronisasi**, pilih dari opsi berikut: **catatan** Saat Anda memilih untuk merayapi **Artikel**, **Halaman dasar**, dan **Blok dasar**, bidang default-nya akan disinkronkan secara otomatis. Anda juga dapat memilih untuk menyinkronkan komentar, lampiran, bidang kustom, dan entitas kustom lainnya. 1. Untuk **entitas Pilih**: + **Artikel** **—Pilih apakah akan merayapi **Artikel**, komentar mereka **Komentar**, dan Lampirannya.** + **Halaman dasar** **—Pilih apakah akan merayapi **halaman Dasar**, **Komentar**, dan Lampirannya.** + **Blok dasar** **—Pilih apakah akan merayapi **blok Dasar**, **Komentar**, dan Lampirannya.** + Anda juga dapat memilih untuk menambahkan **jenis konten Kustom** dan **Blok Kustom**. 1. Untuk **konfigurasi Tambahan - opsional**: + Untuk pola **Regex —Tambahkan pola** ekspresi reguler untuk menyertakan atau mengecualikan judul entitas dan nama file tertentu. Anda dapat menambahkan hingga 100 pola. 1. **Mode sinkronisasi** —Pilih cara Anda ingin memperbarui indeks saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Dalam **jadwal berjalan Sync**, **Frekuensi** —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Untuk **Isi**, **Komentar**, dan **Lampiran** —Pilih dari bidang sumber data default Amazon Kendra yang dihasilkan yang ingin Anda petakan ke indeks Anda. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Drupal** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-drupal-schema) menggunakan API. [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `DRUPAL` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN) —Berikan** Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensi otentikasi yang Anda buat di akun Drupal Anda. Jika Anda menggunakan otentikasi dasar, rahasia disimpan dalam struktur JSON dengan kunci berikut: ``` { "username": "user name", "password": "password" } ``` Jika Anda menggunakan otentikasi OAuth 2.0, rahasia disimpan dalam struktur JSON dengan kunci berikut: ``` { "username": "user name", "password": "password", "clientId": "client id", "clientSecret": "client secret" } ``` **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Drupal dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Drupal](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan konten, komentar, dan lampiran. Anda juga dapat menentukan pola ekspresi reguler untuk menyertakan atau mengecualikan konten, komentar, dan lampiran. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Drupal Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat[Skema template Drupal](ds-schemas.md#ds-drupal-schema). ------ ## Catatan + Drupal tidak APIs memiliki batas pembatasan resmi. + Java tidak SDKs tersedia untuk Drupal. + Data Drupal dapat diambil hanya menggunakan JSON API asli. + Jenis konten yang tidak terkait dengan **Tampilan** Drupal tidak dapat dirayapi. + **Anda memerlukan akses administrator untuk merayapi data dari Blok Drupal.** + Tidak ada JSON API yang tersedia untuk membuat tipe konten yang ditentukan pengguna menggunakan kata kerja HTTP. + Badan dokumen dan komentar untuk **Artikel**, **halaman Dasar**, **Blok dasar**, jenis konten yang ditentukan pengguna, dan jenis blok yang ditentukan pengguna, ditampilkan dalam format HTML. Jika konten HTML tidak terbentuk dengan baik, maka tag terkait HTML akan muncul di badan dokumen dan komentar dan akan terlihat di hasil Amazon Kendra pencarian. + Jenis konten dan jenis **Blok** tanpa deskripsi atau isi tidak akan dicernaAmazon Kendra. Hanya **Komentar** dan **Lampiran** dari jenis **Konten** atau **Blok** tersebut yang akan dimasukkan ke dalam indeks AndaAmazon Kendra. # GitHub GitHub adalah layanan hosting berbasis web untuk pengembangan perangkat lunak yang menyediakan penyimpanan kode dan layanan manajemen dengan kontrol versi. Anda dapat menggunakan Amazon Kendra untuk mengindeks file repositori GitHub Enterprise Cloud (SaaS) dan GitHub Enterprise Server (On Prem), mengeluarkan dan menarik permintaan, mengeluarkan dan menarik komentar permintaan, dan mengeluarkan dan menarik lampiran komentar permintaan. Anda juga dapat memilih untuk menyertakan atau mengecualikan file tertentu. **catatan** Amazon Kendrasekarang mendukung GitHub konektor yang ditingkatkan. Konsol telah ditingkatkan secara otomatis untuk Anda. Konektor baru apa pun yang Anda buat di konsol akan menggunakan arsitektur yang ditingkatkan. Jika Anda menggunakan API, Anda sekarang harus menggunakan [https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objek alih-alih `GitHubConfiguration` objek untuk mengonfigurasi konektor Anda. Konektor yang dikonfigurasi menggunakan konsol lama dan arsitektur API akan terus berfungsi seperti yang dikonfigurasi. Namun, Anda tidak akan dapat mengedit atau memperbaruinya. Jika Anda ingin mengedit atau memperbarui konfigurasi konektor Anda, Anda harus membuat konektor baru. Kami merekomendasikan untuk memigrasikan alur kerja konektor Anda ke versi yang ditingkatkan. Support untuk konektor yang dikonfigurasi menggunakan arsitektur lama dijadwalkan berakhir pada Juni 2024. Anda dapat terhubung Amazon Kendra ke sumber GitHub data menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber Amazon Kendra GitHub data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-github) + [Prasyarat](#prerequisites-github) + [Instruksi koneksi](#data-source-procedure-github) + [Pelajari selengkapnya](#github-learn-more) ## Fitur yang didukung Amazon KendraGitHub konektor sumber data mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber GitHub data Anda, buat perubahan ini di akun GitHub dan AWS akun Anda. **Di GitHub, pastikan Anda memiliki:** + Membuat GitHub pengguna dengan izin administratif untuk GitHub organisasi. + Mengonfigurasi token akses pribadi di Git Hub untuk digunakan sebagai kredensi otentikasi Anda. Lihat [GitHub dokumentasi tentang membuat token akses pribadi](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token). **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **Direkomendasikan:** Mengonfigurasi OAuth token untuk kredensi otentikasi. Gunakan OAuth token untuk batas throttle API dan kinerja konektor yang lebih baik. Lihat [GitHub dokumentasi tentang OAuth otorisasi](https://docs.github.com/en/rest/apps/oauth-applications?apiVersion=2022-11-28#about-oauth-apps-and-oauth-authorizations-of-github-apps). + Mencatat URL GitHub host untuk jenis GitHub layanan yang Anda gunakan. Misalnya, URL host untuk GitHub cloud bisa jadi *https://api.github.com* dan URL host untuk GitHub server bisa*https://on-prem-host-url/api/v3/*. + Mencatat nama organisasi Anda untuk GitHub akun GitHub Enterprise Cloud (SaaS) atau akun Server GitHub Perusahaan (lokal) yang ingin Anda sambungkan. Anda dapat menemukan nama organisasi Anda dengan masuk ke GitHub desktop dan memilih **Organisasi Anda** di bawah dropdown gambar profil Anda. + **Opsional (hanya server):** Menghasilkan sertifikat SSL dan menyalin jalur ke sertifikat yang disimpan dalam bucket. Amazon S3 Anda menggunakan ini untuk terhubung GitHub jika Anda memerlukan koneksi SSL yang aman. Anda cukup membuat sertifikat X509 yang ditandatangani sendiri di komputer mana pun menggunakan OpenSSL. Untuk contoh menggunakan OpenSSL untuk membuat sertifikat X509, [lihat Membuat](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/configuring-https-ssl.html) dan menandatangani sertifikat X509. + Menambahkan izin berikut: **Untuk GitHub Enterprise Cloud (SaaS)** + `repo:status`— Memberikan read/write akses ke status komit di repositori publik dan pribadi. Cakupan ini hanya diperlukan untuk memberikan pengguna atau layanan lain akses ke status komit repositori pribadi tanpa memberikan akses ke kode. + `repo_deployment`— Memberikan akses ke status penyebaran untuk repositori publik dan pribadi. Cakupan ini hanya diperlukan untuk memberikan pengguna atau layanan lain akses ke status penerapan, tanpa memberikan akses ke kode. + `public_repo`— Membatasi akses ke repositori publik. Itu termasuk read/write akses ke kode, status komit, proyek repositori, kolaborator, dan status penerapan untuk repositori dan organisasi publik. Juga diperlukan untuk membintangi repositori publik. + `repo:invite`— Memberikan accept/decline kemampuan untuk undangan untuk berkolaborasi di repositori. Cakupan ini hanya diperlukan untuk memberikan pengguna atau layanan lain akses ke undangan tanpa memberikan akses ke kode. + `security_events`— Hibah: baca dan tulis akses ke peristiwa keamanan di API pemindaian kode. Cakupan ini hanya diperlukan untuk memberikan pengguna atau layanan lain akses ke peristiwa keamanan tanpa memberikan akses ke kode. + `read:org`— Akses hanya-baca ke keanggotaan organisasi, proyek organisasi, dan keanggotaan tim. + `user:email`— Memberikan akses baca ke alamat email pengguna. Diperlukan oleh Amazon Kendra untuk merangkak. ACLs + `user:follow`— Memberikan akses untuk mengikuti atau berhenti mengikuti pengguna lain. Diperlukan oleh Amazon Kendra untuk merangkak. ACLs + `read:user`— Memberikan akses untuk membaca data profil pengguna. Diperlukan oleh Amazon Kendra untuk merangkak. ACLs + `workflow`— Memberikan kemampuan untuk menambah dan memperbarui file alur kerja GitHub Tindakan. File alur kerja dapat dilakukan tanpa cakupan ini jika file yang sama (dengan jalur dan konten yang sama) ada di cabang lain di repositori yang sama. Untuk informasi selengkapnya, lihat [Cakupan untuk OAuth aplikasi](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps) di GitHub Dokumen. **Untuk Server GitHub Perusahaan (Di Prem)** + `repo:status`— Memberikan read/write akses ke status komit di repositori publik dan pribadi. Cakupan ini hanya diperlukan untuk memberikan pengguna atau layanan lain akses ke status komit repositori pribadi tanpa memberikan akses ke kode. + `repo_deployment`— Memberikan akses ke status penyebaran untuk repositori publik dan pribadi. Cakupan ini hanya diperlukan untuk memberikan pengguna atau layanan lain akses ke status penerapan, tanpa memberikan akses ke kode. + `public_repo`— Membatasi akses ke repositori publik. Itu termasuk read/write akses ke kode, status komit, proyek repositori, kolaborator, dan status penerapan untuk repositori dan organisasi publik. Juga diperlukan untuk membintangi repositori publik. + `repo:invite`— Memberikan accept/decline kemampuan untuk undangan untuk berkolaborasi di repositori. Cakupan ini hanya diperlukan untuk memberikan pengguna atau layanan lain akses ke undangan tanpa memberikan akses ke kode. + `security_events`— Hibah: baca dan tulis akses ke peristiwa keamanan di API pemindaian kode. Cakupan ini hanya diperlukan untuk memberikan pengguna atau layanan lain akses ke peristiwa keamanan tanpa memberikan akses ke kode. + `read:user`— Memberikan akses untuk membaca data profil pengguna. Diperlukan oleh Amazon Q Business untuk menjelajah ACLs. + `user:email`— Memberikan akses baca ke alamat email pengguna. Diperlukan oleh Amazon Q Business untuk menjelajah ACLs. + `user:follow`— Memberikan akses untuk mengikuti atau berhenti mengikuti pengguna lain. Diperlukan oleh Amazon Q Business untuk menjelajah ACLs. + `site_admin`— Memberikan administrator situs akses ke titik akhir API Administrasi Server GitHub Perusahaan. + `workflow`— Memberikan kemampuan untuk menambah dan memperbarui file alur kerja GitHub Tindakan. File alur kerja dapat dilakukan tanpa cakupan ini jika file yang sama (dengan jalur dan konten yang sama) ada di cabang lain di repositori yang sama. Untuk informasi selengkapnya, lihat [Cakupan untuk OAuth aplikasi](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps) di GitHub Docs and [Understanding scopes for OAuth Apps](https://developer.github.com/enterprise/2.16/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) in Developer. GitHub + Memeriksa setiap dokumen unik di dalam GitHub dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi GitHub otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber GitHub data AndaAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber GitHub data Anda, Anda harus memberikan rincian yang diperlukan dari sumber GitHub data Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi GitHub untukAmazon Kendra, lihat[Prasyarat](#prerequisites-github). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke GitHub** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambah sumber data**, pilih **GitHub konektor**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **GitHub konektor** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **GitHubsumber** —Pilih antara **GitHub Enterprise Cloud** dan **GitHubEnterprise Server**. 1. **GitHub URL host** —Misalnya, URL host untuk GitHub cloud bisa jadi *https://api.github.com* dan URL host untuk GitHub server bisa*https://on-prem-host-url/api/v3/*. 1. **GitHub nama organisasi** —Masukkan nama GitHub organisasi Anda. Anda dapat menemukan informasi organisasi Anda di GitHub akun Anda. **catatan** GitHub konektor mendukung perayapan satu organisasi per contoh konektor sumber data. 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensi GitHub otentikasi Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra- GitHub -' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **GitHubtoken** —Masukkan nilai kredensi otentikasi yang dikonfigurasi di. GitHub 1. Simpan dan tambahkan rahasia Anda. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Pilih repositori** —Pilih untuk merayapi semua repositori atau pilih. Jika Anda memilih untuk merayapi repositori tertentu, tambahkan nama untuk repositori dan, secara opsional, nama cabang tertentu. 1. **Jenis konten** —Pilih jenis konten yang ingin dirayapi dari file, masalah, permintaan tarik, dan lainnya. 1. Pola **Regex —Tambahkan pola** ekspresi reguler untuk menyertakan atau mengecualikan file tertentu. 1. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Di **Sinkronkan jadwal lari** untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Bidang **sumber data default —Pilih dari bidang** sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke GitHub** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-github-schema) menggunakan API. [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `GITHUB` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **GitHubtype** —Tentukan tipe sebagai salah satu `SAAS` atau`ON_PREMISE`. + **URL Host** —Tentukan URL GitHub host atau URL titik akhir API. Misalnya, jika Anda menggunakan GitHub SaaS/Enterprise Cloud, URL host bisa jadi`https://api.github.com`, dan untuk Server GitHub On-premis/Enterprise URL host bisa. `https://on-prem-host-url/api/v3/` + **Nama organisasi** —Tentukan nama organisasi GitHub akun. Anda dapat menemukan nama organisasi Anda dengan masuk ke GitHub desktop dan memilih **Organisasi Anda** di bawah dropdown gambar profil Anda. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensi otentikasi untuk akun Anda. GitHub Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "personalToken": "token" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk GitHub konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber GitHub data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). **catatan** Jika Anda menggunakan GitHub server, Anda harus menggunakan file Amazon VPC untuk terhubung ke GitHub server Anda. + Filter **repositori —Filter** repositori dengan nama dan nama cabangnya. + **Jenis dokumen/konten** —Tentukan apakah akan merayapi dokumen repositori, masalah, mengeluarkan komentar, mengeluarkan lampiran komentar, permintaan tarik, komentar permintaan tarik, lampiran komentar permintaan tarik. + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan file dan folder tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Daftar kontrol akses (ACL)** —Tentukan apakah akan merayapi informasi ACL untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber GitHub data Anda ke bidang indeks AndaAmazon Kendra. Anda dapat menyertakan bidang dokumen, komit, masalah, lampiran masalah, mengeluarkan komentar, permintaan tarik, lampiran permintaan tarik, komentar permintaan tarik. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan agar Amazon Kendra dapat mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat [skema GitHub template](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-github-schema). ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber GitHub data Anda, lihat: + [Bayangkan kembali pencarian di GitHub repositori dengan kekuatan konektor Amazon Kendra GitHub ](https://aws.amazon.com/blogs/machine-learning/reimagine-search-on-github-repositories-with-the-power-of-the-amazon-kendra-github-connector/) # Gmail Gmail adalah klien email yang dikembangkan oleh Google di mana Anda dapat mengirim pesan email dengan lampiran file. Pesan Gmail dapat diurutkan dan disimpan di dalam kotak masuk email Anda menggunakan folder dan label. Anda dapat menggunakan Amazon Kendra untuk mengindeks pesan email dan lampiran pesan Anda. Anda juga dapat mengonfigurasi Amazon Kendra untuk menyertakan atau mengecualikan pesan email tertentu, lampiran pesan, dan label untuk pengindeksan. Anda dapat terhubung Amazon Kendra ke sumber data Gmail Anda menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Untuk mengatasi masalah konektor sumber data Amazon Kendra Gmail, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-gmail) + [Prasyarat](#prerequisites-gmail) + [Instruksi koneksi](#data-source-procedure-gmail) + [Pelajari selengkapnya](#gmail-learn-more) + [Catatan](#gmail-notes) ## Fitur yang didukung + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Gmail Anda, buat perubahan ini di Gmail dan AWS akun Anda. **Di Gmail, pastikan Anda memiliki:** + Membuat akun admin Google Cloud Platform dan telah membuat proyek Google Cloud. + Diaktifkan API Gmail dan Admin SDK API di akun admin Anda. + Membuat akun layanan dan mengunduh kunci pribadi JSON untuk Gmail Anda. Untuk informasi tentang cara membuat dan mengakses kunci pribadi Anda, lihat dokumentasi Google Cloud tentang cara [membuat kunci akun layanan](https://cloud.google.com/iam/docs/keys-create-delete#creating) dan [kredensyal akun Layanan](https://cloud.google.com/iam/docs/service-account-creds#key-types). + Menyalin email akun admin Anda, email akun layanan Anda, dan kunci pribadi Anda untuk digunakan sebagai kredensyal otentikasi Anda. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + Menambahkan cakupan Oauth berikut (menggunakan peran admin) untuk pengguna Anda dan direktori bersama yang ingin Anda indeks: + https://www.googleapis.com/auth/admin.directory.user.readonly + https://www.googleapis.com/auth/gmail.readonly + Memeriksa setiap dokumen unik di Gmail dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensyal otentikasi Gmail Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasianya. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data Gmail AndaAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Gmail Anda, Anda harus memberikan detail kredensyal Gmail Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Gmail untukAmazon Kendra, lihat[Prasyarat](#prerequisites-gmail). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Gmail** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambah sumber data**, pilih **konektor Gmail**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Gmail** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. Dalam **Otentikasi** untuk **AWSSecrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensi otentikasi Gmail Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama Rahasia** — Nama untuk rahasiamu. 1. **Email klien —Email** klien yang Anda salin dari akun layanan Google Anda. 1. **Email akun admin** —Email akun admin yang ingin Anda gunakan. 1. **Kunci pribadi —Kunci** pribadi yang Anda salin dari akun layanan Google Anda. 1. Simpan dan tambahkan rahasia Anda. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Untuk **tipe Entitas** —Pilih untuk menyinkronkan lampiran pesan. 1. (Opsional) Untuk **konfigurasi tambahan**, masukkan informasi berikut: 1. **Rentang tanggal** —Masukkan rentang tanggal untuk menentukan tanggal mulai dan akhir email yang ingin dirayapi. 1. **Domain email** —Sertakan atau kecualikan email tertentu berdasarkan domain email “ke”, “dari”, “cc”, dan “bcc”. 1. **Kata kunci dalam subjek** —Sertakan atau kecualikan email berdasarkan kata kunci dalam subjek email mereka. **catatan** Anda juga dapat memilih untuk menyertakan dokumen apa pun yang cocok dengan semua kata kunci subjek yang telah Anda masukkan. 1. **Label** —Tambahkan pola ekspresi reguler untuk menyertakan atau mengecualikan label email tertentu. 1. **Lampiran** —Tambahkan pola ekspresi reguler untuk menyertakan atau mengecualikan lampiran email tertentu. 1. **Mode sinkronisasi** —Pilih cara Anda ingin memperbarui indeks saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. **penting** Karena tidak ada API untuk memperbarui pesan Gmail yang dihapus secara permanen, sinkronisasi konten baru, dimodifikasi, atau dihapus: Tidak akan menghapus pesan yang dihapus secara permanen dari Gmail dari Amazon Kendra indeks Anda Tidak akan menyinkronkan perubahan pada label email Gmail Untuk menyinkronkan perubahan label sumber data Gmail dan pesan email yang dihapus secara permanen ke Amazon Kendra indeks, Anda harus menjalankan crawl penuh secara berkala. 1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Bidang **sumber data default —Pilih dari bidang** sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda. **catatan** Amazon KendraKonektor sumber data Gmail tidak mendukung pembuatan bidang indeks khusus karena keterbatasan API. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Gmail** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-gmail-schema) menggunakan API. [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `GMAIL` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. **penting** Karena tidak ada API untuk memperbarui pesan Gmail yang dihapus secara permanen, sinkronisasi konten baru, dimodifikasi, atau dihapus: Tidak akan menghapus pesan yang dihapus secara permanen dari Gmail dari Amazon Kendra indeks Anda Tidak akan menyinkronkan perubahan pada label email Gmail Untuk menyinkronkan perubahan label sumber data Gmail dan pesan email yang dihapus secara permanen ke Amazon Kendra indeks, Anda harus menjalankan crawl penuh secara berkala. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi untuk akun Gmail Anda. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "adminAccountEmailId": "service account email", "clientEmailId": "user account email", "privateKey": "private key" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Gmail dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Gmail](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan email “ke”, “dari”, “cc”, “bcc” tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Gmail Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. **catatan** Amazon KendraKonektor sumber data Gmail tidak mendukung pembuatan bidang indeks khusus karena keterbatasan API. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat [skema Gmail template](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-gmail-schema). ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Gmail Anda, lihat: + [Lakukan pencarian cerdas di seluruh email di ruang kerja Google Anda menggunakan konektor Gmail untuk Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/perform-intelligent-search-across-emails-in-your-google-workspace-using-the-gmail-connector-for-amazon-kendra/). ## Catatan + Karena tidak ada API untuk memperbarui pesan Gmail yang dihapus secara permanen, **sinkronisasi konten`FULL_CRAWL`/Baru, dimodifikasi, atau dihapus**: + Tidak akan menghapus pesan yang dihapus secara permanen dari Gmail dari Amazon Kendra indeks Anda + Tidak akan menyinkronkan perubahan pada label email Gmail Untuk menyinkronkan perubahan label sumber data Gmail dan pesan email yang dihapus secara permanen ke Amazon Kendra indeks, Anda harus menjalankan crawl penuh secara berkala. + Amazon KendraKonektor sumber data Gmail tidak mendukung pembuatan bidang indeks khusus karena keterbatasan API. # Google Drive Google Drive adalah layanan penyimpanan file berbasis cloud. Anda dapat menggunakan Amazon Kendra untuk mengindeks dokumen yang disimpan di drive bersama, My Drives, dan Shared with me folder di sumber data Google Drive Anda. Anda dapat mengindeks dokumen Google Workspace serta dokumen yang tercantum dalam [Jenis dokumentasi](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html). Anda juga dapat menggunakan filter penyertaan dan pengecualian untuk mengindeks konten berdasarkan nama file, jenis file, dan jalur file. Anda dapat terhubung Amazon Kendra ke sumber data Google Drive menggunakan [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/), [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API, atau [GoogleDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_GoogleDriveConfiguration.html)API. Amazon Kendra memiliki dua versi konektor Google Drive. Fitur yang didukung dari setiap versi meliputi: **Konektor Google Drive V1.0/API [GoogleDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_GoogleDriveConfiguration.html)** + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian **Konektor Google Drive V2.0 /API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)** + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) **catatan** Konektor Google Drive V1.0/Google DriveConfiguration API berakhir pada 2023. Kami merekomendasikan migrasi ke atau menggunakan konektor Google Drive V2.0/ TemplateConfiguration API. Untuk memecahkan masalah konektor sumber data Amazon Kendra Google Drive, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Konektor Google Drive V1.0](data-source-v1-google-drive.md) + [Konektor Google Drive V2.0](data-source-v2-google-drive.md) # Konektor Google Drive V1.0 Google Drive adalah layanan penyimpanan file berbasis cloud. Anda dapat menggunakan Amazon Kendra untuk mengindeks dokumen dan komentar yang disimpan di drive bersama, My Drives, dan Shared with me folder di sumber data Google Drive Anda. Anda dapat mengindeks dokumen Google Workspace, serta dokumen yang tercantum dalam [Jenis dokumentasi](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html). Anda juga dapat menggunakan filter penyertaan dan pengecualian untuk mengindeks konten berdasarkan nama file, jenis file, dan jalur file. **catatan** Konektor Google Drive V1.0/Google DriveConfiguration API berakhir pada 2023. Kami merekomendasikan migrasi ke atau menggunakan konektor Google Drive V2.0/ TemplateConfiguration API. Untuk memecahkan masalah konektor sumber data Amazon Kendra Google Drive, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-v1-google-drive) + [Prasyarat](#prerequisites-v1-google-drive) + [Instruksi koneksi](#data-source-v1-procedure-google-drive) + [Pelajari selengkapnya](#google-drive-learn-more) ## Fitur yang didukung + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Google Drive Anda, buat perubahan ini di Google Drive dan AWS akun Anda. **Di Google Drive, pastikan Anda memiliki:** + **Entah** telah diberikan akses oleh peran admin super **atau** pengguna dengan hak administratif. Anda tidak memerlukan peran admin super untuk diri sendiri jika Anda telah diberikan akses oleh peran admin super. + Membuat akun layanan dengan **Aktifkan Delegasi Seluruh Domain G Suite** diaktifkan dan kunci JSON sebagai kunci pribadi menggunakan akun. + Menyalin email akun pengguna Anda dan email akun layanan Anda. Saat Amazon Kendra Anda terhubung, masukkan email akun pengguna Anda sebagai email akun admin dan email akun layanan Anda sebagai email klien dalam AWS Secrets Manager rahasia Anda. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + Menambahkan Admin SDK API dan Google Drive API di akun Anda. + Menambahkan (atau meminta pengguna dengan peran admin super untuk menambahkan) izin berikut ke akun layanan Anda menggunakan peran admin super: + https://www.googleapis.com/auth/drive.readonly + https://www.googleapis.com/auth/drive.metadata.readonly + https://www.googleapis.com/auth/admin.directory.user.readonly + https://www.googleapis.com/auth/admin.directory.group.readonly + Memeriksa setiap dokumen unik di Google Drive dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam Anda Akun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebut IAM . **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benar AWS Secrets Manager . + Menyimpan kredensi otentikasi Google Drive Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasianya. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data Google Drive Anda Amazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Google Drive Anda, Anda harus memberikan rincian yang diperlukan dari sumber data Google Drive Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Google Drive untuk Amazon Kendra lihat[Prasyarat](#prerequisites-v1-google-drive). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Google Drive** 1. Masuk ke Konsol AWS Manajemen dan buka [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambah sumber data**, pilih **konektor Google Drive V1.0**, lalu pilih **Tambah konektor**. 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **Untuk **Jenis otentikasi** —Pilih antara **yang Ada dan Baru**.** Jika Anda memilih untuk menggunakan rahasia yang ada, gunakan **Select secret** untuk memilih rahasia Anda. 1. Jika Anda memilih untuk membuat rahasia baru, opsi AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-Google Drive-' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **email akun Admin**, **email Klien**, dan **Kunci pribadi** —Masukkan nilai kredensi otentikasi yang Anda buat dan unduh dari akun Google Drive Anda. 1. Pilih **Simpan otentikasi.** 1. **IAM peran** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAM peran yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Kecualikan akun pengguna** —Pengguna Google Drive yang ingin Anda kecualikan dari indeks. Anda dapat menambahkan hingga 100 akun pengguna. 1. **Kecualikan drive bersama** —Drive bersama Google Drive yang ingin Anda kecualikan dari indeks Anda. Anda dapat menambahkan hingga 100 drive bersama. 1. **Kecualikan jenis file drive** —Jenis file Google Drive yang ingin Anda kecualikan dari indeks Anda. Anda juga dapat memilih untuk mengedit pilihan tipe MIME. 1. **Konfigurasi tambahan** —Pola ekspresi reguler untuk menyertakan atau mengecualikan konten tertentu. Anda dapat menambahkan hingga 100 pola. 1. **Frekuensi** —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Untuk **nama GoogleDrive bidang** dan **Pemetaan bidang yang disarankan tambahan** —Pilih dari bidang sumber data default Amazon Kendra yang dihasilkan yang ingin Anda petakan ke indeks Anda. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Google Drive** Anda harus menentukan yang berikut menggunakan [GoogleDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_GoogleDriveConfiguration.html)API: + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi untuk akun Google Drive Anda. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "clientAccount": "service account email", "adminAccount": "user account email"", "privateKey": "private key" } ``` + **IAM peran** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Google Drive dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAM peran untuk sumber data Google Drive](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Filter inklusi dan pengecualian** —Secara default Amazon Kendra mengindeks semua dokumen di Google Drive. Anda dapat menentukan apakah akan menyertakan atau mengecualikan konten tertentu dalam drive bersama, akun pengguna, jenis MIME dokumen, dan file. Jika Anda memilih untuk mengecualikan akun pengguna, tidak ada file di Drive Saya yang dimiliki oleh akun yang diindeks. File yang dibagikan dengan pengguna diindeks, kecuali pemilik file juga dikecualikan. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Google Drive Anda ke bidang indeks Anda Amazon Kendra . Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. + **Pemfilteran konteks pengguna dan kontrol akses** —Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Google Drive Anda, lihat: + [Memulai dengan konektor Amazon Kendra Google Drive](https://aws.amazon.com/blogs/machine-learning/getting-started-with-the-amazon-kendra-google-drive-connector/) # Konektor Google Drive V2.0 Google Drive adalah layanan penyimpanan file berbasis cloud. Anda dapat menggunakan Amazon Kendra untuk mengindeks dokumen dan komentar yang disimpan di drive bersama, My Drives, dan Shared with me folder di sumber data Google Drive Anda. Anda dapat mengindeks dokumen Google Workspace, serta dokumen yang tercantum dalam [Jenis dokumentasi](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html). Anda juga dapat menggunakan filter penyertaan dan pengecualian untuk mengindeks konten berdasarkan nama file, jenis file, dan jalur file. **catatan** Konektor Google Drive V1.0/Google DriveConfiguration API berakhir pada 2023. Kami merekomendasikan migrasi ke atau menggunakan konektor Google Drive V2.0/ TemplateConfiguration API. Untuk memecahkan masalah konektor sumber data Amazon Kendra Google Drive, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-v2-google-drive) + [Prasyarat](#prerequisites-v2-google-drive) + [Instruksi koneksi](#data-source-procedure-v2-google-drive) + [Catatan](#google-drive-notes) ## Fitur yang didukung + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Google Drive Anda, buat perubahan ini di Google Drive dan AWS akun Anda. **Di Google Drive, pastikan Anda memiliki:** + **Entah** telah diberikan akses oleh peran admin super **atau** pengguna dengan hak administratif. Anda tidak memerlukan peran admin super untuk diri sendiri jika Anda telah diberikan akses oleh peran admin super. + Kredensyal koneksi Akun Layanan Google Drive yang dikonfigurasi yang berisi email akun admin, email klien (email akun layanan), dan kunci pribadi Anda. Lihat [dokumentasi Google Cloud tentang membuat dan menghapus kunci akun layanan](https://cloud.google.com/iam/docs/keys-create-delete). **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + Membuat Akun Layanan Google Cloud (akun dengan otoritas yang didelegasikan untuk mengambil identitas pengguna) dengan **Aktifkan Delegasi Seluruh Domain G Suite diaktifkan untuk server-to-server autentikasi**, lalu buat kunci pribadi JSON menggunakan akun tersebut. **catatan** Kunci pribadi harus dibuat setelah pembuatan akun layanan. + Menambahkan Admin SDK API dan Google Drive API di akun pengguna Anda. + **Opsional:** Kredensyal koneksi Google Drive OAuth 2.0 yang dikonfigurasi yang berisi ID klien, rahasia klien, dan token penyegaran sebagai kredensyal koneksi untuk pengguna tertentu. Anda memerlukan ini untuk merayapi data akun individual. Lihat [dokumentasi Google tentang penggunaan OAuth 2.0 untuk mengakses APIs](https://developers.google.com/identity/protocols/oauth2). + Menambahkan (atau meminta pengguna dengan peran admin super untuk menambahkan) OAuth cakupan berikut ke akun layanan Anda menggunakan peran admin super. Cakupan API ini diperlukan untuk merayapi semua dokumen, dan informasi kontrol akses (ACL) untuk semua pengguna di domain Google Workspace: + https://www.googleapis.com/auth/Drive.readonly—Lihat dan unduh semua file Google Drive Anda + https://www.googleapis.com/auth/Drive.metadata.readonly—Lihat metadata untuk file di Google Drive + https://www.googleapis.com/auth/admin.directory.group.readonly—ruang lingkup untuk hanya mengambil grup, alias grup, dan informasi anggota. Ini diperlukan untuk Amazon Kendra Identity Crawler. + https://www.googleapis.com/auth/admin.directory.user.readonly—ruang lingkup untuk hanya mengambil pengguna atau alias pengguna. Ini diperlukan untuk mencantumkan pengguna di Perayap Amazon Kendra Identitas dan untuk pengaturan ACLs. + https://www.googleapis.com/auth/Cloud-platform—ruang lingkup untuk menghasilkan token akses untuk mengambil konten file Google Drive besar. + https://www.googleapis.com/auth/Forms.body.ReadOnly—ruang lingkup untuk mengambil data dari Google Formulir. **Untuk mendukung API Formulir, tambahkan cakupan tambahan berikut:** + https://www.googleapis.com/auth/forms.body.readonly + Memeriksa setiap dokumen unik di Google Drive dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam Anda Akun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebut IAM . **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benar AWS Secrets Manager . + Menyimpan kredensi otentikasi Google Drive Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasianya. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data Google Drive Anda Amazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Google Drive Anda, Anda harus memberikan rincian yang diperlukan dari sumber data Google Drive Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Google Drive untuk Amazon Kendra lihat[Prasyarat](#prerequisites-v2-google-drive). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Google Drive** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambah sumber data**, pilih **konektor Google Drive**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Google Drive** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. Untuk **Otentikasi** —Pilih antara **akun layanan Google** dan **autentikasi OAuth 2.0** berdasarkan kasus penggunaan Anda. 1. **AWS Secrets Manager Rahasia** —Pilih rahasia yang ada, atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal otentikasi Google Drive Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Jika Anda memilih **akun layanan Google**, masukkan nama untuk rahasia Anda, ID email pengguna admin atau “Pengguna Akun Layanan” dalam konfigurasi akun layanan Anda (email admin), ID email akun layanan (email klien), dan kunci pribadi yang Anda buat di akun layanan Anda. Simpan dan tambahkan rahasia Anda 1. Jika Anda memilih **otentikasi OAuth 2.0**, masukkan nama untuk rahasia, ID klien, rahasia klien, dan token penyegaran yang Anda buat di OAuth akun Anda. Id email pengguna (pengguna yang detail koneksinya dikonfigurasi) akan ditetapkan sebagai ACL. Konektor tidak menetapkan info user/group utama lainnya sebagai ACL karena keterbatasan API. Simpan dan tambahkan rahasia Anda. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. (Hanya untuk pengguna otentikasi akun layanan Google) **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. 1. **IAM peran** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAM peran yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Sinkronkan konten** —Pilih opsi atau konten yang ingin dirayapi. Anda dapat memilih untuk merayapi Drive Saya (folder pribadi), Drive Bersama (folder yang dibagikan dengan Anda), atau keduanya. Anda juga dapat menyertakan komentar file. 1. Dalam **Konfigurasi tambahan - opsional** Anda juga dapat memasukkan informasi opsional berikut: 1. **Ukuran file maksimum** —Tetapkan batas ukuran maksimum file untuk dirayapi. MBs 1. **Email pengguna** —Tambahkan email pengguna yang ingin Anda sertakan atau kecualikan. 1. **Drive bersama** —Tambahkan nama drive bersama yang ingin Anda sertakan atau kecualikan. 1. Jenis **mime —Tambahkan tipe** MIME yang ingin Anda sertakan atau kecualikan. 1. Pola **regex entitas —Tambahkan pola** ekspresi reguler untuk menyertakan atau mengecualikan lampiran tertentu untuk semua entitas yang didukung. Anda dapat menambahkan hingga 100 pola. Anda dapat mengonfigurasi pola include/exclude regex untuk **nama File**, **Jenis file**, dan jalur **File**. + **Nama file** — Nama file yang akan disertakan atau dikecualikan. Misalnya, untuk mengindeks file dengan nama`teamroster.txt`, berikan`teamroster`. + **Jenis file** — Jenis file yang akan disertakan atau dikecualikan. Misalnya, .pdf .txt .docx. + **Jalur file** — Jalur file yang akan disertakan atau dikecualikan. Misalnya, untuk mengindeks file hanya di dalam folder `Products list` drive, berikan`/Products list`. 1. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. **penting** Google Drive API tidak mendukung pengambilan komentar dari file yang dihapus secara permanen. Komentar dari file yang dibuang dapat diambil kembali. Ketika file dibuang, konektor akan menghapus komentar dari indeks. Amazon Kendra 1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Di **Sync run history**, pilih untuk menyimpan laporan yang dibuat secara otomatis Amazon S3 saat menyinkronkan sumber data Anda. Ini berguna untuk melacak masalah saat menyinkronkan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Untuk **File** —Pilih dari bidang sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda. **catatan** Google Drive API tidak mendukung pembuatan bidang khusus. Pemetaan bidang khusus tidak tersedia untuk konektor Google Drive. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Google Drive** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) menggunakan API. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `GOOGLEDRIVEV2` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Juga tentukan sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **Jenis otentikasi** —Tentukan apakah akan menggunakan otentikasi akun layanan atau OAuth otentikasi 2.0. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. **penting** Google Drive API tidak mendukung pengambilan komentar dari file yang dihapus secara permanen. Komentar dari file yang dibuang dapat diambil kembali. Ketika file dibuang, konektor akan menghapus komentar dari indeks. Amazon Kendra + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi yang Anda buat di akun Google Drive Anda. Jika Anda menggunakan otentikasi akun layanan Google, rahasia disimpan dalam struktur JSON dengan kunci berikut: ``` { "clientEmail": "user account email", "adminAccountEmail": "service account email", "privateKey": "private key" } ``` Jika Anda menggunakan otentikasi OAuth 2.0, rahasia disimpan dalam struktur JSON dengan kunci berikut: ``` { "clientID": "OAuth client ID", "clientSecret": "client secret", "refreshToken": "refresh token" } ``` + **IAM peran** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Google Drive dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAM peran untuk sumber data Google Drive](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Drive Saya, Drive Bersama, Komentar** —Anda dapat menentukan apakah akan merayapi jenis konten ini. + **Filter penyertaan dan pengecualian** —Anda dapat menentukan apakah akan menyertakan atau mengecualikan akun pengguna tertentu, drive bersama, dan tipe MIME. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Daftar kontrol akses (ACL)** —Tentukan apakah akan merayapi informasi ACL untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). + **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Google Drive Anda ke bidang indeks Anda Amazon Kendra . Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat [skema template Google Drive](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-google-drive-schema). ------ ## Catatan + Pemetaan bidang khusus tidak tersedia untuk konektor Google Drive karena UI Google Drive tidak mendukung pembuatan bidang khusus. + Google Drive API tidak mendukung pengambilan komentar dari file yang dihapus secara permanen. Komentar dapat diambil kembali, bagaimanapun, untuk file yang dibuang. Ketika file dibuang, Amazon Kendra konektor akan menghapus komentar dari indeks. Amazon Kendra + Google Drive API tidak mengembalikan komentar yang ada dalam file.docx. + Jika izin untuk tertentu Google document (dokumen, spreadsheet, slide, dll) diatur ke **Akses umum: Siapa pun yang memiliki tautan** atau **Dibagikan ke domain perusahaan tertentu Anda**, dokumen tersebut tidak akan terlihat oleh pengguna penelusuran Amazon Kendra sampai pengguna yang membuat kueri telah mengakses dokumen. # IBM DB2 **catatan** IBM DB2konektor tetap didukung penuh untuk pelanggan yang sudah ada hingga 31 Mei 2026. Meskipun konektor ini tidak lagi tersedia untuk pengguna baru, pengguna saat ini dapat terus menggunakannya tanpa gangguan. Kami terus mengembangkan portofolio konektor kami untuk menawarkan solusi yang lebih terukur dan dapat disesuaikan. Untuk integrasi masa depan, sebaiknya jelajahi Amazon Kendra Custom Connector Framework [1], yang dirancang untuk mendukung rangkaian kasus penggunaan perusahaan yang lebih luas dengan fleksibilitas yang ditingkatkan. IBM DB2adalah sistem manajemen basis data relasional yang dikembangkan olehIBM. Jika Anda adalah IBM DB2 pengguna, Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber IBM DB2 data Anda. Konektor sumber Amazon Kendra IBM DB2 data mendukung DB2 11.5.7. Anda dapat terhubung Amazon Kendra ke sumber IBM DB2 data menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber Amazon Kendra IBM DB2 data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-ibm-db2) + [Prasyarat](#prerequisites-ibm-db2) + [Instruksi koneksi](#data-source-procedure-ibm-db2) + [Catatan](#ibm-db2-notes) ## Fitur yang didukung + Pemetaan bidang + Pemfilteran konteks pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber IBM DB2 data Anda, buat perubahan ini di akun IBM DB2 dan AWS akun Anda. **DiIBM DB2, pastikan Anda memiliki:** + Mencatat nama pengguna dan kata sandi database Anda. **penting** Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Menyalin url, port, dan instance host database Anda. + Memeriksa setiap dokumen unik di dalam IBM DB2 dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensyal IBM DB2 otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber IBM DB2 data AndaAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber IBM DB2 data Anda, Anda harus memberikan rincian IBM DB2 kredensyal Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi IBM DB2 untuk Amazon Kendra lihat[Prasyarat](#prerequisites-ibm-db2). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke IBM DB2** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **IBM DB2konektor**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **IBM DB2konektor** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. Di **Sumber**, masukkan informasi berikut: 1. **Host** — Masukkan nama host database. 1. **Port** — Masukkan port database. 1. **Instance** - Masukkan instance database. 1. **Aktifkan lokasi sertifikat SSL** —Pilih untuk memasukkan Amazon S3 jalur ke file sertifikat SSL Anda. 1. Dalam **Otentikasi** —masukkan informasi berikut: 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal IBM DB2 otentikasi Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra- IBM DB2 -' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **nama pengguna Database**, dan **Kata Sandi** —Masukkan nilai kredensi otentikasi yang Anda salin dari database Anda. 1. Pilih **Simpan**. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **IAMperan** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Dalam **lingkup Sinkronisasi**, pilih dari opsi berikut: + **Kueri SQL**—Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. + **Kolom kunci primer**—Berikan kunci primer untuk tabel basis data. Detail ini mengidentifikasi tabel di dalam basis data Anda. + **Kolom judul**—Berikan nama kolom judul dokumen di dalam tabel basis data Anda. + **Kolom tubuh** —Berikan nama kolom badan dokumen dalam tabel database Anda. 1. Dalam **Konfigurasi tambahan — *opsional***, pilih dari opsi berikut untuk menyinkronkan konten tertentu alih-alih menyinkronkan semua file: + **Kolom pendeteksi perubahan** —Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendraakan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini. + ** IDsKolom pengguna** —Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. + **Kolom grup**—Masukkan nama kolom yang berisi grup untuk diizinkan mengakses konten. + ** URLsKolom sumber** —Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. + **Kolom stempel waktu** —Masukkan nama kolom yang berisi stempel waktu. Amazon Kendramenggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. + **Kolom zona waktu**—Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. + **Format stempel waktu**—Masukkan nama kolom yang berisi format stempel waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. 1. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Dalam **jadwal berjalan Sinkronisasi**, untuk **Frekuensi** —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang sumber data default yang dihasilkan— **Dokumen IDs**, **Judul dokumen**, dan **Sumber URLs** —Anda ingin memetakan ke Amazon Kendra indeks. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke IBM DB2** Anda harus menentukan yang berikut menggunakan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API: + **Sumber data** —Tentukan tipe sumber data seperti `JDBC` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **Jenis database** —Anda harus menentukan jenis database sebagai`db2`. + **Kueri SQL** —Tentukan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi yang Anda buat di akun Anda. IBM DB2 Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "user name": "database user name", "password": "password" } ``` **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk IBM DB2 konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber IBM DB2 data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan konten tertentu menggunakan pengguna IDs, grup, sumber, stempel waktu URLs, dan zona waktu. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber IBM DB2 data Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat[Skema DB2 templat IBM](ds-schemas.md#ds-ibm-db2-schema). ------ ## Catatan + Baris database yang dihapus tidak akan dilacak saat Amazon Kendra memeriksa konten yang diperbarui. + Ukuran nama bidang dan nilai dalam deretan database Anda tidak dapat melebihi 400KB. + Jika Anda memiliki sejumlah besar data dalam sumber data database Anda, dan tidak Amazon Kendra ingin mengindeks semua konten database Anda setelah sinkronisasi pertama, Anda dapat memilih untuk menyinkronkan hanya dokumen baru, dimodifikasi, atau dihapus. + Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Sebagai praktik terbaik, hindari menambahkan tabel dengan data sensitif atau informasi identitas pribadi (PII). # Jira Jira adalah alat manajemen proyek untuk pengembangan perangkat lunak, manajemen produk, dan pelacakan bug. Anda dapat menggunakan Amazon Kendra untuk mengindeks proyek, masalah, komentar, lampiran, worklog, dan status Jira Anda. Amazon KendraSaat ini hanya mendukung Jira Cloud. Anda dapat terhubung Amazon Kendra ke sumber data Jira Anda menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) atau [JiraConfiguration ](https://docs.aws.amazon.com/kendra/latest/APIReference/API_JiraConfiguration.html)API. Untuk daftar fitur yang didukung oleh masing-masing fitur, lihat[Fitur yang didukung](#supported-features-jira). Untuk memecahkan masalah konektor sumber data Amazon Kendra Jira Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-jira) + [Prasyarat](#prerequisites-jira) + [Instruksi koneksi](#data-source-procedure-jira) + [Pelajari selengkapnya](#jira-learn-more) ## Fitur yang didukung Amazon KendraKonektor sumber data Jira mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Jira Anda, buat perubahan ini di Jira dan AWS akun Anda. **Di Jira, pastikan Anda memiliki:** + Kredensyal otentikasi token API yang dikonfigurasi, yang mencakup ID Jira (nama pengguna atau email) dan kredensi Jira (token API JIRA). Lihat [dokumentasi Atlassian tentang pengelolaan token API](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/). **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + Mencatat URL akun Jira dari pengaturan akun Jira Anda. Misalnya, *https://company.atlassian.net/*. + Memeriksa setiap dokumen unik di Jira dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi Jira Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasianya. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data Jira Anda. Amazon Kendra Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Jira Anda, Anda harus memberikan rincian yang diperlukan dari sumber data Jira Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Jira untukAmazon Kendra, lihat[Prasyarat](#prerequisites-jira). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Jira** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **konektor Jira**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Jira dengan tag** “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **URL akun JIRA —Masukkan URL Akun** Jira Anda. Sebagai contoh: *https://company.atlassian.net/*. 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal otentikasi Jira Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-Jira-' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **ID JIRA** —Masukkan nama pengguna atau email Jira. 1. Untuk **Kata Sandi/Token —Masukkan token** API Jira yang dikonfigurasi di Jira. 1. Simpan dan tambahkan rahasia Anda. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. 1. **IAMperan** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Pilih proyek Jira mana yang akan diindeks** —Pilih untuk merayapi semua proyek atau proyek tertentu. 1. **Konfigurasi tambahan** —Tentukan status tertentu, dan jenis masalah. Pilih untuk meng-crawl komentar, lampiran, dan worklog. Gunakan pola ekspresi reguler untuk menyertakan atau mengecualikan konten tertentu. 1. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Bidang **sumber data default —Pilih dari bidang** sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Jira** Anda harus menentukan yang berikut menggunakan [JiraConfiguration ](https://docs.aws.amazon.com/kendra/latest/APIReference/API_JiraConfiguration.html)API: + **URL sumber data** —Tentukan URL akun Jira Anda. Misalnya, *company.atlassian.net*. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi untuk akun Jira Anda. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "jiraId": "Jira user name or email", "jiraCredential": "Jira API token" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Jira dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Jira](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC)** —Tentukan `VpcConfiguration` sebagai bagian dari konfigurasi sumber data. Lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html). + **Ubah log** —Apakah Amazon Kendra harus menggunakan mekanisme log perubahan sumber data JIRA untuk menentukan apakah dokumen harus diperbarui dalam indeks. **catatan** Gunakan log perubahan jika Anda tidak Amazon Kendra ingin memindai semua dokumen. Jika log perubahan Anda besar, mungkin perlu waktu Amazon Kendra lebih sedikit untuk memindai dokumen di sumber data Jira daripada memproses log perubahan. Jika Anda menyinkronkan sumber data Jira Anda dengan indeks Anda untuk pertama kalinya, semua dokumen dipindai. + **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan atau mengecualikan file tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Komentar, lampiran, dan log kerja** —Anda dapat menentukan apakah akan merayapi komentar, lampiran, dan log pekerjaan tertentu dari masalah. + **Proyek, Masalah, Status** —Anda dapat menentukan apakah akan merayapi proyek IDs, jenis masalah, dan status tertentu. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Jira Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Jira Anda, lihat: + [Cari proyek Jira Anda dengan cerdas dengan Amazon Kendra konektor Jira Cloud](https://aws.amazon.com/blogs/machine-learning/intelligently-search-your-jira-projects-with-amazon-kendra-jira-cloud-connector/) # Microsoft Exchange Microsoft Exchange adalah alat kolaborasi perusahaan untuk pengiriman pesan, rapat, dan berbagi file. Jika Anda adalah pengguna Microsoft Exchange, Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Microsoft Exchange Anda. Anda dapat terhubung Amazon Kendra ke sumber data Microsoft Exchange menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber data Amazon Kendra Microsoft Exchange, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) ## Fitur yang didukung + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Microsoft Exchange Anda, buat perubahan ini di Microsoft Exchange dan AWS akun Anda. **Di Microsoft Exchange, pastikan Anda memiliki:** + Membuat akun Microsoft Exchange di Office 365. + Mencatat ID penyewa Microsoft 365 Anda. Anda dapat menemukan ID penyewa Anda di Properti Portal Direktori Aktif Azure Anda atau di aplikasi Anda OAuth. + Mengkonfigurasi OAuth aplikasi di portal Azure dan mencatat ID klien dan rahasia klien atau kredensi klien. Lihat [tutorial Microsoft](https://learn.microsoft.com/en-us/power-apps/developer/data-platform/walkthrough-register-app-azure-active-directory) dan [contoh aplikasi Terdaftar](https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application) untuk informasi selengkapnya. **catatan** Saat Anda membuat atau mendaftarkan aplikasi di portal Azure, ID rahasia mewakili nilai rahasia yang sebenarnya. Anda harus mencatat atau menyimpan nilai rahasia yang sebenarnya segera saat membuat rahasia dan aplikasi. Anda dapat mengakses rahasia Anda dengan memilih nama aplikasi Anda di portal Azure dan kemudian menavigasi ke opsi menu pada sertifikat dan rahasia. Anda dapat mengakses ID klien Anda dengan memilih nama aplikasi Anda di portal Azure dan kemudian menavigasi ke halaman ikhtisar. ID Aplikasi (klien) adalah ID klien. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + Menambahkan izin berikut untuk aplikasi konektor: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/data-source-exchange.html) + Memeriksa setiap dokumen unik di Microsoft Exchange dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi Microsoft Exchange Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasianya. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat menghubungkan sumber data Microsoft ExchangeAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk menyambung Amazon Kendra ke sumber data Microsoft Exchange, Anda harus memberikan rincian yang diperlukan dari sumber data Microsoft Exchange agar Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengonfigurasi Microsoft Exchange untukAmazon Kendra, lihat[Prasyarat](#prerequisites-exchange). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Microsoft Exchange** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambah sumber data**, pilih **konektor Microsoft Exchange**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Microsoft Exchange** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. ID **penyewa —Masukkan ID** penyewa Microsoft 365 Anda. Anda dapat menemukan ID penyewa Anda di Properti Portal Direktori Aktif Azure Anda atau di aplikasi Anda OAuth . 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensi otentikasi Microsoft Exchange Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-Microsoft Exchange 1. Untuk **ID Klien**, **Rahasia klien** —Masukkan kredensi otentikasi yang dikonfigurasi di Microsoft Exchange di portal Azure. 1. Simpan dan tambahkan rahasia Anda. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **IAMperan** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Pengguna IDs** —Berikan email pengguna jika Anda ingin memfilter konten dengan email tertentu. 1. **Konfigurasi tambahan** —Tentukan jenis konten yang ingin dirayapi. + **Jenis entitas** —Anda dapat memilih untuk meng-crawl kalender OneNotes, atau konten kontak. + **Perayapan kalender** —Masukkan tanggal mulai dan berakhir untuk merayapi konten di antara tanggal tertentu. + **Sertakan email** —Masukkan baris subjek “ke”, “dari”, dan email untuk memfilter email tertentu yang ingin Anda jelajahi. + **Akses folder bersama** —Pilih untuk mengaktifkan perayapan daftar kontrol akses untuk kontrol akses sumber data Microsoft Exchange Anda. + **Regex untuk domain** —Tambahkan pola ekspresi reguler untuk menyertakan atau mengecualikan domain email tertentu. + Pola **Regex —Tambahkan pola** ekspresi reguler untuk menyertakan atau mengecualikan file tertentu. 1. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Bidang **sumber data default —Pilih dari bidang** sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda. **catatan** Konektor sumber data Amazon Kendra Microsoft Exchange tidak mendukung pemetaan bidang kustom. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Microsoft Exchange** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-msexchange-schema.html) menggunakan API. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `MSEXCHANGE` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Juga tentukan sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **ID Penyewa** —Anda dapat menemukan ID penyewa Anda di Properti Portal Direktori Aktif Azure Anda atau di aplikasi Anda. OAuth + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensi otentikasi untuk akun Microsoft Exchange Anda. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "clientId": "client ID", "clientSecret": "client secret" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda memanggil `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Microsoft Exchange dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Microsoft Exchange](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan konten tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Daftar kontrol akses (ACL)** —Tentukan apakah akan merayapi informasi ACL untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Microsoft Exchange Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat [skema template Microsoft Exchange](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-msexchange-schema). ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Microsoft Exchange, lihat: + [Indeks konten Microsoft Exchange Anda menggunakan konektor Exchange untuk Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/index-your-microsoft-exchange-content-using-the-exchange-connector-for-amazon-kendra/) ## Catatan + Saat Daftar Kontrol Akses (ACLs) diaktifkan, opsi “Sinkronkan hanya konten baru atau yang dimodifikasi” tidak tersedia karena keterbatasan Microsoft Exchange API. Sebaiknya gunakan mode “Sinkronisasi penuh” atau “Sinkronisasi konten baru, dimodifikasi, atau dihapus” sebagai gantinya, atau nonaktifkan ACLs jika Anda perlu menggunakan mode sinkronisasi ini. # Microsoft OneDrive Microsoft OneDrive adalah layanan penyimpanan berbasis cloud yang dapat Anda gunakan untuk menyimpan, berbagi, dan meng-host konten Anda. Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber OneDrive data Anda. Anda dapat terhubung Amazon Kendra ke sumber OneDrive data menggunakan [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/) dan [OneDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_OneDriveConfiguration.html)API. Amazon Kendra memiliki dua versi OneDrive konektor. Fitur yang didukung dari setiap versi meliputi: ** OneDrive Konektor Microsoft V1.0 /API [OneDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_OneDriveConfiguration.html)** + Pemetaan bidang + Filter inklusi/pengecualian ** OneDrive Konektor Microsoft V2.0 /API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)** + Pemfilteran konteks pengguna + Perayap identitas pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan inkremental + Cloud privat virtual (VPC) **catatan** Support untuk OneDrive konektor V1.0/ OneDriveConfiguration API dijadwalkan berakhir pada Juni 2023. Kami merekomendasikan menggunakan OneDrive konektor V2.0/ TemplateConfigurationAPI. Untuk memecahkan masalah konektor sumber Amazon Kendra OneDrive data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [OneDrive Konektor Microsoft V1.0](data-source-v1-onedrive.md) + [OneDrive Konektor Microsoft V2.0](data-source-v2-onedrive.md) + [Pelajari selengkapnya](#onedrive-learn-more) + [Catatan](#onedrive-notes) # OneDrive Konektor Microsoft V1.0 Microsoft OneDrive adalah layanan penyimpanan berbasis cloud yang dapat Anda gunakan untuk menyimpan, berbagi, dan meng-host konten Anda. Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber OneDrive data Microsoft Anda. **catatan** Support untuk OneDrive konektor V1.0/Microsft OneDrive API dijadwalkan berakhir pada Juni 2023. Kami merekomendasikan menggunakan OneDrive konektor V2.0/ TemplateConfiguration API. Untuk memecahkan masalah konektor sumber Amazon Kendra OneDrive data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-v1-onedrive) + [Prasyarat](#prerequisites-v1-onedrive) + [Instruksi koneksi](#data-source-v1-procedure-onedrive) ## Fitur yang didukung + Pemetaan bidang + Filter inklusi/pengecualian ## Prasyarat Sebelum dapat digunakan Amazon Kendra untuk mengindeks sumber OneDrive data Anda, buat perubahan ini di akun OneDrive dan AWS akun Anda. **Di Azure Active Directory (AD) Anda, pastikan Anda memiliki:** + Membuat aplikasi Azure Active Directory (AD). + Menggunakan ID aplikasi AD untuk mendaftarkan kunci rahasia untuk aplikasi di situs AD. Kunci rahasia harus berisi ID aplikasi dan kunci rahasia. + Menyalin domain AD organisasi. + Menambahkan izin aplikasi berikut ke aplikasi AD Anda pada opsi Microsoft Graph: + Baca file di semua koleksi situs (File.Read.All) + Membaca profil lengkap semua pengguna (User.Read.All) + Membaca data direktori (Directory.Read.All) + Membaca semua grup (Group.Read.All) + Baca item di semua koleksi situs (Site.Read.All) + Menyalin daftar pengguna yang dokumennya harus diindeks. Anda dapat memilih untuk memberikan daftar nama pengguna, atau Anda dapat memberikan nama pengguna dalam file yang disimpan dalam file Amazon S3. Setelah membuat sumber data, Anda dapat: + Mengubah daftar pengguna. + Ubah dari daftar pengguna ke daftar yang disimpan dalam Amazon S3 bucket. + Ubah lokasi Amazon S3 bucket daftar pengguna. Jika Anda mengubah lokasi bucket, Anda juga harus memperbarui IAM peran untuk sumber data agar memiliki akses ke bucket. **catatan** Jika Anda menyimpan daftar nama pengguna dalam Amazon S3 bucket, IAM kebijakan untuk sumber data harus menyediakan akses ke bucket dan akses ke kunci yang dienkripsi bucket, jika ada. + Memeriksa setiap dokumen unik di dalam OneDrive dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam Anda Akun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebut IAM . **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benar AWS Secrets Manager . + Menyimpan kredensyal OneDrive otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat menghubungkan sumber OneDrive data Amazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber OneDrive data Anda, Anda harus memberikan rincian OneDrive kredensyal Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi OneDrive untuk Amazon Kendra lihat[Prasyarat](#prerequisites-v1-onedrive). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke OneDrive** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **OneDrive konektor**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **OneDrive konektor** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **OneDrive ID penyewa** —Masukkan ID OneDrive penyewa tanpa protokol. 1. **Jenis otentikasi** **—Pilih antara **Baru** dan yang Ada.** 1. 1. Jika Anda memilih **yang ada**, pilih rahasia yang ada untuk **Select secret**. 1. Jika Anda memilih **Baru**, masukkan informasi berikut di bagian ** AWS Secrets Manager Rahasia baru**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra- OneDrive -' secara otomatis ditambahkan ke nama rahasia Anda. 1. **Untuk **ID Aplikasi** dan **kata sandi Aplikasi** —Masukkan nilai kredensi otentikasi dari OneDrive akun Anda dan kemudian pilih Simpan otentikasi.** 1. **IAM peran** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten. **catatan** IAM peran yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Pilih antara **file Daftar** dan **daftar Nama** berdasarkan kasus penggunaan Anda. 1. Jika Anda memilih **Daftar file**, masukkan informasi berikut: 1. **Pilih lokasi** —Masukkan jalur ke Amazon S3 bucket Anda. **Tambahkan file daftar pengguna ke Amazon S3** —Pilih untuk menambahkan file daftar pengguna ke Amazon S3 bucket. **Pemetaan grup lokal pengguna** —Pilih untuk menggunakan pemetaan grup lokal untuk memfilter konten Anda. 1. Jika Anda memilih **daftar Nama**, masukkan informasi berikut: 1. **Nama pengguna** —Masukkan hingga 10 drive pengguna untuk diindeks. Untuk menambahkan lebih dari 10 pengguna, buat file yang berisi nama. **Tambahkan yang lain** —Pilih untuk menambahkan lebih banyak pengguna. **Pemetaan grup lokal pengguna** —Pilih untuk menggunakan pemetaan grup lokal untuk memfilter konten Anda. 1. Untuk **konfigurasi tambahan** —Tambahkan pola ekspresi reguler untuk menyertakan atau mengecualikan file tertentu. Anda dapat menambahkan hingga 100 pola. 1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Untuk **bidang sumber data default** dan **Pemetaan bidang yang disarankan tambahan** —Pilih dari bidang sumber data default Amazon Kendra yang dihasilkan yang ingin Anda petakan ke indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke OneDrive** Anda harus menentukan yang berikut menggunakan [OneDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_OneDriveConfiguration.html)API: + **ID Penyewa** —Tentukan domain Azure Active Directory organisasi. + **OneDrive Pengguna** —Tentukan daftar akun pengguna yang dokumennya harus diindeks. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi untuk akun Anda. OneDrive Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "username": "OAuth client ID", "password": "client secret" } ``` + **IAM peran** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk OneDrive konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAM peran untuk sumber OneDrive data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan dokumen tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber OneDrive data Anda ke bidang indeks Anda Amazon Kendra . Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. + **Pemfilteran konteks pengguna dan kontrol akses** —Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). ------ # OneDrive Konektor Microsoft V2.0 Microsoft OneDrive adalah layanan penyimpanan berbasis cloud yang dapat Anda gunakan untuk menyimpan, berbagi, dan meng-host konten Anda. Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber OneDrive data Anda. Anda dapat terhubung Amazon Kendra ke sumber OneDrive data menggunakan [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/) dan [OneDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/OneDriveConfiguration.html)API. **catatan** Support untuk OneDrive Connector V1.0/ OneDriveConfiguration API dijadwalkan berakhir pada Juni 2023. Kami merekomendasikan menggunakan OneDrive Connector V2.0/ TemplateConfiguration API. Versi 2.0 menyediakan fungsionalitas crawler tambahan ACLs dan identitas. Untuk memecahkan masalah konektor sumber Amazon Kendra OneDrive data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-v2-onedrive) + [Prasyarat](#prerequisites-v2-onedrive) + [Instruksi koneksi](#data-source-procedure-v2-onedrive) ## Fitur yang didukung Amazon Kendra OneDrive konektor sumber data mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan inkremental + Cloud privat virtual (VPC) ## Prasyarat Sebelum dapat digunakan Amazon Kendra untuk mengindeks sumber OneDrive data Anda, buat perubahan ini di akun OneDrive dan AWS akun Anda. **Di OneDrive, pastikan Anda memiliki:** + Membuat OneDrive akun di Office 365. + Mencatat ID penyewa Microsoft 365 Anda. Anda dapat menemukan ID penyewa Anda di Properti Portal Direktori Aktif Azure Anda atau di aplikasi Anda OAuth . + Membuat OAuth aplikasi di portal Azure dan mencatat ID klien dan rahasia klien atau kredensyal klien yang digunakan untuk otentikasi dengan rahasia. AWS Secrets Manager Lihat [tutorial Microsoft](https://learn.microsoft.com/en-us/power-apps/developer/data-platform/walkthrough-register-app-azure-active-directory) dan [contoh aplikasi Terdaftar](https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application) untuk informasi selengkapnya. **catatan** Saat Anda membuat atau mendaftarkan aplikasi di portal Azure, ID rahasia mewakili nilai rahasia yang sebenarnya. Anda harus mencatat atau menyimpan nilai rahasia yang sebenarnya segera saat membuat rahasia dan aplikasi. Anda dapat mengakses rahasia Anda dengan memilih nama aplikasi Anda di portal Azure dan kemudian menavigasi ke opsi menu pada sertifikat dan rahasia. Anda dapat mengakses ID klien Anda dengan memilih nama aplikasi Anda di portal Azure dan kemudian menavigasi ke halaman ikhtisar. ID Aplikasi (klien) adalah ID klien. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + Menggunakan ID aplikasi AD untuk mendaftarkan kunci rahasia untuk aplikasi di situs AD. Kunci rahasia harus berisi ID aplikasi dan kunci rahasia. + Menyalin domain AD organisasi. + Menambahkan izin berikut ke aplikasi AD Anda pada opsi Microsoft Graph: + Baca file di semua koleksi situs (File.Read.All) + Baca profil lengkap semua pengguna (User.Read.All) + Membaca semua grup (Group.Read.All) + Baca semua catatan (Notes.Read.All) + Menyalin daftar pengguna yang dokumennya harus diindeks. Anda dapat memilih untuk memberikan daftar nama pengguna, atau Anda dapat memberikan nama pengguna dalam file yang disimpan dalam file Amazon S3. Setelah membuat sumber data, Anda dapat: + Mengubah daftar pengguna. + Ubah dari daftar pengguna ke daftar yang disimpan dalam Amazon S3 bucket. + Ubah lokasi Amazon S3 bucket daftar pengguna. Jika Anda mengubah lokasi bucket, Anda juga harus memperbarui IAM peran untuk sumber data agar memiliki akses ke bucket. **catatan** Jika Anda menyimpan daftar nama pengguna dalam Amazon S3 bucket, IAM kebijakan untuk sumber data harus menyediakan akses ke bucket dan akses ke kunci yang dienkripsi bucket, jika ada. OneDrive Konektor menggunakan **Email dari Informasi Kontak** yang ada di Properti **Pengguna Onedrive**. Pastikan pengguna yang datanya ingin dirayapi memiliki bidang email yang dikonfigurasi di halaman **Informasi Kontak** karena untuk pengguna baru ini mungkin kosong. **Di AWS akun Anda, pastikan Anda memiliki:** + Membuat Amazon Kendra indeks dan, jika menggunakan API, mencatat id indeks. + Membuat IAM peran untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebut IAM . + Menyimpan kredensyal OneDrive otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat menghubungkan sumber OneDrive data Amazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan id indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber OneDrive data Anda, Anda harus memberikan rincian OneDrive kredensyal Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi OneDrive untuk Amazon Kendra, lihat[Prasyarat](#prerequisites-v2-onedrive). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke OneDrive** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **OneDrive konektor**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **OneDrive konektor** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **OneDrive ID penyewa** —Masukkan ID OneDrive penyewa tanpa protokol. 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. **Dalam **Otentikasi** —Pilih antara **Baru** dan yang Ada.** 1. 1. Jika Anda memilih **yang ada**, pilih rahasia yang ada untuk **Select secret**. 1. Jika Anda memilih **Baru**, masukkan informasi berikut di bagian ** AWS Secrets Manager Rahasia baru**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra- OneDrive -' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **ID Klien** dan **Rahasia Klien** —Masukkan ID klien dan rahasia klien. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. 1. **IAM peran** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten. **catatan** IAM peran yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. 1. Untuk **Sinkronisasi lingkup** —Pilih OneDrive data pengguna mana yang akan diindeks. Anda dapat menambahkan maksimal 10 pengguna secara manual. 1. Untuk **Konfigurasi tambahan** —Tambahkan pola ekspresi reguler untuk menyertakan atau mengecualikan konten tertentu. Anda dapat menambahkan hingga 100 pola. 1. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. **Bidang sumber data default** —Pilih dari bidang sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke OneDrive** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-onedrive-schema) menggunakan API. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `ONEDRIVEV2` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **ID penyewa** —Tentukan ID penyewa Microsoft 365. Anda dapat menemukan ID penyewa Anda di Properti Portal Direktori Aktif Azure Anda atau di aplikasi Anda OAuth . + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi yang Anda buat di akun Anda. OneDrive Jika Anda menggunakan otentikasi OAuth 2.0, rahasia disimpan dalam struktur JSON dengan kunci berikut: ``` { "clientId": "client ID", "clientSecret": "client secret" } ``` + **IAM peran** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk OneDrive konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAM peran untuk sumber OneDrive data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan atau mengecualikan file, OneNote bagian, dan OneNote halaman tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. + **Pemetaan bidang** —Anda hanya dapat memetakan bidang indeks bawaan atau umum untuk konektor. Amazon Kendra OneDrive Pemetaan bidang khusus tidak tersedia untuk OneDrive konektor karena keterbatasan API. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat [skema OneDrive template](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-onedrive-schema). ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber OneDrive data Anda, lihat: + [Mengumumkan OneDrive konektor Microsoft (V2) yang diperbarui untuk Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/announcing-the-updated-microsoft-onedrive-connector-v2-for-amazon-kendra/). ## Catatan + Saat Daftar Kontrol Akses (ACLs) diaktifkan, opsi “Sinkronkan hanya konten baru atau yang dimodifikasi” tidak tersedia karena keterbatasan OneDrive API. Sebaiknya gunakan mode “Sinkronisasi penuh” atau “Sinkronisasi konten baru, dimodifikasi, atau dihapus” sebagai gantinya, atau nonaktifkan ACLs jika Anda perlu menggunakan mode sinkronisasi ini. # Microsoft SharePoint SharePoint adalah layanan pembuatan situs web kolaboratif yang dapat Anda gunakan untuk menyesuaikan konten web dan membuat halaman, situs, pustaka dokumen, dan daftar. Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber SharePoint data Anda. Amazon Kendra saat ini mendukung SharePoint Online dan SharePoint Server (versi 2013, 2016, 2019, dan Edisi Berlangganan). Anda dapat terhubung Amazon Kendra ke sumber SharePoint data menggunakan [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/), [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API, atau [SharePointConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SharePointConfiguration.html)API. Amazon Kendra memiliki dua versi SharePoint konektor. Fitur yang didukung dari setiap versi meliputi: **SharePoint Konektor V1.0 /API [SharePointConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SharePointConfiguration.html)** + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Ubah log + Cloud privat virtual (VPC) **SharePoint Konektor V2.0 /API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)** + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) **catatan** SharePoint konektor V1.0/ SharePointConfiguration API berakhir pada 2023. Kami merekomendasikan untuk bermigrasi ke atau menggunakan SharePoint konektor V2.0/ TemplateConfiguration API. Untuk memecahkan masalah konektor sumber Amazon Kendra SharePoint data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [SharePoint konektor V1.0](data-source-v1-sharepoint.md) + [SharePoint konektor V2.0](data-source-v2-sharepoint.md) # SharePoint konektor V1.0 SharePoint adalah layanan pembuatan situs web kolaboratif yang dapat Anda gunakan untuk menyesuaikan konten web dan membuat halaman, situs, pustaka dokumen, dan daftar. Jika Anda adalah SharePoint pengguna, Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber SharePoint data Anda. **catatan** SharePoint konektor V1.0/ SharePointConfiguration API berakhir pada 2023. Kami merekomendasikan untuk bermigrasi ke atau menggunakan SharePoint konektor V2.0/ TemplateConfiguration API. Untuk memecahkan masalah konektor sumber Amazon Kendra SharePoint data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-v1-sharepoint) + [Prasyarat](#prerequisites-v1-sharepoint) + [Instruksi koneksi](#data-source-procedure-v1-sharepoint) + [Pelajari selengkapnya](#sharepoint-v1-learn-more) ## Fitur yang didukung + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Ubah log + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber SharePoint data Anda, buat perubahan ini di akun SharePoint dan AWS akun Anda. Anda diminta untuk memberikan kredensyal otentikasi, yang Anda simpan dengan aman secara rahasia. AWS Secrets Manager **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). **Di SharePoint, pastikan Anda memiliki:** + Mencatat URL SharePoint situs yang ingin Anda indeks. + **Untuk SharePoint Online:** + Mencatat kredensyal otentikasi dasar Anda yang berisi nama pengguna dan kata sandi dengan izin admin situs. + **Opsional:** Kredensyal OAuth 2.0 yang dihasilkan yang berisi nama pengguna, kata sandi, ID klien, dan rahasia klien. + **Default Keamanan** Dinonaktifkan di portal Azure Anda menggunakan pengguna administratif. Untuk informasi selengkapnya tentang mengelola setelan default keamanan di portal Azure, lihat [dokumentasi Microsoft tentang cara mengamankan enable/disable default](https://learn.microsoft.com/en-us/microsoft-365/business-premium/m365bp-conditional-access?view=o365-worldwide&tabs=secdefaults#security-defaults-1). + **Untuk SharePoint Server:** + Mencatat nama domain SharePoint Server Anda (nama NetBIOS di Direktori Aktif Anda). Anda menggunakan ini, bersama dengan nama pengguna dan kata sandi otentikasi SharePoint dasar Anda, untuk menghubungkan SharePoint Server ke Amazon Kendra. **catatan** Jika Anda menggunakan SharePoint Server dan perlu mengonversi Daftar Kontrol Akses (ACL) Anda ke format email untuk pemfilteran pada konteks pengguna, berikan URL server LDAP dan basis pencarian LDAP. Atau Anda dapat menggunakan penggantian domain direktori. URL server LDAP adalah nama domain lengkap dan nomor port (misalnya, ldap: //example.com:389). Basis pencarian LDAP adalah pengontrol domain 'example' dan 'com'. Dengan penggantian domain direktori, Anda dapat menggunakan domain email alih-alih menggunakan URL server LDAP dan basis pencarian LDAP. Misalnya, domain email untuk username@example.com adalah 'example.com'. Anda dapat menggunakan override ini jika Anda tidak khawatir tentang memvalidasi domain Anda dan hanya ingin menggunakan domain email Anda. + Menambahkan izin berikut ke SharePoint akun Anda: **Untuk SharePoint daftar** + Buka Item—Lihat sumber dokumen dengan penangan file sisi server. + Lihat Halaman Aplikasi—Lihat formulir, tampilan, dan halaman aplikasi. Hitung daftar. + Lihat Item—Lihat item dalam daftar dan dokumen di pustaka dokumen. + Lihat Versi—Lihat versi sebelumnya dari item daftar atau dokumen. **Untuk SharePoint situs web** + Jelajahi Direktori—Hitung file dan folder di situs web menggunakan antarmuka Designer dan Web DAV. SharePoint + Jelajahi Informasi Pengguna—Lihat informasi tentang pengguna situs web. + Hitung Izin—Hitung izin di situs web, daftar, folder, dokumen, atau item daftar. + Buka — Buka situs web, daftar, atau folder untuk mengakses item di dalam wadah. + Gunakan Fitur Integrasi Klien—Gunakan SOAP, WebDAV, model objek klien, atau SharePoint antarmuka Desainer untuk mengakses situs web. + Gunakan Antarmuka Jarak Jauh — Gunakan fitur yang meluncurkan aplikasi klien. + Lihat Halaman — Lihat halaman di situs web. + Memeriksa setiap dokumen unik di dalam SharePoint dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam Anda Akun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebut IAM . **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benar AWS Secrets Manager . + Menyimpan kredensyal SharePoint otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber SharePoint data Anda Amazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber SharePoint data Anda, Anda harus memberikan rincian SharePoint kredensyal Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi SharePoint untuk Amazon Kendra lihat[Prasyarat](#prerequisites-v1-sharepoint). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke SharePoint** 1. Masuk ke Konsol AWS Manajemen dan buka [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **SharePoint konektor v1.0**, lalu pilih **Tambahkan sumber data**. 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. Untuk **metode Hosting** —Pilih antara **SharePoint Online** dan **SharePointServer**. 1. Untuk **SharePointOnline** —Masukkan **Situs URLs khusus untuk SharePoint repositori Anda**. 1. Untuk **SharePointServer** —Pilih **SharePoint versi** Anda, masukkan **Situs URLs khusus untuk SharePoint repositori Anda**, dan masukkan Amazon S3 jalur ke lokasi sertifikat **SSL** Anda. 1. (Hanya SharePoint server) Untuk **proxy Web** —Masukkan **nama Host** dan **nomor Port** SharePoint instans internal Anda. Nomor port harus berupa nilai numerik antara 0 dan 65535. 1. Untuk **Otentikasi** —Pilih di antara opsi berikut berdasarkan kasus penggunaan Anda: 1. **Untuk SharePoint Online—Pilih antara otentikasi **Dasar dan otentikasi 2.0.** OAuth ** 1. **Untuk SharePoint Server—Pilih antara **None**, **LDAP**, dan Manual.** 1. Untuk **AWS Secrets Manager rahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal SharePoint otentikasi Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. Anda harus memasukkan **nama Rahasia**. Awalan 'AmazonKendra- SharePoint -' secara otomatis ditambahkan ke nama rahasia Anda. 1. Masukkan informasi lain berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. Pilih dari opsi otentikasi SharePoint Cloud berikut, berdasarkan kasus penggunaan Anda: 1. **Otentikasi dasar** **—Masukkan nama pengguna SharePoint akun Anda sebagai **Nama pengguna** dan kata sandi SharePoint akun sebagai Kata Sandi.** 1. **OAuth Otentikasi 2.0** **—Masukkan nama pengguna SharePoint akun Anda sebagai **Nama pengguna**, kata sandi SharePoint akun sebagai Kata **Sandi**, SharePoint ID unik yang dibuat secara otomatis sebagai **ID Klien**, dan string rahasia bersama yang digunakan oleh keduanya SharePoint dan Amazon Kendra sebagai rahasia Klien.** 1. Pilih dari opsi otentikasi SharePoint Server berikut, berdasarkan kasus penggunaan Anda: 1. **Tidak ada** **—Masukkan nama pengguna SharePoint akun Anda sebagai **nama Pengguna**, kata sandi SharePoint akun Anda sebagai Kata Sandi, dan **Nama Domain Server** Anda.** 1. **LDAP** —Masukkan nama pengguna SharePoint akun Anda sebagai **Nama pengguna**, kata sandi SharePoint akun sebagai Kata **Sandi**, **Titik Akhir Server LDAP** Anda (termasuk protokol dan nomor port, misalnya*ldap://example.com:389*), dan **Basis Pencarian LDAP** Anda (misalnya,). *dc=example, dc=com* 1. **Manual** —Masukkan nama pengguna SharePoint akun Anda sebagai **Nama pengguna**, kata sandi SharePoint akun Anda sebagai Kata **Sandi**, dan **Penggantian Domain Email Anda** (domain email pengguna atau grup direktori). 1. Pilih **Simpan**. 1. **Virtual Private Cloud (VPC)** **— Anda juga harus menambahkan Subnet **dan** grup keamanan VPC.** **catatan** Anda harus menggunakan VPC jika Anda menggunakan SharePoint Server. Amazon VPC adalah opsional untuk SharePoint versi lain. 1. **IAM peran** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAM peran yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Gunakan Ubah log** —Pilih untuk memperbarui indeks Anda alih-alih menyinkronkan semua file Anda. 1. **Lampiran perayapan —Pilih untuk merayapi lampiran**. 1. **Gunakan pemetaan grup lokal** —Pilih untuk memastikan bahwa dokumen difilter dengan benar. 1. **Konfigurasi tambahan** —Tambahkan pola ekspresi reguler untuk menyertakan atau mengecualikan file tertentu. Anda dapat menambahkan hingga 100 pola. 1. Di **Sync menjalankan jadwal** untuk **Frekuensi** —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. **Amazon Kendra pemetaan bidang default** —Pilih dari bidang sumber data default Amazon Kendra yang dihasilkan yang ingin Anda petakan ke indeks Anda. 1. Untuk **pemetaan bidang Kustom** —Tambahkan bidang sumber data khusus untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke SharePoint** Anda harus menentukan yang berikut menggunakan [SharePointConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SharePointConfiguration.html)API: + **SharePointVersi** —Tentukan SharePoint versi yang Anda gunakan saat mengonfigurasi SharePoint. Ini adalah kasus tidak masalah jika Anda menggunakan SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019, atau SharePoint Online. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi yang Anda buat di SharePoint akun Anda.Rahasia disimpan dalam struktur JSON. Untuk **otentikasi dasar SharePoint Online**, berikut ini adalah struktur JSON minimum yang harus ada dalam rahasia Anda: ``` { "userName": "user name", "password": "password" } ``` Untuk **otentikasi SharePoint Online OAuth 2.0**, berikut ini adalah struktur JSON minimum yang harus ada dalam rahasia Anda: ``` { "userName": "SharePoint account user name"", "password": "SharePoint account password", "clientId": "SharePoint auto-generated unique client id", "clientSecret": "secret string shared by Amazon Kendra and SharePoint to authorize communications" } ``` Untuk **otentikasi dasar SharePoint Server**, berikut ini adalah struktur JSON minimum yang harus ada dalam rahasia Anda: ``` { "userName": "user name", "password": "password", "domain": "server domain name" } ``` Untuk **otentikasi SharePoint Server LDAP** (jika Anda perlu mengonversi daftar kontrol akses (ACL) ke format email untuk pemfilteran pada konteks pengguna, Anda dapat menyertakan URL server LDAP dan basis pencarian LDAP dalam rahasia Anda), berikut ini adalah struktur JSON minimum yang harus ada dalam rahasia Anda: ``` { "userName": "user name", "password": "password", "domain": "server domain name" "ldapServerUrl": "ldap://example.com:389", "ldapSearchBase": "dc=example,dc=com" } ``` Untuk **otentikasi SharePoint Server Manual**, berikut ini adalah struktur JSON minimum yang harus ada dalam rahasia Anda: ``` { "userName": "user name", "password": "password", "domain": "server domain name", "emailDomainOverride": "example.com" } ``` + **IAM peran** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk SharePoint konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAM peran untuk sumber SharePoint data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). + **Amazon VPC**—Jika Anda menggunakan SharePoint Server, tentukan `VpcConfiguration` sebagai bagian dari konfigurasi sumber data. Lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html). Anda juga dapat menambahkan fitur opsional berikut: + **Web proxy** — Apakah akan terhubung ke SharePoint situs Anda URLs melalui proxy web. Anda dapat menggunakan opsi ini hanya untuk SharePoint Server. + **Daftar pengindeksan** —Apakah Amazon Kendra harus mengindeks isi lampiran ke SharePoint daftar item. + **Ubah log** —Apakah Amazon Kendra harus menggunakan mekanisme log perubahan sumber SharePoint data untuk menentukan apakah dokumen harus diperbarui dalam indeks. **catatan** Gunakan log perubahan jika Anda tidak Amazon Kendra ingin memindai semua dokumen. Jika log perubahan Anda besar, mungkin perlu waktu Amazon Kendra lebih sedikit untuk memindai dokumen di sumber SharePoint data daripada memproses log perubahan. Jika Anda menyinkronkan sumber SharePoint data Anda dengan indeks Anda untuk pertama kalinya, semua dokumen dipindai. + **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan atau mengecualikan konten tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber SharePoint data Anda ke bidang indeks Anda Amazon Kendra . Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. + **Pemfilteran konteks pengguna dan kontrol akses** —Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber SharePoint data Anda, lihat: + [Memulai dengan konektor Amazon Kendra SharePoint Online](https://aws.amazon.com/blogs/machine-learning/getting-started-with-the-amazon-kendra-sharepoint-online-connector/) # SharePoint konektor V2.0 SharePoint adalah layanan pembuatan situs web kolaboratif yang dapat Anda gunakan untuk menyesuaikan konten web dan membuat halaman, situs, pustaka dokumen, dan daftar. Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber SharePoint data Anda. Amazon Kendra saat ini mendukung SharePoint Online dan SharePoint Server (2013, 2016, 2019, dan Edisi Berlangganan). **catatan** SharePoint konektor V1.0/ SharePointConfiguration API berakhir pada 2023. Kami merekomendasikan untuk bermigrasi ke atau menggunakan SharePoint konektor V2.0/ TemplateConfiguration API. Untuk memecahkan masalah konektor sumber Amazon Kendra SharePoint data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-v2-sharepoint) + [Prasyarat](#prerequisites-v2-sharepoint) + [Instruksi koneksi](#data-source-procedure-v2-sharepoint) + [Catatan](#sharepoint-notes) ## Fitur yang didukung Amazon Kendra SharePoint konektor sumber data mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber SharePoint data Anda, buat perubahan ini di akun SharePoint dan AWS akun Anda. Anda diminta untuk memberikan kredensyal otentikasi, yang Anda simpan dengan aman secara rahasia. AWS Secrets Manager **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). **Di SharePoint Online, pastikan Anda memiliki:** + Menyalin SharePoint contoh URLs Anda. Format untuk URL host yang Anda masukkan adalah*https://yourdomain.com/sites/mysite*. URL Anda harus dimulai dengan`https`. + Menyalin nama domain URL SharePoint instans Anda. + Mencatat kredensyal otentikasi dasar Anda yang berisi nama pengguna dan kata sandi dengan izin admin situs untuk terhubung ke Online. SharePoint + **Default Keamanan** Dinonaktifkan di portal Azure Anda menggunakan pengguna administratif. Untuk informasi selengkapnya tentang mengelola setelan default keamanan di portal Azure, lihat [dokumentasi Microsoft tentang cara mengamankan enable/disable default](https://learn.microsoft.com/en-us/microsoft-365/business-premium/m365bp-conditional-access?view=o365-worldwide&tabs=secdefaults#security-defaults-1). + Otentikasi multi-faktor (MFA) yang dinonaktifkan di SharePoint akun Anda, sehingga tidak diblokir untuk Amazon Kendra merayapi konten Anda. SharePoint + **Jika menggunakan jenis otentikasi selain otentikasi Dasar: Menyalin** ID penyewa instans Anda. SharePoint Untuk detail tentang cara menemukan ID penyewa, lihat [Menemukan ID penyewa Microsoft 365 Anda](https://learn.microsoft.com/en-us/sharepoint/find-your-office-365-tenant-id). + Jika Anda perlu bermigrasi ke otentikasi pengguna cloud dengan Microsoft Entra, lihat [dokumentasi Microsoft tentang](https://learn.microsoft.com/en-us/entra/identity/hybrid/connect/migrate-from-federation-to-cloud-authentication) otentikasi cloud. + **Untuk otentikasi OAuth OAuth 2.0 dan otentikasi token refresh 2.0: Mencatat** kredensyal **otentikasi Dasar** Anda yang berisi nama pengguna dan kata sandi yang Anda gunakan untuk terhubung ke SharePoint Online dan ID klien serta rahasia klien yang dihasilkan setelah mendaftar dengan Azure AD. SharePoint + **Jika Anda tidak menggunakan ACL**, tambahkan izin berikut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/data-source-v2-sharepoint.html) **catatan** Catatan.Read.All dan Sites.Read.All hanya diperlukan jika Anda ingin merayapi Dokumen. OneNote Jika Anda ingin merayapi situs tertentu, izin dapat dibatasi untuk situs tertentu daripada semua situs yang tersedia di domain. Anda mengonfigurasi **izin Sites.Selected (Aplikasi).** Dengan izin API ini, Anda perlu mengatur izin akses di setiap situs secara eksplisit melalui Microsoft Graph API. Untuk informasi selengkapnya, lihat [blog Microsoft di Situs. Izin yang dipilih.](https://techcommunity.microsoft.com/t5/microsoft-sharepoint-blog/develop-applications-that-use-sites-selected-permissions-for-spo/ba-p/3790476) + **Jika Anda menggunakan ACL**, tambahkan izin berikut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/data-source-v2-sharepoint.html) **catatan** GroupMember**.Read.All dan User.Read.All hanya diperlukan jika crawler Identity diaktifkan.** Jika Anda ingin merayapi situs tertentu, izin dapat dibatasi untuk situs tertentu daripada semua situs yang tersedia di domain. Anda mengonfigurasi **izin Sites.Selected (Aplikasi).** Dengan izin API ini, Anda perlu mengatur izin akses di setiap situs secara eksplisit melalui Microsoft Graph API. Untuk informasi selengkapnya, lihat [blog Microsoft di Situs. Izin yang dipilih.](https://techcommunity.microsoft.com/t5/microsoft-sharepoint-blog/develop-applications-that-use-sites-selected-permissions-for-spo/ba-p/3790476) + **Untuk otentikasi Khusus Aplikasi Azure AD:** Kunci pribadi dan ID Klien yang Anda buat setelah mendaftar SharePoint dengan Azure AD. Perhatikan juga sertifikat X.509. + **Jika Anda tidak menggunakan ACL**, tambahkan izin berikut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/data-source-v2-sharepoint.html) **catatan** Jika Anda ingin merayapi situs tertentu, izin dapat dibatasi untuk situs tertentu daripada semua situs yang tersedia di domain. Anda mengonfigurasi **izin Sites.Selected (Aplikasi).** Dengan izin API ini, Anda perlu mengatur izin akses di setiap situs secara eksplisit melalui Microsoft Graph API. Untuk informasi selengkapnya, lihat [blog Microsoft di Situs. Izin yang dipilih.](https://techcommunity.microsoft.com/t5/microsoft-sharepoint-blog/develop-applications-that-use-sites-selected-permissions-for-spo/ba-p/3790476) + **Jika Anda menggunakan ACL**, tambahkan izin berikut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/data-source-v2-sharepoint.html) **catatan** Jika Anda ingin merayapi situs tertentu, izin dapat dibatasi untuk situs tertentu daripada semua situs yang tersedia di domain. Anda mengonfigurasi **izin Sites.Selected (Aplikasi).** Dengan izin API ini, Anda perlu mengatur izin akses di setiap situs secara eksplisit melalui Microsoft Graph API. Untuk informasi selengkapnya, lihat [blog Microsoft di Situs. Izin yang dipilih.](https://techcommunity.microsoft.com/t5/microsoft-sharepoint-blog/develop-applications-that-use-sites-selected-permissions-for-spo/ba-p/3790476) + **Untuk autentikasi SharePoint App-Only:** SharePoint Mencatat ID klien dan rahasia klien yang dihasilkan saat memberikan izin ke SharePoint App Only, dan ID Klien serta rahasia Klien Anda yang dihasilkan saat Anda mendaftarkan SharePoint aplikasi dengan Azure AD. **catatan** SharePoint Otentikasi Khusus Aplikasi *tidak* didukung untuk SharePoint versi 2013. + **(Opsional) Jika Anda merayapi OneNote dokumen dan menggunakan **crawler Identity****, tambahkan izin berikut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/data-source-v2-sharepoint.html) **catatan** **Tidak diperlukan izin API untuk merayapi entitas menggunakan otentikasi **Dasar dan SharePoint otentikasi khusus aplikasi**.** **Di SharePoint Server, pastikan Anda memiliki:** + Menyalin SharePoint instans Anda URLs dan nama domain Anda SharePoint URLs. Format untuk URL host yang Anda masukkan adalah*https://yourcompany/sites/mysite*. URL Anda harus dimulai dengan`https`. **catatan** (On-premise/server) Amazon Kendra memeriksa apakah informasi titik akhir yang disertakan sama dengan informasi titik akhir yang AWS Secrets Manager ditentukan dalam detail konfigurasi sumber data Anda. Ini membantu melindungi dari [masalah wakil yang membingungkan](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html), yang merupakan masalah keamanan di mana pengguna tidak memiliki izin untuk melakukan tindakan tetapi menggunakan Amazon Kendra sebagai proxy untuk mengakses rahasia yang dikonfigurasi dan melakukan tindakan. Jika nanti Anda mengubah informasi titik akhir Anda, Anda harus membuat rahasia baru untuk menyinkronkan informasi ini. + Otentikasi multi-faktor (MFA) yang dinonaktifkan di SharePoint akun Anda, sehingga tidak diblokir untuk Amazon Kendra merayapi konten Anda. SharePoint + Jika menggunakan **otentikasi SharePoint App-Only untuk kontrol akses**: + Menyalin ID SharePoint klien yang dihasilkan saat Anda mendaftarkan App Only di Tingkat Situs. Format ID klien adalah ClientId @TenantId. Misalnya, *ffa956f3-8f89-44e7-b0e4-49670756342c@888d0b57-69f1-4fb8-957f-e1f0bedf82fe*. + Menyalin rahasia SharePoint klien yang dihasilkan saat Anda mendaftarkan App Only di Tingkat Situs. **Catatan:** Karena rahasia klien IDs dan klien dibuat untuk satu situs hanya ketika Anda mendaftarkan otentikasi SharePoint Server untuk App Only, hanya satu URL situs yang didukung untuk otentikasi SharePoint App Only. **catatan** SharePoint Otentikasi Khusus Aplikasi *tidak* didukung untuk SharePoint versi 2013. + Jika menggunakan **ID Email dengan Domain Kustom** untuk kontrol akses: + Mencatat nilai domain email kustom Anda—misalnya: "”. *amazon.com* + Jika menggunakan **ID Email dengan Domain dari otorisasi IDP**, salin: + LDAP Server Endpoint (titik akhir server LDAP termasuk protokol dan nomor port). Sebagai contoh: *ldap://example.com:389*. + Basis Pencarian LDAP (basis pencarian pengguna LDAP). Sebagai contoh: *CN=Users,DC=sharepoint,DC=com*. + Nama pengguna LDAP dan kata sandi LDAP. + Baik kredensyal otentikasi NTLM yang dikonfigurasi **atau** kredensyal otentikasi Kerberos yang dikonfigurasi yang berisi nama pengguna (nama pengguna akun) dan kata sandi (SharePoint kata sandi akun). SharePoint **Di dalam Anda Akun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebut IAM . **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benar AWS Secrets Manager . + Menyimpan kredensyal SharePoint otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber SharePoint data Anda Amazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber SharePoint data Anda, Anda harus memberikan rincian SharePoint kredensyal Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi SharePoint untuk Amazon Kendra lihat[Prasyarat](#prerequisites-v2-sharepoint). ------ #### [ Console: SharePoint Online ] **Untuk terhubung Amazon Kendra ke SharePoint Online** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **SharePoint konektor**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **SharePoint konektor** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **Metode Hosting** —Pilih **SharePointOnline**. 1. **Situs URLs khusus untuk SharePoint repositori Anda** —Masukkan host. SharePoint URLs Format untuk host yang URLs Anda masukkan adalah*https://yourdomain.sharepoint.com/sites/mysite*. URL harus dimulai dengan `https` protokol. Pisahkan URLs dengan baris baru. Anda dapat menambahkan hingga 100 URLs. 1. **Domain** —Masukkan SharePoint domain. Misalnya, domain di URL *https://yourdomain.sharepoint.com/sites/mysite* adalah*yourdomain*. 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Anda juga dapat memilih jenis ID pengguna, apakah nama utama pengguna atau email pengguna yang diambil dari Portal Azure. Jika Anda tidak menentukan, email digunakan secara default. 1. **Otentikasi** —Pilih otentikasi dasar, OAuth 2.0, Azure AD App-Only, otentikasi App-Only, atau otentikasi SharePoint token refresh 2.0. OAuth Anda dapat memilih AWS Secrets Manager rahasia yang ada untuk menyimpan kredensyal otentikasi Anda, atau membuat rahasia. 1. Jika menggunakan **Otentikasi Dasar**, rahasia Anda harus menyertakan nama rahasia, nama SharePoint pengguna, dan kata sandi. 1. Jika menggunakan **otentikasi OAuth 2.0**, rahasia Anda harus menyertakan ID SharePoint penyewa, nama rahasia, nama SharePoint pengguna, kata sandi, ID klien Azure AD yang dihasilkan saat Anda mendaftar SharePoint di Azure AD, dan rahasia klien Azure AD yang dihasilkan saat Anda mendaftar di Azure AD. SharePoint 1. Jika menggunakan **autentikasi Azure AD App-Only**, rahasia Anda harus menyertakan ID SharePoint penyewa, sertifikat X.509 yang ditandatangani sendiri Azure AD, nama rahasia, ID klien Azure AD yang dihasilkan saat Anda mendaftar SharePoint di Azure AD, dan kunci pribadi untuk mengautentikasi konektor Azure AD. 1. Jika menggunakan **otentikasi SharePoint App-Only**, rahasia Anda harus menyertakan ID SharePoint penyewa, nama rahasia, ID SharePoint klien yang Anda buat saat Anda mendaftarkan App Only di Level Penyewa, rahasia SharePoint klien yang dihasilkan saat mendaftar untuk App Only di Level Penyewa, ID klien Azure AD dihasilkan saat Anda mendaftar SharePoint di Azure AD, dan rahasia klien Azure AD yang dihasilkan saat Anda mendaftar ke Azure AD. SharePoint Format ID SharePoint klien adalah*ClientID@TenantId*. Misalnya, *ffa956f3-8f89-44e7-b0e4-49670756342c@888d0b57-69f1-4fb8-957f-e1f0bedf82fe*. 1. Jika menggunakan **otentikasi token refresh OAuth 2.0**, rahasia Anda harus menyertakan ID SharePoint penyewa, nama rahasia, ID klien Azure AD unik yang dihasilkan saat Anda mendaftar SharePoint di Azure AD, rahasia klien Azure AD yang dihasilkan saat Anda mendaftar SharePoint ke Azure AD, segarkan token yang dihasilkan untuk terhubung. Amazon Kendra SharePoint 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. Anda juga dapat memilih untuk merayapi pemetaan grup lokal atau pemetaan grup Azure Active Directory. **catatan** Perayapan pemetaan Grup AD hanya tersedia untuk token penyegaran OAuth 2.0, OAuth 2.0, dan otentikasi SharePoint App Only. 1. **IAM peran** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAM peran yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Dalam **lingkup Sinkronisasi**, pilih dari opsi berikut: 1. **Pilih entitas** —Pilih entitas yang ingin dirayapi. Anda dapat memilih untuk meng-crawl **Semua** entitas atau kombinasi **File**, **Lampiran**, **Halaman** **Tautan**, **Acara**, **Komentar**, dan Data **Daftar**. 1. Dalam **konfigurasi Tambahan**, untuk pola **regex Entitas —Tambahkan pola** ekspresi reguler untuk **Tautan**, **Halaman**, dan **Acara** untuk menyertakan entitas tertentu alih-alih menyinkronkan semua dokumen Anda. 1. Pola **Regex —Tambahkan pola** ekspresi reguler untuk menyertakan atau mengecualikan file berdasarkan **jalur File**, **Nama file, **Jenis file**, nama OneNote ** **bagian, dan nama OneNote ** **halaman** alih-alih menyinkronkan semua dokumen Anda. Anda dapat menambahkan hingga 100. **catatan** OneNote crawling hanya tersedia untuk OAuth 2.0, OAuth 2.0 refresh token, dan otentikasi SharePoint App Only. 1. Untuk **mode Sinkronisasi** pilih cara Anda ingin memperbarui indeks saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data dengan Amazon Kendra untuk pertama kalinya, semua konten disinkronkan secara default. + **Sinkronisasi penuh** —Sinkronkan semua konten terlepas dari status sinkronisasi sebelumnya. + **Sinkronisasi dokumen baru atau yang dimodifikasi** —Sinkronkan hanya dokumen baru atau yang dimodifikasi. + **Sinkronisasi dokumen baru, dimodifikasi, atau dihapus** —Sinkronkan hanya dokumen baru, dimodifikasi, dan dihapus. 1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. **Bidang sumber data default** —Pilih dari bidang sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ Console: SharePoint Server ] **Untuk terhubung Amazon Kendra ke SharePoint** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **SharePoint konektor**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **SharePoint konektor** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **Metode Hosting** —Pilih **SharePointServer**. 1. **Pilih SharePoint Versi** —Pilih **SharePoint 2013**, **SharePoint 2016**, **SharePoint 2019**, dan **SharePoint (Edisi Berlangganan)**. 1. **Situs URLs khusus untuk SharePoint repositori Anda** —Masukkan host. SharePoint URLs Format untuk host yang URLs Anda masukkan adalah*https://yourcompany/sites/mysite*. URL harus dimulai dengan `https` protokol. Pisahkan URLs dengan baris baru. Anda dapat menambahkan hingga 100 URLs. 1. **Domain** —Masukkan SharePoint domain. Misalnya, domain dalam URL *https://yourcompany/sites/mysite* adalah *yourcompany* 1. **Lokasi sertifikat SSL** —Masukkan Amazon S3 jalur ke file sertifikat SSL Anda. 1. (Opsional) Untuk **proxy Web** —Masukkan nama host (tanpa `https://` protokol `http://` atau), dan nomor port yang digunakan oleh protokol transport URL host. Nilai numerik nomor port harus antara 0 dan 65535. 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Untuk SharePoint Server Anda dapat memilih dari opsi ACL berikut: 1. **ID Email dengan Domain dari IDP** —User ID didasarkan pada email IDs dengan domain mereka diambil dari penyedia identitas yang mendasarinya (IDP). Anda memberikan detail koneksi IDP dalam Secrets Manager rahasia Anda sebagai bagian dari **Otentikasi**. 1. **ID Email dengan Domain Kustom** —ID Pengguna didasarkan pada nilai domain email kustom. Misalnya, "*amazon.com*”. Domain email akan digunakan untuk membuat ID email untuk kontrol akses. Anda harus memasukkan domain email khusus Anda. 1. **Domain\$1 User dengan Domain** —User ID dibangun menggunakan format Domain\$1 User ID. Anda harus memberikan nama domain yang valid. Misalnya: *"sharepoint2019"* untuk membangun kontrol akses. 1. Untuk **Otentikasi**, pilih otentikasi SharePoint App-Only, otentikasi NTLM, atau otentikasi Kerberos. Anda dapat memilih AWS Secrets Manager rahasia yang ada untuk menyimpan kredensyal otentikasi Anda, atau membuat rahasia. 1. Jika menggunakan otentikasi **NTLM atau otentikasi** **Kerberos**, rahasia Anda harus menyertakan nama rahasia, nama pengguna, dan kata sandi. SharePoint Jika menggunakan **ID Email dengan Domain dari IDP**, masukkan juga: + **LDAP Server Endpoint** — Endpoint dari server LDAP, termasuk protokol dan nomor port. Sebagai contoh: *ldap://example.com:389*. + **Basis Pencarian LDAP —Basis** pencarian pengguna LDAP. Sebagai contoh: *CN=Users,DC=sharepoint,DC=com*. + Nama pengguna **LDAP —Nama pengguna** LDAP Anda. + Kata Sandi **LDAP —Kata sandi** LDAP Anda. 1. Jika menggunakan **otentikasi SharePoint App-Only**, rahasia Anda harus menyertakan nama rahasia, ID SharePoint klien yang Anda buat saat Anda mendaftarkan App Only di Tingkat Situs, rahasia SharePoint klien yang dihasilkan saat Anda mendaftar untuk App Only di Tingkat Situs. Format ID SharePoint klien adalah*ClientID@TenantId*. Misalnya, *ffa956f3-8f89-44e7-b0e4-49670756342c@888d0b57-69f1-4fb8-957f-e1f0bedf82fe*. **Catatan:** Karena rahasia klien IDs dan klien dibuat untuk satu situs hanya ketika Anda mendaftarkan otentikasi SharePoint Server untuk App Only, hanya satu URL situs yang didukung untuk otentikasi SharePoint App Only. Jika menggunakan **ID Email dengan Domain dari IDP**, masukkan juga: + **LDAP Server Endpoint** — Endpoint dari server LDAP, termasuk protokol dan nomor port. Sebagai contoh: *ldap://example.com:389*. + **Basis Pencarian LDAP —Basis** pencarian pengguna LDAP. Sebagai contoh: *CN=Users,DC=sharepoint,DC=com*. + Nama pengguna **LDAP —Nama pengguna** LDAP Anda. + Kata Sandi **LDAP —Kata sandi** LDAP Anda. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. Anda juga dapat memilih untuk merayapi pemetaan grup lokal atau pemetaan grup Azure Active Directory. **catatan** Perayapan pemetaan Grup AD hanya tersedia autentikasi SharePoint App Only. 1. **IAM peran** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAM peran yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Dalam **lingkup Sinkronisasi**, pilih dari opsi berikut: 1. **Pilih entitas** —Pilih entitas yang ingin dirayapi. Anda dapat memilih untuk merayapi **Semua** entitas atau kombinasi **File**, **Lampiran**, **Halaman** **Tautan**, **Acara**, dan Data **Daftar**. 1. Dalam **konfigurasi Tambahan**, untuk pola **regex Entitas —Tambahkan pola** ekspresi reguler untuk **Tautan**, **Halaman**, dan **Acara** untuk menyertakan entitas tertentu alih-alih menyinkronkan semua dokumen Anda. 1. Pola **Regex —Tambahkan pola** ekspresi reguler untuk menyertakan atau mengecualikan file berdasarkan **jalur File** Nama file **Jenis file****, nama OneNote** **bagian, dan nama OneNote** **halaman** alih-alih menyinkronkan semua dokumen Anda. Anda dapat menambahkan hingga 100. **catatan** OneNote crawling hanya tersedia untuk otentikasi SharePoint App Only. 1. **Mode sinkronisasi** —Pilih cara Anda ingin memperbarui indeks saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. **Bidang sumber data default** —Pilih dari bidang sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke SharePoint** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) menggunakan API. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `SHAREPOINTV2` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **Metadata Titik Akhir Repositori** —Tentukan dan contoh Anda. `tenantID` `domain` `siteUrls` SharePoint + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. **catatan** Crawler identitas hanya tersedia saat Anda menyetel `crawlAcl` ke`true`. + **Properti Tambahan Repositori** —Tentukan: + (Untuk Azure AD) `s3bucketName` dan `s3certificateName` Anda gunakan untuk menyimpan sertifikat X.509 yang ditandatangani sendiri Azure AD Anda. + Jenis otentikasi (`auth_Type`) yang Anda gunakan, apakah`OAuth2`,`OAuth2App`,`OAuth2Certificate`,`Basic`,, `OAuth2_RefreshToken``NTLM`, dan`Kerberos`. + Version (`version`) yang Anda gunakan, apakah `Server` atau`Online`. Jika Anda menggunakan `Server` Anda dapat lebih lanjut menentukan `onPremVersion` sebagai`2013`,, `2016``2019`, atau`SubscriptionEdition`. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi yang Anda buat di akun Anda. SharePoint Jika Anda menggunakan SharePoint Online, Anda dapat memilih antara otentikasi Dasar, OAuth 2.0, Azure AD App-only dan SharePoint App Only. Berikut ini adalah struktur JSON minimum yang harus ada dalam rahasia Anda untuk setiap opsi otentikasi: + **Otentikasi dasar** ``` { "userName": "SharePoint account user name", "password": "SharePoint account password" } ``` + **OAuth 2.0 otentikasi** ``` { "clientId": "client id generated when registering SharePoint with Azure AD", "clientSecret": "client secret generated when registering SharePoint with Azure AD", "userName": "SharePoint account user name", "password": "SharePoint account password" } ``` + **Autentikasi Khusus Aplikasi Azure AD** ``` { "clientId": "client id generated when registering SharePoint with Azure AD", "privateKey": "private key to authorize connection with Azure AD" } ``` + **SharePoint Autentikasi App-Only** ``` { "clientId": "client id generated when registering SharePoint for App Only at Tenant Level", "clientSecret": "client secret generated when registering SharePoint for App Only at Tenant Level", "adClientId": "client id generated while registering SharePoint with Azure AD", "adClientSecret": "client secret generated while registering SharePoint with Azure AD" } ``` + **OAuth 2.0 refresh otentikasi token** ``` { "clientId": "client id generated when registering SharePoint with Azure AD", "clientSecret": "client secret generated when registering SharePoint with Azure AD", "refreshToken": "refresh token generated to connect to SharePoint" } ``` Jika Anda menggunakan SharePoint Server, Anda dapat memilih antara otentikasi SharePoint App-Only, otentikasi NTLM, dan otentikasi Kerberos. Berikut ini adalah struktur JSON minimum yang harus ada dalam rahasia Anda untuk setiap opsi otentikasi: + ** SharePoint Autentikasi App-Only** ``` { "siteUrlsHash": "Hash representation of SharePoint site URLs", "clientId": "client id generated when registering SharePoint for App Only at Site Level", "clientSecret": "client secret generated when registering SharePoint for App Only at Site Level" } ``` + ** SharePoint Autentikasi App-Only dengan domain dari otorisasi IDP** ``` { "siteUrlsHash": "Hash representation of SharePoint site URLs", "clientId": "client id generated when registering SharePoint for App Only at Site Level", "clientSecret": "client secret generated when registering SharePoint for App Only at Site Level", "ldapUrl": "LDAP Account url eg. ldap://example.com:389", "baseDn": "LDAP Account base dn eg. CN=Users,DC=sharepoint,DC=com", "ldapUser": "LDAP account user name", "ldapPassword": "LDAP account password" } ``` + **(Hanya server) otentikasi NTLM atau Kerberos** ``` { "siteUrlsHash": "Hash representation of SharePoint site URLs", "userName": "SharePoint account user name", "password": "SharePoint account password" } ``` + **(Hanya server) Otentikasi NTLM atau Kerberos dengan domain dari otorisasi IDP** ``` { "siteUrlsHash": "Hash representation of SharePoint site URLs", "userName": "SharePoint account user name", "password": "SharePoint account password", "ldapUrl": "ldap://example.com:389", "baseDn": "CN=Users,DC=sharepoint,DC=com", "ldapUser": "LDAP account user name", "ldapPassword": "LDAP account password" } ``` + **IAM peran** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk SharePoint konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAM peran untuk sumber SharePoint data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan atau mengecualikan file tertentu, OneNotes, dan konten lainnya. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber SharePoint data Anda ke bidang indeks Anda Amazon Kendra . Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat [skema SharePoint template](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-sharepoint). ------ ## Catatan + Konektor mendukung pemetaan bidang khusus hanya untuk entitas **File**. + Untuk semua versi SharePoint Server, token ACL harus dalam huruf kecil. Untuk **Email dengan Domain dari IDP** dan **ID Email dengan Custom Domain** ACL, misalnya:. *user@sharepoint2019.com* Untuk **Domain\$1 User dengan Domain** ACL, misalnya:*sharepoint2013\$1user*. + Ketika Access Control Lists (ACLs) diaktifkan, opsi “Sinkronkan hanya konten baru atau yang dimodifikasi” tidak tersedia karena keterbatasan SharePoint API. Sebaiknya gunakan mode “Sinkronisasi penuh” atau “Sinkronisasi konten baru, dimodifikasi, atau dihapus” sebagai gantinya, atau nonaktifkan ACLs jika Anda perlu menggunakan mode sinkronisasi ini. + Konektor tidak mendukung mode log **perubahan/Sinkronisasi konten baru atau yang dimodifikasi untuk SharePoint tahun 2013**. + Jika nama entitas memiliki `%` karakter dalam namanya, konektor akan melewati file-file ini karena keterbatasan API. + OneNote hanya dapat dirayapi oleh konektor menggunakan ID Penyewa, dan dengan token penyegaran OAuth 2.0, OAuth 2.0, atau otentikasi SharePoint App Only diaktifkan untuk Online. SharePoint + Konektor merayapi bagian pertama OneNote dokumen menggunakan nama defaultnya saja, meskipun dokumen tersebut diganti namanya. + **Konektor merayapi tautan di SharePoint 2019, SharePoint Online, dan Edisi Berlangganan, hanya jika **Halaman** dan **File** dipilih sebagai entitas yang akan dirayapi selain Tautan.** + Konektor merayapi tautan pada SharePoint tahun 2013 dan SharePoint 2016 jika **Tautan** dipilih sebagai entitas yang akan dirayapi. + Konektor merayapi lampiran daftar dan komentar hanya jika **Data Daftar** juga dipilih sebagai entitas yang akan di-crawl. + Konektor merayapi lampiran peristiwa hanya jika **Peristiwa** juga dipilih sebagai entitas yang akan dirayapi. + Untuk versi SharePoint Online, token ACL akan dalam huruf kecil. Misalnya, jika **nama utama Pengguna** ada *MaryMajor@domain.com* di portal Azure, token ACL di SharePoint Connector akan berada. *marymajor@domain.com* + Di **Perayap Identitas** untuk SharePoint Online dan Server, jika Anda ingin merayapi grup bersarang, Anda harus mengaktifkan Perayapan Lokal dan Grup AD. + Jika Anda menggunakan SharePoint Online, dan Nama Utama Pengguna di Portal Azure Anda adalah kombinasi dari huruf besar dan huruf kecil, SharePoint API secara internal mengonversinya menjadi huruf kecil. Karena itu, Amazon Kendra SharePoint konektor menetapkan ACL dalam huruf kecil. # Microsoft SQL Server **catatan** Microsoft SQL Serverkonektor tetap didukung penuh untuk pelanggan yang sudah ada hingga 31 Mei 2026. Meskipun konektor ini tidak lagi tersedia untuk pengguna baru, pengguna saat ini dapat terus menggunakannya tanpa gangguan. Kami terus mengembangkan portofolio konektor kami untuk menawarkan solusi yang lebih terukur dan dapat disesuaikan. Untuk integrasi masa depan, sebaiknya jelajahi Amazon Kendra Custom Connector Framework [1], yang dirancang untuk mendukung rangkaian kasus penggunaan perusahaan yang lebih luas dengan fleksibilitas yang ditingkatkan. Microsoft SQL Serveradalah sistem manajemen basis data relasional (RDBMS) yang dikembangkan oleh Microsoft. Jika Anda adalah Microsoft SQL Server pengguna, Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber Microsoft SQL Server data Anda. Konektor sumber Amazon Kendra Microsoft SQL Server data mendukung MS SQL Server 2019. Anda dapat terhubung Amazon Kendra ke sumber Microsoft SQL Server data menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber Amazon Kendra Microsoft SQL Server data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-ms-sql-server) + [Prasyarat](#prerequisites-ms-sql-server) + [Instruksi koneksi](#data-source-procedure-ms-sql-server) + [Catatan](#ms-sql-server-notes) ## Fitur yang didukung + Pemetaan bidang + Pemfilteran konteks pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum dapat digunakan Amazon Kendra untuk mengindeks sumber Microsoft SQL Server data Anda, buat perubahan ini di akun Microsoft SQL Server dan AWS akun Anda. **DiMicrosoft SQL Server, pastikan Anda memiliki:** + Mencatat nama pengguna dan kata sandi database Anda. **penting** Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Menyalin url, port, dan instance host database Anda. + Memeriksa setiap dokumen unik di dalam Microsoft SQL Server dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensyal Microsoft SQL Server otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber Microsoft SQL Server data AndaAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber Microsoft SQL Server data Anda, Anda harus memberikan rincian Microsoft SQL Server kredensyal Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Microsoft SQL Server untuk Amazon Kendra lihat[Prasyarat](#prerequisites-ms-sql-server). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Microsoft SQL Server** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **Microsoft SQL Serverkonektor**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **Microsoft SQL Serverkonektor** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. Di **Sumber**, masukkan informasi berikut: 1. **Host** — Masukkan nama host database. 1. **Port** — Masukkan port database. 1. **Instance** - Masukkan instance database. 1. **Aktifkan lokasi sertifikat SSL** —Pilih untuk memasukkan Amazon S3 jalur ke file sertifikat SSL Anda. 1. Dalam **Otentikasi** —masukkan informasi berikut: 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal Microsoft SQL Server otentikasi Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra- Microsoft SQL Server -' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **nama pengguna Database**, dan **Kata Sandi** —Masukkan nilai kredensi otentikasi yang Anda salin dari database Anda. 1. Pilih **Simpan**. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **IAMperan** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensyal repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Dalam **lingkup Sinkronisasi**, pilih dari opsi berikut: + **Kueri SQL**—Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. **catatan** Jika nama tabel menyertakan karakter khusus (non alfanumerik) dalam nama, Anda harus menggunakan tanda kurung siku di sekitar nama tabel. Sebagai contoh, *select \$1 from [my-database-table]*. + **Kolom kunci primer**—Berikan kunci primer untuk tabel basis data. Detail ini mengidentifikasi tabel di dalam basis data Anda. + **Kolom judul**—Berikan nama kolom judul dokumen di dalam tabel basis data Anda. + **Kolom tubuh** —Berikan nama kolom badan dokumen dalam tabel database Anda. 1. Dalam **Konfigurasi tambahan — *opsional***, pilih dari opsi berikut untuk menyinkronkan konten tertentu alih-alih menyinkronkan semua file: + **Kolom pendeteksi perubahan** —Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendraakan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini. + ** IDsKolom pengguna** —Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. + **Kolom grup**—Masukkan nama kolom yang berisi grup untuk diizinkan mengakses konten. + ** URLsKolom sumber** —Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. + **Kolom stempel waktu** —Masukkan nama kolom yang berisi stempel waktu. Amazon Kendramenggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. + **Kolom zona waktu**—Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. + **Format stempel waktu**—Masukkan nama kolom yang berisi format stempel waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. 1. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Dalam **jadwal berjalan Sinkronisasi**, untuk **Frekuensi** —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang sumber data default yang dihasilkan— **Dokumen IDs**, **Judul dokumen**, dan **Sumber URLs** —Anda ingin memetakan ke Amazon Kendra indeks. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Microsoft SQL Server** Anda harus menentukan yang berikut menggunakan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API: + **Sumber data** —Tentukan tipe sumber data seperti `JDBC` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Juga tentukan sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **Jenis database** —Anda harus menentukan jenis database sebagai`sqlserver`. + **Kueri SQL** —Tentukan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. **catatan** Jika nama tabel menyertakan karakter khusus (non alfanumerik) dalam nama, Anda harus menggunakan tanda kurung siku di sekitar nama tabel. Sebagai contoh, *select \$1 from [my-database-table]*. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensi otentikasi yang Anda buat di akun Anda. Microsoft SQL Server Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "user name": "database user name", "password": "password" } ``` **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk Microsoft SQL Server konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber Microsoft SQL Server data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan konten tertentu menggunakan pengguna IDs, grup, sumber, stempel waktu URLs, dan zona waktu. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber Microsoft SQL Server data Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat[Skema templat Microsoft SQL Server](ds-schemas.md#ds-ms-sql-server-schema). ------ ## Catatan + Baris database yang dihapus tidak akan dilacak saat Amazon Kendra memeriksa konten yang diperbarui. + Ukuran nama bidang dan nilai dalam deretan database Anda tidak dapat melebihi 400KB. + Jika Anda memiliki sejumlah besar data dalam sumber data database Anda, dan tidak Amazon Kendra ingin mengindeks semua konten database Anda setelah sinkronisasi pertama, Anda dapat memilih untuk menyinkronkan hanya dokumen baru, dimodifikasi, atau dihapus. + Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Sebagai praktik terbaik, hindari menambahkan tabel dengan data sensitif atau informasi identitas pribadi (PII). # Microsoft Teams Microsoft Teams adalah alat kolaborasi perusahaan untuk pengiriman pesan, rapat, dan berbagi file. Jika Anda adalah pengguna Microsoft Teams, Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Microsoft Teams Anda. Anda dapat terhubung Amazon Kendra ke sumber data Microsoft Teams menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber data Amazon Kendra Microsoft Teams, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-teams) + [Prasyarat](#prerequisites-teams) + [Instruksi koneksi](#data-source-procedure-teams) + [Pelajari selengkapnya](#teams-learn-more) + [Catatan](#teams-notes) ## Fitur yang didukung + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum dapat digunakan Amazon Kendra untuk mengindeks sumber data Microsoft Teams, buat perubahan ini di Tim dan AWS akun Microsoft Anda. **Di Microsoft Teams, pastikan Anda memiliki:** + Membuat akun Microsoft Teams di Office 365. + Mencatat ID penyewa Microsoft 365 Anda. Anda dapat menemukan ID penyewa Anda di Properti Portal Direktori Aktif Azure Anda atau di aplikasi Anda OAuth . + Mengkonfigurasi OAuth aplikasi di portal Azure dan mencatat ID klien dan rahasia klien atau kredensi klien. Lihat [tutorial Microsoft](https://learn.microsoft.com/en-us/power-apps/developer/data-platform/walkthrough-register-app-azure-active-directory) dan [contoh aplikasi Terdaftar](https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application) untuk informasi selengkapnya. **catatan** Saat Anda membuat atau mendaftarkan aplikasi di portal Azure, ID rahasia mewakili nilai rahasia yang sebenarnya. Anda harus mencatat atau menyimpan nilai rahasia yang sebenarnya segera saat membuat rahasia dan aplikasi. Anda dapat mengakses rahasia Anda dengan memilih nama aplikasi Anda di portal Azure dan kemudian menavigasi ke opsi menu pada sertifikat dan rahasia. Anda dapat mengakses ID klien Anda dengan memilih nama aplikasi Anda di portal Azure dan kemudian menavigasi ke halaman ikhtisar. ID Aplikasi (klien) adalah ID klien. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + Menambahkan izin yang diperlukan. Anda dapat memilih untuk menambahkan semua izin, atau Anda dapat membatasi cakupan dengan memilih lebih sedikit izin berdasarkan entitas yang ingin dirayapi. Tabel berikut mencantumkan izin tingkat aplikasi oleh entitas yang sesuai: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/data-source-teams.html) + Memeriksa setiap dokumen unik di Microsoft Teams dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi Microsoft Teams Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasianya. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data Microsoft TeamsAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk menyambung Amazon Kendra ke sumber data Microsoft Teams, Anda harus memberikan detail yang diperlukan dari sumber data Microsoft Teams agar Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengonfigurasi Microsoft TeamsAmazon Kendra, lihat[Prasyarat](#prerequisites-teams). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Microsoft Teams** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambah sumber data**, pilih **konektor Microsoft Teams**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Microsoft Teams** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. ID **penyewa —Masukkan ID** penyewa Microsoft 365 Anda. Anda dapat menemukan ID penyewa Anda di Properti Portal Direktori Aktif Azure Anda atau di aplikasi Anda OAuth . 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensi otentikasi Microsoft Teams Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-Microsoft Teams-' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **ID Klien** dan **rahasia Klien** —Masukkan kredensi otentikasi yang dikonfigurasi di Microsoft Teams di portal Azure. 1. Simpan dan tambahkan rahasia Anda. 1. **Model pembayaran** —Anda dapat memilih model lisensi dan pembayaran untuk akun Microsoft Teams Anda. Model pembayaran Model A dibatasi untuk lisensi dan model pembayaran yang memerlukan kepatuhan keamanan. Model pembayaran Model B cocok untuk lisensi dan model pembayaran yang tidak memerlukan kepatuhan keamanan. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Sinkronkan konten** —Pilih jenis konten yang akan di-crawl. Anda dapat memilih untuk merayapi konten obrolan, tim, dan kalender. 1. **Konfigurasi tambahan** —Tentukan tanggal mulai dan berakhir kalender tertentu, email pengguna, nama tim, dan nama saluran, lampiran, dan. OneNotes 1. **Mode sinkronisasi** —Pilih cara Anda ingin memperbarui indeks saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Bidang **sumber data default —Pilih dari bidang** sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Microsoft Teams** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) menggunakan API. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `MSTEAMS` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **ID Penyewa** —Anda dapat menemukan ID penyewa Anda di Properti Portal Direktori Aktif Azure Anda atau di aplikasi Anda. OAuth + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensi otentikasi untuk akun Microsoft Teams Anda. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "clientId": "client ID", "clientSecret": "client secret" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Microsoft Teams dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Microsoft Teams](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Jenis dokumen/konten** —Tentukan apakah akan merayapi pesan dan lampiran obrolan, posting saluran dan lampiran, wiki saluran, konten kalender, obrolan rapat, file dan catatan. + **Konten kalender** —Tentukan tanggal-waktu mulai dan berakhir untuk merayapi konten kalender. + **Filter penyertaan dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan konten tertentu di Microsoft Teams. Anda dapat menyertakan atau mengecualikan nama tim, nama saluran, nama file dan jenis file, email pengguna, OneNote bagian, dan OneNote halaman. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Microsoft Teams Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya yang harus dikonfigurasi, lihat [Skema template Microsoft Teams](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-msteams-schema). ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Microsoft Teams, lihat: + [Cari sumber data Microsoft Teams organisasi Anda secara cerdas dengan Amazon Kendra konektor untuk Microsoft Teams](https://aws.amazon.com/blogs/machine-learning/intelligently-search-your-organizations-microsoft-teams-data-source-with-the-amazon-kendra-connector-for-microsoft-teams/) ## Catatan + Saat Daftar Kontrol Akses (ACLs) diaktifkan, opsi “Sinkronkan hanya konten baru atau yang dimodifikasi” tidak tersedia karena keterbatasan Microsoft Teams API. Sebaiknya gunakan mode “Sinkronisasi penuh” atau “Sinkronisasi konten baru, dimodifikasi, atau dihapus” sebagai gantinya, atau nonaktifkan ACLs jika Anda perlu menggunakan mode sinkronisasi ini. # Microsoft Yammer **catatan** Konektor Microsoft Yammer tetap didukung penuh untuk pelanggan lama hingga 31 Mei 2026. Meskipun konektor ini tidak lagi tersedia untuk pengguna baru, pengguna saat ini dapat terus menggunakannya tanpa gangguan. Kami terus mengembangkan portofolio konektor kami untuk menawarkan solusi yang lebih terukur dan dapat disesuaikan. Untuk integrasi masa depan, sebaiknya jelajahi Amazon Kendra Custom Connector Framework [1], yang dirancang untuk mendukung rangkaian kasus penggunaan perusahaan yang lebih luas dengan fleksibilitas yang ditingkatkan. Microsoft Yammer adalah alat kolaborasi perusahaan untuk pengiriman pesan, rapat, dan berbagi file. Jika Anda adalah pengguna Microsoft Yammer, Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Microsoft Yammer Anda. Anda dapat terhubung Amazon Kendra ke sumber data Microsoft Yammer menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber data Amazon Kendra Microsoft Yammer, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) ## Fitur yang didukung + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan inkremental + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Microsoft Yammer Anda, buat perubahan ini di Microsoft Yammer dan AWS akun Anda. **Di Microsoft Yammer, pastikan Anda memiliki:** + Membuat akun administratif Microsoft Yammer di Office 365. + Mencatat nama pengguna dan kata sandi Microsoft Yammer Anda. + Mencatat ID penyewa Microsoft 365 Anda. Anda dapat menemukan ID penyewa Anda di Properti Portal Direktori Aktif Azure Anda atau di aplikasi Anda OAuth . + Mengkonfigurasi OAuth aplikasi di portal Azure dan mencatat ID klien dan rahasia klien atau kredensi klien. Lihat [tutorial Microsoft](https://learn.microsoft.com/en-us/power-apps/developer/data-platform/walkthrough-register-app-azure-active-directory) dan [contoh aplikasi Terdaftar](https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application) untuk informasi selengkapnya. **catatan** Saat Anda membuat atau mendaftarkan aplikasi di portal Azure, ID rahasia mewakili nilai rahasia yang sebenarnya. Anda harus mencatat atau menyimpan nilai rahasia yang sebenarnya segera saat membuat rahasia dan aplikasi. Anda dapat mengakses rahasia Anda dengan memilih nama aplikasi Anda di portal Azure dan kemudian menavigasi ke opsi menu pada sertifikat dan rahasia. Anda dapat mengakses ID klien Anda dengan memilih nama aplikasi Anda di portal Azure dan kemudian menavigasi ke halaman ikhtisar. ID Aplikasi (klien) adalah ID klien. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + Memeriksa setiap dokumen unik di Microsoft Yammer dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi Microsoft Yammer Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasianya. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data Microsoft Yammer keAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Microsoft Yammer Anda, Anda harus memberikan rincian yang diperlukan dari sumber data Microsoft Yammer Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengonfigurasi Microsoft Yammer untukAmazon Kendra, lihat[Prasyarat](#prerequisites-yammer). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Microsoft Yammer** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambah sumber data**, pilih **konektor Microsoft Yammer**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Microsoft Yammer dengan tag** “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensi otentikasi Microsoft Yammer Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-Microsoft Yammer -' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **Nama Pengguna**, **Kata Sandi** —Masukkan nama pengguna dan kata sandi Microsoft Yammer Anda. 1. Untuk **ID Klien**, **Rahasia klien** —Masukkan kredensi otentikasi yang dikonfigurasi di Microsoft Yammer di portal Azure. 1. Simpan dan tambahkan rahasia Anda. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Sejak tanggal** —Tentukan tanggal untuk mulai merayapi data Anda di Microsoft Yammer. 1. **Sinkronkan konten** —Pilih jenis konten yang akan di-crawl. Misalnya, pesan publik, pesan pribadi, dan lampiran. 1. **Konfigurasi tambahan** —Tentukan nama komunitas tertentu yang ingin dirayapi, dan juga gunakan pola ekspresi reguler untuk menyertakan atau mengecualikan konten tertentu. 1. **Mode sinkronisasi** —Pilih cara Anda ingin memperbarui indeks saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Bidang **sumber data default —Pilih dari bidang** sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Microsoft Yammer** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) menggunakan API. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `YAMMER` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN) —Berikan** Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensi otentikasi untuk akun Microsoft Yammer Anda. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "username": "user name", "password": "password", "clientId": "client ID", "clientSecret": "client secret" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Microsoft Yammer dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Microsoft Yammer](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Jenis dokumen/konten** —Tentukan apakah akan merayapi konten komunitas, pesan dan lampiran, serta pesan pribadi. + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan konten tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Microsoft Yammer Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat Skema [template Microsoft Yammer](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-yammer). ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Microsoft Yammer Anda, lihat: + [Mengumumkan konektor Yammer untuk Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/announcing-the-yammer-connector-for-amazon-kendra/) # MySQL **catatan** MySQLkonektor tetap didukung penuh untuk pelanggan yang sudah ada hingga 31 Mei 2026. Meskipun konektor ini tidak lagi tersedia untuk pengguna baru, pengguna saat ini dapat terus menggunakannya tanpa gangguan. Kami terus mengembangkan portofolio konektor kami untuk menawarkan solusi yang lebih terukur dan dapat disesuaikan. Untuk integrasi masa depan, sebaiknya jelajahi Amazon Kendra Custom Connector Framework [1], yang dirancang untuk mendukung rangkaian kasus penggunaan perusahaan yang lebih luas dengan fleksibilitas yang ditingkatkan. MySQLadalah sistem manajemen database relasional open source. Jika Anda adalah MySQL pengguna, Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber MySQL data Anda. Konektor sumber Amazon Kendra MySQL data mendukung MySQL 8.0. 21. Anda dapat terhubung Amazon Kendra ke sumber MySQL data menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber Amazon Kendra MySQL data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-mysql) + [Prasyarat](#prerequisites-mysql) + [Instruksi koneksi](#data-source-procedure-mysql) + [Catatan](#mysql-notes) ## Fitur yang didukung + Pemetaan bidang + Pemfilteran konteks pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber MySQL data Anda, buat perubahan ini di akun MySQL dan AWS akun Anda. **DiMySQL, pastikan Anda memiliki:** + Mencatat nama pengguna dan kata sandi database Anda. **penting** Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Menyalin url, port, dan instance host database Anda. + Memeriksa setiap dokumen unik di dalam MySQL dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensyal MySQL otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber MySQL data AndaAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber MySQL data Anda, Anda harus memberikan rincian MySQL kredensyal Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi MySQL untuk Amazon Kendra lihat[Prasyarat](#prerequisites-mysql). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke MySQL** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **MySQLkonektor**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **MySQLkonektor** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen menggantikan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. Di **Sumber**, masukkan informasi berikut: 1. **Host** — Masukkan nama host database. 1. **Port** — Masukkan port database. 1. **Instance** - Masukkan instance database. 1. **Aktifkan lokasi sertifikat SSL** —Pilih untuk memasukkan Amazon S3 jalur ke file sertifikat SSL Anda. 1. Dalam **Otentikasi** —masukkan informasi berikut: 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal MySQL otentikasi Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra- MySQL -' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **nama pengguna Database**, dan **Kata Sandi** —Masukkan nilai kredensi otentikasi yang Anda salin dari database Anda. 1. Pilih **Simpan**. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Dalam **lingkup Sinkronisasi**, pilih dari opsi berikut: + **Kueri SQL**—Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. + **Kolom kunci primer**—Berikan kunci primer untuk tabel basis data. Detail ini mengidentifikasi tabel di dalam basis data Anda. + **Kolom judul**—Berikan nama kolom judul dokumen di dalam tabel basis data Anda. + **Kolom tubuh** —Berikan nama kolom badan dokumen dalam tabel database Anda. 1. Dalam **Konfigurasi tambahan — *opsional***, pilih dari opsi berikut untuk menyinkronkan konten tertentu alih-alih menyinkronkan semua file: + **Kolom pendeteksi perubahan** —Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendraakan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini. + ** IDsKolom pengguna** —Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. + **Kolom grup**—Masukkan nama kolom yang berisi grup untuk diizinkan mengakses konten. + ** URLsKolom sumber** —Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. + **Kolom stempel waktu** —Masukkan nama kolom yang berisi stempel waktu. Amazon Kendramenggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. + **Kolom zona waktu**—Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. + **Format stempel waktu**—Masukkan nama kolom yang berisi format stempel waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. 1. **Mode sinkronisasi** —Pilih cara Anda ingin memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Dalam **jadwal berjalan Sinkronisasi**, untuk **Frekuensi** —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang sumber data default yang dihasilkan— **Dokumen IDs**, **Judul dokumen**, dan **Sumber URLs** —Anda ingin memetakan ke Amazon Kendra indeks. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke MySQL** Anda harus menentukan yang berikut menggunakan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API: + **Sumber data** —Tentukan tipe sumber data seperti `JDBC` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **Jenis database** —Anda harus menentukan jenis database sebagai`mySql`. + **Kueri SQL** —Tentukan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi yang Anda buat di akun Anda. MySQL Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "user name": "database user name", "password": "password" } ``` **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk MySQL konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber MySQL data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan konten tertentu menggunakan pengguna IDs, grup, sumber, stempel waktu URLs, dan zona waktu. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber MySQL data Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. ------ ## Catatan + Baris database yang dihapus tidak akan dilacak saat Amazon Kendra memeriksa konten yang diperbarui. + Ukuran nama bidang dan nilai dalam deretan database Anda tidak dapat melebihi 400KB. + Jika Anda memiliki sejumlah besar data dalam sumber data database Anda, dan tidak Amazon Kendra ingin mengindeks semua konten database Anda setelah sinkronisasi pertama, Anda dapat memilih untuk menyinkronkan hanya dokumen baru, dimodifikasi, atau dihapus. + Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Sebagai praktik terbaik, hindari menambahkan tabel dengan data sensitif atau informasi identitas pribadi (PII). # Oracle Database **catatan** Oracle Databasekonektor tetap didukung penuh untuk pelanggan yang sudah ada hingga 31 Mei 2026. Meskipun konektor ini tidak lagi tersedia untuk pengguna baru, pengguna saat ini dapat terus menggunakannya tanpa gangguan. Kami terus mengembangkan portofolio konektor kami untuk menawarkan solusi yang lebih terukur dan dapat disesuaikan. Untuk integrasi masa depan, sebaiknya jelajahi Amazon Kendra Custom Connector Framework [1], yang dirancang untuk mendukung rangkaian kasus penggunaan perusahaan yang lebih luas dengan fleksibilitas yang ditingkatkan. Oracle Databaseadalah sistem manajemen basis data. Jika Anda adalah Oracle Database pengguna, Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber Oracle Database data Anda. Konektor sumber Amazon Kendra Oracle Database data mendukung Oracle Database 18c, 19c, dan 21c. Anda dapat terhubung Amazon Kendra ke sumber Oracle Database data menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber Amazon Kendra Oracle Database data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-oracle-database) + [Prasyarat](#prerequisites-oracle-database) + [Instruksi koneksi](#data-source-procedure-oracle-database) + [Catatan](#oracle-database-notes) ## Fitur yang didukung + Pemetaan bidang + Pemfilteran konteks pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan inkremental + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber Oracle Database data Anda, buat perubahan ini di akun Oracle Database dan AWS akun Anda. **DiOracle Database, pastikan Anda memiliki:** + Mencatat nama pengguna dan kata sandi database Anda. **penting** Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Menyalin url, port, dan instance host database Anda. + Memeriksa setiap dokumen unik di dalam Oracle Database dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensyal Oracle Database otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber Oracle Database data AndaAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber Oracle Database data Anda, Anda harus memberikan rincian Oracle Database kredensyal Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Oracle Database untuk Amazon Kendra lihat[Prasyarat](#prerequisites-oracle-database). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Oracle Database** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **Oracle Databasekonektor**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **Oracle Databasekonektor** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. Di **Sumber**, masukkan informasi berikut: 1. **Host** — Masukkan nama host database. 1. **Port** — Masukkan port database. 1. **Instance** - Masukkan instance database. 1. **Aktifkan lokasi sertifikat SSL** —Pilih untuk memasukkan Amazon S3 jalur ke file sertifikat SSL Anda. 1. Dalam **Otentikasi** —masukkan informasi berikut: 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal Oracle Database otentikasi Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra- Oracle Database -' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **nama pengguna Database**, dan **Kata Sandi** —Masukkan nilai kredensi otentikasi yang Anda salin dari database Anda. 1. Pilih **Simpan**. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **IAMperan** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Dalam **lingkup Sinkronisasi**, pilih dari opsi berikut: + **Kueri SQL**—Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. + **Kolom kunci primer**—Berikan kunci primer untuk tabel basis data. Detail ini mengidentifikasi tabel di dalam basis data Anda. + **Kolom judul**—Berikan nama kolom judul dokumen di dalam tabel basis data Anda. + **Kolom tubuh** —Berikan nama kolom badan dokumen dalam tabel database Anda. 1. Dalam **Konfigurasi tambahan — *opsional***, pilih dari opsi berikut untuk menyinkronkan konten tertentu alih-alih menyinkronkan semua file: + **Kolom pendeteksi perubahan** —Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendraakan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini. + ** IDsKolom pengguna** —Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. + **Kolom grup**—Masukkan nama kolom yang berisi grup untuk diizinkan mengakses konten. + ** URLsKolom sumber** —Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. + **Kolom stempel waktu** —Masukkan nama kolom yang berisi stempel waktu. Amazon Kendramenggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. + **Kolom zona waktu**—Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. + **Format stempel waktu**—Masukkan nama kolom yang berisi format stempel waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. 1. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Dalam **jadwal berjalan Sinkronisasi**, untuk **Frekuensi** —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang sumber data default yang dihasilkan— **Dokumen IDs**, **Judul dokumen**, dan **Sumber URLs** —Anda ingin memetakan ke Amazon Kendra indeks. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Oracle Database** Anda harus menentukan yang berikut menggunakan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API: + **Sumber data** —Tentukan tipe sumber data seperti `JDBC` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **Jenis database** —Anda harus menentukan jenis database sebagai`oracle`. + **Kueri SQL** —Tentukan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi yang Anda buat di akun Anda. Oracle Database Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "user name": "database user name", "password": "password" } ``` **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk Oracle Database konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber Oracle Database data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan konten tertentu menggunakan pengguna IDs, grup, sumber, stempel waktu URLs, dan zona waktu. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber Oracle Database data Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat[Skema templat Oracle Database](ds-schemas.md#ds-oracle-database-schema). ------ ## Catatan + Baris database yang dihapus tidak akan dilacak saat Amazon Kendra memeriksa konten yang diperbarui. + Ukuran nama bidang dan nilai dalam deretan database Anda tidak dapat melebihi 400KB. + Jika Anda memiliki sejumlah besar data dalam sumber data database Anda, dan tidak Amazon Kendra ingin mengindeks semua konten database Anda setelah sinkronisasi pertama, Anda dapat memilih untuk menyinkronkan hanya dokumen baru, dimodifikasi, atau dihapus. + Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Sebagai praktik terbaik, hindari menambahkan tabel dengan data sensitif atau informasi identitas pribadi (PII). # PostgreSQL **catatan** PostgreSQLkonektor tetap didukung penuh untuk pelanggan yang sudah ada hingga 31 Mei 2026. Meskipun konektor ini tidak lagi tersedia untuk pengguna baru, pengguna saat ini dapat terus menggunakannya tanpa gangguan. Kami terus mengembangkan portofolio konektor kami untuk menawarkan solusi yang lebih terukur dan dapat disesuaikan. Untuk integrasi masa depan, sebaiknya jelajahi Amazon Kendra Custom Connector Framework [1], yang dirancang untuk mendukung rangkaian kasus penggunaan perusahaan yang lebih luas dengan fleksibilitas yang ditingkatkan. PostgreSQLadalah sistem manajemen database open source. Jika Anda adalah PostgreSQL pengguna, Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber PostgreSQL data Anda. Konektor sumber Amazon Kendra PostgreSQL data mendukung PostgreSQL 9.6. Anda dapat terhubung Amazon Kendra ke sumber PostgreSQL data menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber Amazon Kendra PostgreSQL data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-postgresql) + [Prasyarat](#prerequisites-postgresql) + [Instruksi koneksi](#data-source-procedure-postgresql) + [Catatan](#postgresql-notes) ## Fitur yang didukung + Pemetaan bidang + Pemfilteran konteks pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber PostgreSQL data Anda, buat perubahan ini di akun PostgreSQL dan AWS akun Anda. **DiPostgreSQL, pastikan Anda memiliki:** + Mencatat nama pengguna dan kata sandi database Anda. **penting** Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Menyalin url, port, dan instance host database Anda. + Memeriksa setiap dokumen unik di dalam PostgreSQL dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensyal PostgreSQL otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber PostgreSQL data AndaAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber PostgreSQL data Anda, Anda harus memberikan rincian PostgreSQL kredensyal Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi PostgreSQL untuk Amazon Kendra lihat[Prasyarat](#prerequisites-postgresql). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke PostgreSQL** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **PostgreSQLkonektor**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **PostgreSQLkonektor** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen menggantikan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. Di **Sumber**, masukkan informasi berikut: 1. **Host** — Masukkan nama host database. 1. **Port** — Masukkan port database. 1. **Instance** - Masukkan instance database. 1. **Aktifkan lokasi sertifikat SSL** —Pilih untuk memasukkan Amazon S3 jalur ke file sertifikat SSL Anda. 1. Dalam **Otentikasi** —masukkan informasi berikut: 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal PostgreSQL otentikasi Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra- PostgreSQL -' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **nama pengguna Database**, dan **Kata Sandi** —Masukkan nilai kredensi otentikasi yang Anda salin dari database Anda. 1. Pilih **Simpan**. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Dalam **lingkup Sinkronisasi**, pilih dari opsi berikut: + **Kueri SQL**—Masukkan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. + **Kolom kunci primer**—Berikan kunci primer untuk tabel basis data. Detail ini mengidentifikasi tabel di dalam basis data Anda. + **Kolom judul**—Berikan nama kolom judul dokumen di dalam tabel basis data Anda. + **Kolom tubuh** —Berikan nama kolom badan dokumen dalam tabel database Anda. 1. Dalam **Konfigurasi tambahan — *opsional***, pilih dari opsi berikut untuk menyinkronkan konten tertentu alih-alih menyinkronkan semua file: + **Kolom pendeteksi perubahan** —Masukkan nama kolom yang Amazon Kendra akan digunakan untuk mendeteksi perubahan konten. Amazon Kendraakan mengindeks ulang konten ketika ada perubahan di salah satu kolom ini. + ** IDsKolom pengguna** —Masukkan nama kolom yang berisi Pengguna IDs untuk diizinkan mengakses konten. + **Kolom grup**—Masukkan nama kolom yang berisi grup untuk diizinkan mengakses konten. + ** URLsKolom sumber** —Masukkan nama kolom yang berisi Sumber yang akan URLs diindeks. + **Kolom stempel waktu** —Masukkan nama kolom yang berisi stempel waktu. Amazon Kendramenggunakan informasi cap waktu untuk mendeteksi perubahan dalam konten Anda dan hanya menyinkronkan konten yang diubah. + **Kolom zona waktu**—Masukkan nama kolom yang berisi zona waktu untuk konten yang akan dirayapi. + **Format stempel waktu**—Masukkan nama kolom yang berisi format stempel waktu yang akan digunakan untuk mendeteksi perubahan konten dan menyinkronkan ulang konten Anda. 1. **Mode sinkronisasi** —Pilih cara Anda ingin memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Dalam **jadwal berjalan Sinkronisasi**, untuk **Frekuensi** —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang sumber data default yang dihasilkan— **Dokumen IDs**, **Judul dokumen**, dan **Sumber URLs** —Anda ingin memetakan ke Amazon Kendra indeks. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke PostgreSQL** Anda harus menentukan yang berikut menggunakan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API: + **Sumber data** —Tentukan tipe sumber data seperti `JDBC` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **Jenis database** —Anda harus menentukan jenis database sebagai`postgresql`. + **Kueri SQL** —Tentukan pernyataan kueri SQL seperti operasi SELECT dan JOIN. Kueri SQL harus kurang dari 32KB. Amazon Kendra akan merayapi semua konten basis data yang cocok dengan kueri Anda. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi yang Anda buat di akun Anda. PostgreSQL Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "user name": "database user name", "password": "password" } ``` **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk PostgreSQL konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber PostgreSQL data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan konten tertentu menggunakan pengguna IDs, grup, sumber, stempel waktu URLs, dan zona waktu. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber PostgreSQL data Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat[Skema Templat PostgreSQL](ds-schemas.md#ds-postgresql-schema). ------ ## Catatan + Baris database yang dihapus tidak akan dilacak saat Amazon Kendra memeriksa konten yang diperbarui. + Ukuran nama bidang dan nilai dalam deretan database Anda tidak dapat melebihi 400KB. + Jika Anda memiliki sejumlah besar data dalam sumber data database Anda, dan tidak Amazon Kendra ingin mengindeks semua konten database Anda setelah sinkronisasi pertama, Anda dapat memilih untuk menyinkronkan hanya dokumen baru, dimodifikasi, atau dihapus. + Sebagai praktik terbaik, sediakan Amazon Kendra kredensil basis data hanya-baca. + Sebagai praktik terbaik, hindari menambahkan tabel dengan data sensitif atau informasi identitas pribadi (PII). # Quip **catatan** Konektor Quip tetap didukung penuh untuk pelanggan lama hingga 31 Mei 2026. Meskipun konektor ini tidak lagi tersedia untuk pengguna baru, pengguna saat ini dapat terus menggunakannya tanpa gangguan. Kami terus mengembangkan portofolio konektor kami untuk menawarkan solusi yang lebih terukur dan dapat disesuaikan. Untuk integrasi masa depan, sebaiknya jelajahi Amazon Kendra Custom Connector Framework [1], yang dirancang untuk mendukung rangkaian kasus penggunaan perusahaan yang lebih luas dengan fleksibilitas yang ditingkatkan. Quip adalah perangkat lunak produktivitas kolaboratif yang menawarkan kemampuan penulisan dokumen waktu nyata. Anda dapat menggunakan Amazon Kendra untuk mengindeks folder Quip, file, komentar file, ruang obrolan, dan lampiran Quip Anda. Anda dapat terhubung Amazon Kendra ke sumber data Quip menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [QuipConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QuipConfiguration.html)API. Untuk memecahkan masalah konektor sumber data Amazon Kendra Quip, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-quip) + [Prasyarat](#prerequisites-quip) + [Instruksi koneksi](#data-source-procedure-quip) + [Pelajari selengkapnya](#quip-learn-more) ## Fitur yang didukung Amazon KendraKonektor sumber data Quip mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Quip Anda, buat perubahan ini di Quip dan AWS akun Anda. **Di Quip, pastikan Anda memiliki:** + Akun Quip dengan izin administratif. + Kredensi otentikasi Quip dibuat yang menyertakan token akses pribadi. Token digunakan sebagai kredensi otentikasi Anda yang disimpan dalam rahasia. AWS Secrets Manager Lihat [dokumentasi Quip tentang otentikasi](https://quip.com/dev/admin/documentation/current#section/Authentication) untuk informasi selengkapnya. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + Menyalin domain situs Quip Anda. Misalnya, *https://quip-company.quipdomain.com/browse* di *quipdomain* mana domainnya. + Memeriksa setiap dokumen unik di Quip dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi Quip Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data Quip. Amazon Kendra Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Quip Anda, Anda harus memberikan rincian yang diperlukan dari sumber data Quip Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Quip untukAmazon Kendra, lihat[Prasyarat](#prerequisites-quip). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Quip** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambah sumber data**, pilih **konektor Quip**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Quip dengan tag** “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **Nama domain Quip** —Masukkan Quip yang Anda salin dari akun Quip Anda. 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal otentikasi Quip Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-Quip-' secara otomatis ditambahkan ke nama rahasia Anda. 1. **Token Quip** —Masukkan Quip akses pribadi Quip yang dikonfigurasi Quip. 1. Tambahkan dan simpan rahasia Anda. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Tambahkan folder Quip IDs ke crawl** —Folder Quip yang IDs ingin Anda jelajahi. **catatan** Untuk merayapi folder root, termasuk semua sub-folder dan dokumen di dalamnya, tambahkan ID folder root. Untuk merayapi sub-folder tertentu, tambahkan sub-folder tertentu. IDs 1. **Konfigurasi tambahan (tipe konten)** —Masukkan jenis konten yang ingin dirayapi. 1. Pola **Regex —Pola** ekspresi reguler untuk menyertakan atau mengecualikan file tertentu. Anda dapat menambahkan hingga 100 pola. 1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Pilih dari bidang sumber data default yang dihasilkan yang ingin Anda petakan untuk Amazon Kendra diindeks. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Quip** Anda harus menentukan yang berikut menggunakan [QuipConfiguration ](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QuipConfiguration.html)API: + **Domain situs Quip** —Misalnya, *https://quip-company.quipdomain.com/browse* di mana *quipdomain* domainnya. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi untuk akun Quip Anda. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "accessToken": "token" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Quip dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Quip](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC)** —Tentukan `VpcConfiguration` sebagai bagian dari konfigurasi sumber data. Lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html). + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan file tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Folder** —Tentukan folder Quip dan subfolder yang ingin Anda indeks **catatan** Untuk merayapi folder root, termasuk semua sub-folder dan dokumen di dalamnya, masukkan ID folder root. Untuk merayapi sub-folder tertentu, tambahkan sub-folder tertentu. IDs + **Lampiran, ruang obrolan, komentar file** —Pilih apakah akan menyertakan crawling lampiran, konten ruang obrolan, dan komentar file. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Quip Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Quip, lihat: + [Cari pengetahuan dalam dokumen Quip dengan pencarian cerdas menggunakan konektor Quip untuk Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/search-for-knowledge-in-quip-documents-with-intelligent-search-using-the-quip-connector-for-amazon-kendra/) # Salesforce Salesforce adalah alat manajemen hubungan pelanggan (CRM) untuk mengelola tim dukungan, penjualan, dan pemasaran. Anda dapat menggunakan Amazon Kendra untuk mengindeks objek standar Salesforce Anda dan bahkan objek kustom. Anda dapat terhubung Amazon Kendra ke sumber data Salesforce menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/), [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API, atau API. [SalesforceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SalesforceConfiguration.html) Amazon Kendramemiliki dua versi konektor Salesforce. Fitur yang didukung dari setiap versi meliputi: **Konektor Salesforce V1.0 /API [SalesforceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SalesforceConfiguration.html)** + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian **Konektor Salesforce V2.0 /API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)** + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) **catatan** Konektor Salesforce V1.0/ SalesforceConfiguration API berakhir pada 2023. Kami merekomendasikan untuk bermigrasi ke atau menggunakan konektor Salesforce V2.0/API. TemplateConfiguration Untuk memecahkan masalah konektor sumber data Amazon Kendra Salesforce Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Konektor Salesforce V1.0](data-source-v1-salesforce.md) + [Konektor Salesforce V2.0](data-source-v2-salesforce.md) # Konektor Salesforce V1.0 Salesforce adalah alat manajemen hubungan pelanggan (CRM) untuk mengelola tim dukungan, penjualan, dan pemasaran. Anda dapat menggunakan Amazon Kendra untuk mengindeks objek standar Salesforce Anda dan bahkan objek kustom. **penting** Amazon Kendramenggunakan Salesforce API versi 48. Salesforce API membatasi jumlah permintaan yang dapat Anda buat per hari. Jika Salesforce melebihi permintaan tersebut, ia mencoba lagi sampai dapat melanjutkan. **catatan** Konektor Salesforce V1.0/ SalesforceConfiguration API berakhir pada 2023. Kami merekomendasikan untuk bermigrasi ke atau menggunakan konektor Salesforce V2.0/API. TemplateConfiguration Untuk memecahkan masalah konektor sumber data Amazon Kendra Salesforce Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-v1-salesforce) + [Prasyarat](#prerequisites-v1-salesforce) + [Instruksi koneksi](#data-source-procedure-v1-salesforce) ## Fitur yang didukung Amazon KendraKonektor sumber data Salesforce mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Salesforce Anda, buat perubahan ini di Salesforce dan akun Anda. AWS **Di Salesforce, pastikan Anda memiliki:** + Membuat akun Salesforce dan telah mencatat nama pengguna dan kata sandi yang Anda gunakan untuk terhubung ke Salesforce. + Membuat akun Salesforce Connected App dengan OAuth diaktifkan dan telah menyalin kunci konsumen (ID klien) dan rahasia konsumen (rahasia klien) yang ditetapkan ke Aplikasi Salesforce Connected Anda. ID klien dan rahasia klien digunakan sebagai kredensi otentikasi Anda yang disimpan dalam rahasia. AWS Secrets Manager Lihat [dokumentasi Salesforce di Aplikasi Terhubung](https://help.salesforce.com/s/articleView?id=sf.connected_app_overview.htm&type=5) untuk informasi selengkapnya. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + Menyalin token keamanan Salesforce yang terkait dengan akun yang digunakan untuk terhubung ke Salesforce. + Menyalin URL instance Salesforce yang ingin Anda indeks. Biasanya, ini adalah *https://.salesforce.com/*. Server harus menjalankan aplikasi yang terhubung dengan Salesforce. + Menambahkan kredensyal ke server Salesforce Anda untuk pengguna dengan akses hanya-baca ke Salesforce dengan mengkloning ReadOnly profil dan kemudian menambahkan izin Lihat Semua Data dan Kelola Artikel. Kredensil ini mengidentifikasi pengguna yang membuat koneksi dan aplikasi terhubung Salesforce yang terhubung ke. Amazon Kendra + Memeriksa setiap dokumen unik di Salesforce dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi Salesforce Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data Salesforce. Amazon Kendra Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Salesforce Anda, Anda harus memberikan rincian yang diperlukan dari sumber data Salesforce Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Salesforce untuk Amazon Kendra lihat. [Prasyarat](#prerequisites-v1-salesforce) ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Salesforce** 1. Masuk ke Konsol AWS Manajemen dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. **Pada halaman **Tambah sumber data**, pilih Konektor **Salesforce V1.0, lalu pilih Tambah konektor**.** 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. **Bahasa default** — Bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata menggantikan bahasa yang dipilih. 1. **Tambahkan tag baru —Tag** untuk mencari dan memfilter sumber daya Anda atau melacak biaya bersama Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. URL **Salesforce —Masukkan URL** instance untuk situs Salesforce yang ingin Anda indeks. 1. Untuk **Jenis otentikasi**, pilih antara **Existing** dan **New** untuk menyimpan kredensyal otentikasi Salesforce Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-Salesforce-' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **Nama Pengguna**, **Kata Sandi**, **Token keamanan**, **Kunci konsumen**, **Rahasia konsumen**, dan **URL Otentikasi** —Masukkan nilai kredensi otentikasi yang Anda buat di akun Salesforce Anda. 1. Pilih **Simpan otentikasi.** 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Untuk **lampiran Crawl** —Pilih untuk meng-crawl semua objek, artikel, dan feed yang dilampirkan. 1. Untuk **objek Standar**, **artikel Pengetahuan**, dan **umpan obrolan** —Pilih entitas Salesforce atau jenis konten yang ingin dirayapi. **catatan** Anda harus memberikan informasi konfigurasi untuk mengindeks setidaknya satu objek standar, artikel pengetahuan, atau umpan obrolan. Jika Anda memilih untuk merayapi **artikel Pengetahuan**, Anda harus menentukan jenis artikel pengetahuan yang akan diindeks, nama artikel, dan apakah akan mengindeks bidang standar semua artikel pengetahuan atau hanya bidang jenis artikel kustom. Jika Anda memilih untuk mengindeks artikel kustom, Anda harus menentukan nama internal dari jenis artikel. Anda dapat menentukan hingga 10 jenis artikel. 1. **Frekuensi** —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Untuk **artikel pengetahuan Standar**, **Lampiran objek standar**, dan **Pemetaan bidang yang disarankan tambahan** —Pilih dari bidang sumber data default Amazon Kendra yang dihasilkan yang ingin Anda petakan ke indeks Anda. **catatan** Diperlukan pemetaan `_document_body` indeks. Anda tidak dapat mengubah pemetaan antara `Salesforce ID` bidang dan Amazon Kendra `_document_id ` bidang. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Salesforce** Anda harus menentukan [SalesforceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SalesforceConfiguration.html)API berikut ini: + **URL Server —URL** contoh untuk situs Salesforce yang ingin Anda indeks. + **Rahasia Nama Sumber Daya Amazon (ARN) —Berikan** Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi untuk akun Salesforce Anda. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "authenticationUrl": "OAUTH endpoint that Amazon Kendra connects to get an OAUTH token", "consumerKey": "Application public key generated when you created your Salesforce application", "consumerSecret": "Application private key generated when you created your Salesforce application.", "password": "Password associated with the user logging in to the Salesforce instance", "securityToken": "Token associated with the user account logging in to the Salesforce instance", "username": "User name of the user logging in to the Salesforce instance" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Salesforce dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Salesforce](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). + Anda harus memberikan informasi konfigurasi untuk mengindeks setidaknya satu objek standar, artikel pengetahuan, atau umpan obrolan. + **Objek standar** —Jika Anda memilih untuk merayapi **objek Standar**, Anda harus menentukan nama objek standar dan nama bidang dalam tabel objek standar yang berisi konten dokumen. + **Artikel pengetahuan** —Jika Anda memilih untuk merayapi **artikel Pengetahuan**, Anda harus menentukan jenis artikel pengetahuan yang akan diindeks, status artikel pengetahuan yang akan diindeks, dan apakah akan mengindeks bidang standar semua artikel pengetahuan atau hanya bidang dari jenis artikel khusus. + **Umpan obrolan** —Jika Anda memilih untuk merayapi **umpan Chatter**, Anda harus menentukan nama kolom dalam tabel Salesforce FeedItem yang berisi konten yang akan diindeks. Anda juga dapat menambahkan fitur opsional berikut: + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan lampiran file tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Salesforce Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). ------ # Konektor Salesforce V2.0 Salesforce adalah alat manajemen hubungan pelanggan (CRM) untuk mengelola tim dukungan, penjualan, dan pemasaran. Anda dapat menggunakan Amazon Kendra untuk mengindeks objek standar Salesforce Anda dan bahkan objek kustom. Konektor sumber data Amazon Kendra Salesforce mendukung edisi Salesforce berikut: Edisi Pengembang dan Edisi Perusahaan. **catatan** Konektor Salesforce V1.0/ SalesforceConfiguration API berakhir pada 2023. Kami merekomendasikan untuk bermigrasi ke atau menggunakan konektor Salesforce V2.0/API. TemplateConfiguration Untuk memecahkan masalah konektor sumber data Amazon Kendra Salesforce Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-v2-salesforce) + [Prasyarat](#prerequisites-v2-salesforce) + [Instruksi koneksi](#data-source-procedure-v2-salesforce) + [Pelajari selengkapnya](#salesforce-v2-learn-more) + [Catatan](#salesforce-notes) ## Fitur yang didukung Amazon KendraKonektor sumber data Salesforce mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Salesforce Anda, buat perubahan ini di Salesforce dan akun Anda. AWS **Di Salesforce, pastikan Anda memiliki:** + Membuat akun administratif Salesforce dan telah mencatat nama pengguna dan kata sandi yang Anda gunakan untuk terhubung ke Salesforce. + Menyalin token keamanan Salesforce yang terkait dengan akun yang digunakan untuk terhubung ke Salesforce. + Membuat akun Salesforce Connected App dengan OAuth diaktifkan dan telah menyalin kunci konsumen (ID klien) dan rahasia konsumen (rahasia klien) yang ditetapkan ke Aplikasi Salesforce Connected Anda. ID klien dan rahasia klien digunakan sebagai kredensi otentikasi Anda yang disimpan dalam rahasia. AWS Secrets Manager Lihat [dokumentasi Salesforce di Aplikasi Terhubung](https://help.salesforce.com/s/articleView?id=sf.connected_app_overview.htm&type=5) untuk informasi selengkapnya. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + Menyalin URL instance Salesforce yang ingin Anda indeks. Biasanya, ini adalah *https://.salesforce.com/*. Server harus menjalankan aplikasi yang terhubung dengan Salesforce. + Menambahkan kredensyal ke server Salesforce Anda untuk pengguna dengan akses hanya-baca ke Salesforce dengan mengkloning ReadOnly profil dan kemudian menambahkan izin Lihat Semua Data dan Kelola Artikel. Kredensil ini mengidentifikasi pengguna yang membuat koneksi dan aplikasi terhubung Salesforce yang terhubung ke. Amazon Kendra + Memeriksa setiap dokumen unik di Salesforce dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi Salesforce Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data Salesforce. Amazon Kendra Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Salesforce Anda, Anda harus memberikan rincian yang diperlukan dari sumber data Salesforce Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Salesforce untuk Amazon Kendra lihat. [Prasyarat](#prerequisites-v2-salesforce) ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Salesforce**: 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambah sumber data**, pilih konektor **Salesforce, lalu pilih **Tambah** konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Salesforce** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. URL **Salesforce —Masukkan URL** contoh untuk situs Salesforce yang ingin Anda indeks. 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. Masukkan rahasia yang ada atau jika Anda membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. **Otentikasi** —Masukkan informasi berikut di jendela **Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-Salesforce-' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **Nama Pengguna**, **Kata Sandi**, **Token keamanan**, **Kunci konsumen**, **Rahasia konsumen**, dan **URL Otentikasi** —Masukkan nilai kredensi otentikasi yang Anda buat dan unduh dari akun Salesforce Anda. **catatan** Jika Anda menggunakan Salesforce Developer Edition, gunakan `https://login.salesforce.com/services/oauth2/token` atau URL login Domain Saya (misalnya,* https://MyCompany.my.salesforce.com*) sebagai URL **Otentikasi**. **Jika Anda menggunakan Salesforce Sandbox Edition, gunakan `https://test.salesforce.com/services/oauth2/token ` atau URL login Domain Saya (misalnya,* MyDomainName--SandboxName.sandbox.my.salesforce.com*) sebagai URL Otentikasi.** 1. Pilih **Simpan otentikasi.** 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Untuk **lampiran Crawl** —Pilih untuk meng-crawl semua objek Salesforce yang terpasang. 1. Untuk **objek Standar, Objek** **standar dengan lampiran**, dan **objek Standar tanpa lampiran** dan **Artikel Pengetahuan** —Pilih entitas Salesforce atau tipe konten yang ingin dirayapi. 1. Anda harus memberikan informasi konfigurasi untuk mengindeks setidaknya satu objek standar, artikel pengetahuan, atau umpan obrolan. Jika Anda memilih untuk merayapi **artikel Pengetahuan**, Anda harus menentukan jenis artikel pengetahuan yang akan diindeks. Anda dapat memilih diterbitkan, diarsipkan, draf, dan lampiran. **Filter Regex** —Tentukan pola regex untuk menyertakan item katalog tertentu. 1. Untuk **konfigurasi tambahan**: + **Informasi ACL** Semua daftar kontrol akses disertakan secara default. Menghapus pilihan daftar kontrol akses akan membuat semua file dalam kategori itu publik. + Pola **Regex —Tambahkan pola** ekspresi reguler untuk menyertakan atau mengecualikan file tertentu. Anda dapat menambahkan hingga 100 pola. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Untuk **artikel pengetahuan Standar**, **Lampiran objek standar**, dan **Pemetaan bidang yang disarankan tambahan** —Pilih dari bidang sumber data default Amazon Kendra yang dihasilkan yang ingin Anda petakan ke indeks Anda. **catatan** Diperlukan pemetaan `_document_body` indeks. Anda tidak dapat mengubah pemetaan antara `Salesforce ID` bidang dan Amazon Kendra `_document_id ` bidang. Anda dapat memetakan bidang Salesforce apa pun ke judul dokumen atau kolom indeks Amazon reserved/default Kendra badan dokumen. Jika Anda memetakan bidang Salesforce apa pun ke bidang judul dokumen dan badan dokumen Amazon Kendra, Amazon Kendra akan menggunakan data dari judul dokumen dan bidang isi dalam respons penelusuran. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Salesforce** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) menggunakan API. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `SALESFORCEV2` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **URL Host** —Tentukan URL host instance Salesforce. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN) —Berikan** Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi untuk akun Salesforce Anda. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "authenticationUrl": "OAUTH endpoint that Amazon Kendra connects to get an OAUTH token", "consumerKey": "Application public key generated when you created your Salesforce application", "consumerSecret": "Application private key generated when you created your Salesforce application", "password": "Password associated with the user logging in to the Salesforce instance", "securityToken": "Token associated with the user account logging in to the Salesforce instance", "username": "User name of the user logging in to the Salesforce instance" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Salesforce dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Salesforce](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan atau mengecualikan dokumen, akun, kampanye, kasus, kontak, prospek, peluang, solusi, tugas, grup, obrolan, dan file entitas kustom tertentu. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Salesforce Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. **catatan** Diperlukan pemetaan `_document_body` indeks. Anda tidak dapat mengubah pemetaan antara `Salesforce ID` bidang dan Amazon Kendra `_document_id ` bidang. Anda dapat memetakan bidang Salesforce apa pun ke judul dokumen atau kolom indeks Amazon reserved/default Kendra badan dokumen. Jika Anda memetakan bidang Salesforce apa pun ke bidang judul dokumen dan badan dokumen Amazon Kendra, Amazon Kendra akan menggunakan data dari judul dokumen dan bidang isi dalam respons penelusuran. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat Skema template [Salesforce](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-salesforce-schema). ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Salesforce Anda, lihat: + [Mengumumkan konektor Salesforce yang diperbarui (V2) untuk Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/announcing-the-updated-salesforce-connector-v2-for-amazon-kendra/) ## Catatan + Saat Daftar Kontrol Akses (ACLs) diaktifkan, opsi “Sinkronkan hanya konten baru atau yang dimodifikasi” tidak tersedia karena keterbatasan API Salesforce. Sebaiknya gunakan mode “Sinkronisasi penuh” atau “Sinkronisasi konten baru, dimodifikasi, atau dihapus” sebagai gantinya, atau nonaktifkan ACLs jika Anda perlu menggunakan mode sinkronisasi ini. # ServiceNow ServiceNow menyediakan sistem manajemen layanan berbasis cloud untuk membuat dan mengelola alur kerja tingkat organisasi, seperti layanan TI, sistem tiket, dan dukungan. Anda dapat menggunakannya Amazon Kendra untuk mengindeks ServiceNow katalog, artikel pengetahuan, insiden, dan lampirannya. Anda dapat terhubung Amazon Kendra ke sumber ServiceNow data menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/), [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API, atau [ServiceNowConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ServiceNowConfiguration.html)API. Amazon Kendramemiliki dua versi ServiceNow konektor. Fitur yang didukung dari setiap versi meliputi: **ServiceNow konektor V1.0 /API [ServiceNowConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ServiceNowConfiguration.html)** + Pemetaan bidang + ServiceNow versi contoh: London, Others + Filter inklusi/pengecualian **ServiceNow konektor V2.0 /API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)** + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan inkremental + ServiceNow versi contoh: Roma, Sandiego, Tokyo, Lainnya + Cloud privat virtual (VPC) **catatan** ServiceNow konektor V1.0/ ServiceNowConfiguration API berakhir pada 2023. Kami merekomendasikan untuk bermigrasi ke atau menggunakan ServiceNow konektor V2.0/ TemplateConfiguration API. Untuk memecahkan masalah konektor sumber Amazon Kendra ServiceNow data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [ServiceNow konektor V1.0](data-source-v1-servicenow.md) + [ServiceNow konektor V2.0](data-source-v2-servicenow.md) + [Menentukan dokumen yang akan diindeks dengan kueri](servicenow-query.md) # ServiceNow konektor V1.0 ServiceNow menyediakan sistem manajemen layanan berbasis cloud untuk membuat dan mengelola alur kerja tingkat organisasi, seperti layanan TI, sistem tiket, dan dukungan. Anda dapat menggunakannya Amazon Kendra untuk mengindeks ServiceNow katalog, artikel pengetahuan, dan lampirannya. **catatan** ServiceNow konektor V1.0/ ServiceNowConfiguration API berakhir pada 2023. Kami merekomendasikan untuk bermigrasi ke atau menggunakan ServiceNow konektor V2.0/ TemplateConfiguration API. Untuk memecahkan masalah konektor sumber Amazon Kendra ServiceNow data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-v1-servicenow) + [Prasyarat](#prerequisites-v1-servicenow) + [Instruksi koneksi](#data-source-procedure-v1-servicenow) + [Pelajari selengkapnya](#servicenow-v1-learn-more) ## Fitur yang didukung Amazon KendraServiceNow konektor sumber data mendukung fitur-fitur berikut: + ServiceNow versi contoh: London, Others + Pola inklusi/pengecualian: Katalog layanan, artikel pengetahuan, dan lampirannya ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber ServiceNow data Anda, buat perubahan ini di akun ServiceNow dan AWS akun Anda. **Di ServiceNow, pastikan Anda memiliki:** + Membuat akun ServiceNow administrator dan telah membuat sebuah ServiceNow instance. + Menyalin host URL ServiceNow instans Anda. Misalnya, jika URL instans adalah*https://your-domain.service-now.com*, format untuk URL host yang Anda masukkan adalah*your-domain.service-now.com*. + Mencatat kredensi otentikasi dasar Anda yang berisi nama pengguna dan kata sandi untuk memungkinkan Anda terhubung Amazon Kendra ke instans Anda. ServiceNow **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **Opsional:** Mengonfigurasi token kredensyal OAuth 2.0 yang dapat mengidentifikasi Amazon Kendra dan menghasilkan nama pengguna, kata sandi, ID klien, dan rahasia klien. Nama pengguna dan kata sandi harus menyediakan akses ke basis ServiceNow pengetahuan dan katalog layanan. Lihat [ServiceNow dokumentasi tentang otentikasi OAuth 2.0](https://www.servicenow.com/docs/bundle/utah-platform-security/page/integrate/single-sign-on/concept/c_Authentication.html) untuk informasi selengkapnya. + Menambahkan izin berikut: + kb\$1category + kb\$1knowledge + kb\$1knowledge\$1base + kb\$1uc\$1cannot\$1read\$1mtom + kb\$1uc\$1can\$1read\$1mtom + sc\$1catalog + sc\$1category + sc\$1cat\$1item + sys\$1attachment + sys\$1attachment\$1doc + sys\$1user\$1role + Memeriksa setiap dokumen unik di dalam ServiceNow dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi ServiceNow otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber ServiceNow data AndaAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber ServiceNow data Anda, Anda harus memberikan rincian yang diperlukan dari sumber ServiceNow data Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi ServiceNow untuk Amazon Kendra lihat[Prasyarat](#prerequisites-v1-servicenow). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke ServiceNow** 1. Masuk ke Konsol AWS Manajemen dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **ServiceNowkonektor V1.0**, lalu pilih **Tambahkan sumber data**. 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **ServiceNow host** —Masukkan URL ServiceNow host. 1. **ServiceNow versi** —Pilih ServiceNow versi Anda. 1. Pilih antara **otentikasi Dasar** dan **otentikasi Oauth 2.0 berdasarkan kasus** penggunaan Anda. 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal ServiceNow otentikasi Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra- ServiceNow -' secara otomatis ditambahkan ke nama rahasia Anda. 1. Jika menggunakan Otentikasi Dasar—Masukkan **nama Rahasia, Nama** **Pengguna**, dan **Kata Sandi untuk akun** Anda. ServiceNow Jika menggunakan OAuth2 Otentikasi—Masukkan **nama Rahasia, Nama** **Pengguna**, **Kata Sandi**, **ID Klien**, dan **Rahasia Klien** yang Anda buat di akun Anda. ServiceNow 1. Pilih **Simpan dan tambahkan rahasia**. 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Sertakan artikel pengetahuan** —Pilih untuk mengindeks artikel pengetahuan. 1. **Jenis artikel pengetahuan** —Pilih antara **Sertakan hanya artikel publik** dan **Sertakan artikel berdasarkan kueri ServiceNow filter** berdasarkan kasus penggunaan Anda. Jika Anda memilih **Sertakan artikel berdasarkan kueri ServiceNow filter**, Anda harus memasukkan **kueri Filter** yang disalin dari ServiceNow akun Anda. 1. **Sertakan lampiran artikel pengetahuan** —Pilih untuk mengindeks lampiran artikel pengetahuan. Anda juga dapat memilih jenis file tertentu untuk diindeks. 1. **Sertakan item katalog** —Pilih untuk mengindeks item katalog. 1. **Sertakan lampiran item katalog** —Pilih untuk mengindeks lampiran item katalog. Anda juga dapat memilih jenis file tertentu untuk diindeks. 1. **Frekuensi** —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. **Artikel pengetahuan** dan **Katalog layanan** —Pilih dari bidang sumber data default yang Amazon Kendra dihasilkan dan pemetaan bidang tambahan yang disarankan yang ingin Anda petakan ke indeks Anda. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke ServiceNow** Anda harus menentukan yang berikut menggunakan [ServiceNowConfiguration API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ServiceNowConfiguration.html): + **URL sumber data** —Tentukan ServiceNow URL. Titik akhir host akan terlihat seperti berikut:*your-domain.service-now.com*. + **Instance host sumber data** —Tentukan versi instance ServiceNow host sebagai salah satu `LONDON` atau`OTHERS`. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi yang Anda buat di akun Anda. ServiceNow Jika Anda menggunakan otentikasi dasar, rahasia disimpan dalam struktur JSON dengan kunci berikut: ``` { "username": "user name", "password": "password" } ``` Jika Anda menggunakan OAuth2 otentikasi, rahasia disimpan dalam struktur JSON dengan kunci berikut: ``` { "username": "user name", "password": "password", "clientId": "client id", "clientSecret": "client secret" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk ServiceNow konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber ServiceNow data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber ServiceNow data Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan lampiran file tertentu dari katalog dan artikel pengetahuan. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Parameter pengindeksan** —Anda juga dapat memilih untuk menentukan apakah akan: + Mengindeks artikel pengetahuan dan katalog layanan, atau keduanya. Jika Anda memilih untuk mengindeks artikel pengetahuan dan item katalog layanan, Anda harus memberikan nama ServiceNow bidang yang dipetakan ke kolom isi dokumen indeks dalam Amazon Kendra indeks. + Lampiran indeks ke artikel pengetahuan dan item katalog. + Gunakan ServiceNow kueri yang memilih dokumen dari satu atau lebih basis pengetahuan. Basis pengetahuan boleh bersifat publik atau privat. Untuk informasi selengkapnya, lihat [Menentukan dokumen untuk diindeks dengan kueri](https://docs.aws.amazon.com/kendra/latest/dg/servicenow-query.html). ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber ServiceNow data Anda, lihat: + [Memulai dengan konektor Amazon Kendra ServiceNow Online](https://aws.amazon.com/blogs/machine-learning/getting-started-with-amazon-kendra-servicenow-online-connector/) # ServiceNow konektor V2.0 ServiceNow menyediakan sistem manajemen layanan berbasis cloud untuk membuat dan mengelola alur kerja tingkat organisasi, seperti layanan TI, sistem tiket, dan dukungan. Anda dapat menggunakannya Amazon Kendra untuk mengindeks ServiceNow katalog, artikel pengetahuan, insiden, dan lampirannya. Untuk memecahkan masalah konektor sumber Amazon Kendra ServiceNow data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-v2-servicenow) + [Prasyarat](#prerequisites-v2-servicenow) + [Instruksi koneksi](#data-source-procedure-v2-servicenow) + [Pelajari selengkapnya](#servicenow-learn-more) ## Fitur yang didukung Amazon KendraServiceNow konektor sumber data mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan inkremental + ServiceNow versi contoh: Roma, Sandiego, Tokyo, Lainnya + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber ServiceNow data Anda, buat perubahan ini di akun ServiceNow dan AWS akun Anda. **Di ServiceNow, pastikan Anda memiliki:** + Membuat Instans Pengembang Pribadi atau Perusahaan dan memiliki ServiceNow instance dengan peran administratif. + Menyalin host URL ServiceNow instans Anda. Format untuk URL host yang Anda masukkan adalah*your-domain.service-now.com*. Anda memerlukan URL ServiceNow instans Anda untuk terhubungAmazon Kendra. + Mencatat kredensi otentikasi dasar Anda dari nama pengguna dan kata sandi untuk memungkinkan untuk terhubung Amazon Kendra ke instans Anda. ServiceNow **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **Opsional:** Kredensyal klien OAuth 2.0 yang dikonfigurasi yang dapat mengidentifikasi Amazon Kendra menggunakan nama pengguna, kata sandi, dan ID klien yang dihasilkan, dan rahasia klien. Lihat [ServiceNow dokumentasi tentang otentikasi OAuth 2.0](https://www.servicenow.com/docs/bundle/utah-platform-security/page/integrate/single-sign-on/concept/c_Authentication.html) untuk informasi selengkapnya. + Menambahkan izin berikut: + kb\$1category + kb\$1knowledge + kb\$1knowledge\$1base + kb\$1uc\$1cannot\$1read\$1mtom + kb\$1uc\$1can\$1read\$1mtom + sc\$1catalog + sc\$1category + sc\$1cat\$1item + sys\$1attachment + sys\$1attachment\$1doc + sys\$1user\$1role + Memeriksa setiap dokumen unik di dalam ServiceNow dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi ServiceNow otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber ServiceNow data AndaAmazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber ServiceNow data Anda, Anda harus memberikan rincian yang diperlukan dari sumber ServiceNow data Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi ServiceNow untuk Amazon Kendra lihat[Prasyarat](#prerequisites-v2-servicenow). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke ServiceNow** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **ServiceNow konektor**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **ServiceNow konektor** dengan tag “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. **ServiceNow host** —Masukkan URL ServiceNow host. Format untuk URL host yang Anda masukkan adalah*your-domain.service-now.com*. 1. **ServiceNow versi** —Pilih versi ServiceNow instans Anda. Anda dapat memilih dari Roma, Sandiego, Tokyo, atau Lainnya. 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. **Otentikasi** —Pilih antara otentikasi **Dasar dan otentikasi** **Oauth** 2.0. 1. **AWSSecrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal ServiceNow otentikasi Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. Masukkan informasi berikut di jendela: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra- ServiceNow -' secara otomatis ditambahkan ke nama rahasia Anda. 1. Jika menggunakan Otentikasi Dasar—Masukkan **nama Rahasia, Nama** **Pengguna**, dan **Kata Sandi untuk akun** Anda. ServiceNow Jika menggunakan OAuth2 Otentikasi.0 — Masukkan **nama Rahasia, Nama** **Pengguna**, **Kata Sandi**, **ID Klien, dan **Rahasia Klien**** yang Anda buat di akun Anda. ServiceNow 1. Simpan dan tambahkan rahasia Anda. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. Untuk **artikel Pengetahuan**, pilih dari opsi berikut: + **Artikel pengetahuan** —Pilih untuk mengindeks artikel pengetahuan. + **Lampiran artikel pengetahuan —Pilih untuk mengindeks lampiran** artikel pengetahuan. + **Jenis artikel pengetahuan** —Pilih antara **Hanya artikel publik** dan **artikel Pengetahuan berdasarkan kueri ServiceNow filter** berdasarkan kasus penggunaan Anda. Jika Anda memilih **Sertakan artikel berdasarkan kueri ServiceNow filter**, Anda harus memasukkan **kueri Filter** yang disalin dari ServiceNow akun Anda. Contoh kueri filter meliputi:*workflow\$1state=draft^EQ*,*kb\$1knowledge\$1base=dfc19531bf2021003f07e2c1ac0739ab^text ISNOTEMPTY^EQ*,*article\$1type=text^active=true^EQ*. **penting** Jika Anda memilih untuk merayapi **Hanya artikel publik**, hanya Amazon Kendra merayapi artikel pengetahuan yang diberi peran akses publik. ServiceNow + **Sertakan artikel berdasarkan filter deskripsi singkat** —Tentukan pola ekspresi reguler untuk menyertakan atau mengecualikan artikel tertentu. 1. Untuk **item katalog Layanan**: + **Item katalog layanan** —Pilih untuk mengindeks item katalog layanan. + **Lampiran item katalog layanan —Pilih untuk mengindeks lampiran** item katalog layanan. + **Item katalog layanan aktif** —Pilih untuk mengindeks item katalog layanan aktif. + **Item katalog layanan tidak aktif —Pilih untuk mengindeks item katalog** layanan yang tidak aktif. + **Kueri filter** —Pilih untuk menyertakan item katalog layanan berdasarkan filter yang ditentukan dalam ServiceNow instance Anda. Contoh kueri filter meliputi:*short\$1descriptionLIKEAccess^category=2809952237b1300054b6a3549dbe5dd4^EQ*,*nameSTARTSWITHService^active=true^EQ*. + **Sertakan item katalog layanan berdasarkan filter deskripsi singkat** —Tentukan pola regex untuk menyertakan item katalog tertentu. 1. Untuk **Insiden**: + **Insiden** —Pilih untuk mengindeks insiden layanan. + **Lampiran insiden** —Pilih untuk mengindeks lampiran insiden. + **Insiden aktif** —Pilih untuk mengindeks insiden aktif. + **Insiden tidak aktif —Pilih untuk mengindeks insiden** tidak aktif. + **Jenis insiden aktif** —Pilih antara **Semua insiden**, Insiden **terbuka, Terbuka - insiden** **yang tidak ditetapkan, dan Insiden** yang **diselesaikan tergantung pada kasus** penggunaan Anda. + **Kueri filter** —Pilih untuk menyertakan insiden berdasarkan filter yang ditentukan dalam instance Anda ServiceNow . Contoh kueri filter meliputi:*short\$1descriptionLIKETest^urgency=3^state=1^EQ*,*priority=2^category=software^EQ *. + **Sertakan insiden berdasarkan filter deskripsi singkat** —Tentukan pola regex untuk menyertakan insiden tertentu. 1. Untuk **konfigurasi tambahan**: + **Informasi ACL** —Daftar kontrol akses untuk entitas yang telah Anda pilih disertakan secara default. Menghapus pilihan daftar kontrol akses akan membuat semua file dalam kategori itu publik. Opsi ACL secara otomatis dinonaktifkan untuk entitas yang tidak dipilih. Untuk artikel publik ACL tidak diterapkan. + Untuk **Ukuran file Maksimum** - Tentukan batas ukuran file di Amazon Kendra MBs yang akan dirayapi. Amazon Kendra hanya akan merayapi file dalam batas ukuran yang Anda tentukan. Ukuran file default adalah 50MB. Ukuran file maksimum harus lebih besar dari 0MB dan kurang dari atau sama dengan 50MB. + Pola **regex lampiran —Tambahkan pola** ekspresi reguler untuk menyertakan atau mengecualikan file katalog, artikel pengetahuan, dan insiden tertentu yang terlampir. Anda dapat menambahkan hingga 100 pola. 1. **Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. **Pemetaan bidang default** —Pilih dari bidang sumber data default Amazon Kendra yang dihasilkan yang ingin Anda petakan ke indeks Anda. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke ServiceNow** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) menggunakan API. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `SERVICENOWV2` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **URL Host** —Tentukan versi instance ServiceNow host. Misalnya, *your-domain.service-now.com*. + **Jenis otentikasi** —Tentukan jenis otentikasi yang Anda gunakan, apakah `basicAuth` atau `OAuth2` untuk instans Anda. ServiceNow + **ServiceNow versi instance** —Tentukan ServiceNow instance yang Anda gunakan, apakah`Tokyo`,, `Sandiego``Rome`, atau`Others`. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi yang Anda buat di akun Anda. ServiceNow Jika Anda menggunakan otentikasi dasar, rahasia disimpan dalam struktur JSON dengan kunci berikut: ``` { "username": "user name", "password": "password" } ``` + Jika Anda menggunakan kredensi OAuth2 klien, rahasia disimpan dalam struktur JSON dengan kunci berikut: ``` { "username": "user name", "password": "password", "clientId": "client id", "clientSecret": "client secret" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk ServiceNow konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber ServiceNow data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Filter penyertaan dan pengecualian** —Anda dapat menentukan apakah akan menyertakan atau mengecualikan file terlampir tertentu menggunakan nama file dan jenis file artikel pengetahuan, katalog layanan, dan insiden. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Dokumen khusus untuk diindeks** —Anda dapat menggunakan ServiceNow kueri untuk menentukan dokumen yang Anda inginkan dari satu atau beberapa basis pengetahuan, termasuk basis pengetahuan pribadi. Akses ke basis pengetahuan ditentukan oleh pengguna yang Anda gunakan untuk terhubung ke ServiceNow instance. Untuk informasi selengkapnya, lihat [Menentukan dokumen untuk diindeks dengan kueri](https://docs.aws.amazon.com//kendra/latest/dg/servicenow-query.html). + **Parameter pengindeksan** —Anda juga dapat memilih untuk menentukan apakah akan: + Mengindeks artikel pengetahuan, katalog layanan, dan insiden atau semua ini. Jika Anda memilih untuk mengindeks artikel pengetahuan, item katalog layanan, dan insiden, Anda harus memberikan nama ServiceNow bidang yang dipetakan ke bidang isi dokumen indeks dalam indeks. Amazon Kendra + Lampiran indeks ke artikel pengetahuan, item katalog layanan, dan insiden. + Sertakan artikel pengetahuan, item katalog layanan, dan insiden berdasarkan pola `short description` filter. + Pilih untuk memfilter item dan insiden katalog layanan aktif dan tidak aktif. + Pilih untuk memfilter insiden berdasarkan jenis insiden. + Pilih entitas mana yang harus dirayapi ACL mereka. + Anda dapat menggunakan ServiceNow kueri untuk menentukan dokumen yang Anda inginkan dari satu atau lebih basis pengetahuan, termasuk basis pengetahuan pribadi. Akses ke basis pengetahuan ditentukan oleh pengguna yang Anda gunakan untuk terhubung ke ServiceNow instance. Untuk informasi selengkapnya, lihat [Menentukan dokumen untuk diindeks dengan kueri](https://docs.aws.amazon.com//kendra/latest/dg/servicenow-query.html). + **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber ServiceNow data Anda ke bidang indeks AndaAmazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat [skema ServiceNow template](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-servicenow-schema). ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber ServiceNow data Anda, lihat: + [Memulai dengan Amazon Kendra Mengumumkan ServiceNow konektor yang diperbarui (V2) untuk Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/announcing-the-updated-servicenow-connector-v2-for-amazon-kendra/) # Menentukan dokumen yang akan diindeks dengan kueri Anda dapat menggunakan ServiceNow kueri untuk menentukan dokumen yang ingin Anda sertakan dalam Amazon Kendra indeks. Ketika menggunakan kueri, Anda dapat menentukan beberapa basis pengetahuan, termasuk basis pengetahuan privat. Akses ke basis pengetahuan ditentukan oleh pengguna yang Anda gunakan untuk terhubung ke ServiceNow instance. Untuk membuat kueri, Anda menggunakan pembuat ServiceNow kueri. Anda dapat menggunakan pembuat kueri untuk membuat kueri dan menguji apakah kueri mengembalikan daftar dokumen yang benar. **Untuk membuat kueri menggunakan ServiceNow konsol** 1. Masuk ke ServiceNow konsol. 1. Dari menu sebelah kiri, pilih **Pengetahuan**, kemudian **Artikel**, lalu pilih **Semua**. 1. Di bagian atas halaman, pilih ikon filter. 1. Gunakan pembuat kueri untuk membuat kueri. 1. Ketika kueri selesai, klik kanan kueri dan pilih **Salin kueri** untuk menyalin kueri dari pembuat kueri. Simpan kueri ini untuk digunakanAmazon Kendra. ![\[Query builder interface showing Knowledge base filters with options to run, save, and copy query.\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/images/ServiceNowQuery.png) Pastikan Anda tidak mengubah parameter kueri apa pun saat menyalin kueri. Jika salah satu parameter kueri tidak dikenali, ServiceNow memperlakukan parameter sebagai kosong dan tidak menggunakannya untuk memfilter hasil. # Slack Slack adalah aplikasi komunikasi perusahaan yang memungkinkan pengguna mengirim pesan dan lampiran melalui berbagai saluran publik dan pribadi. Anda dapat menggunakan Amazon Kendra untuk mengindeks saluran publik dan pribadi Slack Anda, pesan bot dan arsip, file dan lampiran, pesan langsung dan grup. Anda juga dapat memilih konten tertentu untuk difilter. **catatan** Amazon Kendrasekarang mendukung konektor Slack yang ditingkatkan. Konsol telah ditingkatkan secara otomatis untuk Anda. Konektor baru apa pun yang Anda buat di konsol akan menggunakan arsitektur yang ditingkatkan. Jika Anda menggunakan API, Anda sekarang harus menggunakan [https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objek alih-alih `SlackConfiguration` objek untuk mengonfigurasi konektor Anda. Konektor yang dikonfigurasi menggunakan konsol lama dan arsitektur API akan terus berfungsi seperti yang dikonfigurasi. Namun, Anda tidak akan dapat mengedit atau memperbaruinya. Jika Anda ingin mengedit atau memperbarui konfigurasi konektor Anda, Anda harus membuat konektor baru. Kami merekomendasikan untuk memigrasikan alur kerja konektor Anda ke versi yang ditingkatkan. Support untuk konektor yang dikonfigurasi menggunakan arsitektur lama dijadwalkan berakhir pada Juni 2024. Anda dapat terhubung Amazon Kendra ke sumber data Slack menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) atau [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber data Amazon Kendra Slack, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-slack) + [Prasyarat](#prerequisites-slack) + [Instruksi koneksi](#data-source-procedure-slack) + [Pelajari selengkapnya](#slack-learn-more) ## Fitur yang didukung Amazon KendraKonektor sumber data Slack mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Slack Anda, buat perubahan ini di Slack dan AWS akun Anda. **Di Slack, pastikan Anda memiliki:** + Mengkonfigurasi token Pengguna Slack Bot atau OAuth token Pengguna OAuth Slack. Anda dapat memilih salah satu token untuk terhubung Amazon Kendra ke sumber data Slack Anda. Token diperlukan untuk digunakan sebagai kredensi otentikasi Anda. Lihat [dokumentasi Slack pada token akses](https://api.slack.com/authentication/token-types) untuk informasi selengkapnya. **catatan** Jika Anda menggunakan token bot sebagai bagian dari kredensyal Slack Anda, Anda tidak dapat mengindeks pesan langsung dan pesan grup dan Anda harus menambahkan token bot ke saluran yang ingin Anda indeks. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + Mencatat ID tim ruang kerja Slack Anda dari URL halaman utama ruang kerja Slack Anda. Misalnya, *https://app.slack.com/client/T0123456789/... * di *T0123456789* mana ID tim. + Menambahkan cakupan/izin Oauth berikut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/data-source-slack.html) + Memeriksa setiap dokumen unik di Slack dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi Slack Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasia tersebut. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat menghubungkan sumber data Slack. Amazon Kendra Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Slack Anda, Anda harus memberikan rincian yang diperlukan dari sumber data Slack Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Slack untukAmazon Kendra, lihat[Prasyarat](#prerequisites-slack). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Slack** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambahkan sumber data**, pilih **konektor Slack**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Slack dengan tag** “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. Untuk **ID tim ruang kerja Slack —ID** tim ruang kerja Slack Anda. Anda dapat menemukan ID tim Anda di URL halaman utama ruang kerja Slack Anda. Misalnya, *https://app.slack.com/client/T0123456789/...* di *T0123456789* mana ID tim. 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal otentikasi Slack Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**: 1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-Slack-' secara otomatis ditambahkan ke nama rahasia Anda. 1. Untuk **token Slack** —Masukkan nilai kredensi otentikasi yang Anda konfigurasikan Slack. 1. Simpan dan tambahkan rahasia Anda. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. 1. **IAMperan** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Pilih jenis konten** —Pilih entitas Slack atau jenis konten yang ingin dirayapi. Anda dapat memilih dari semua saluran, saluran publik, saluran pribadi, pesan grup, dan pesan pribadi. 1. **Pilih tanggal mulai crawl —Masukkan tanggal** yang ingin Anda mulai merayapi konten Anda. 1. Untuk **konfigurasi Tambahan** —Pilih untuk menyertakan bot dan pesan yang diarsipkan dan gunakan pola ekspresi reguler untuk menyertakan atau mengecualikan konten tertentu. **catatan** Jika Anda memilih untuk menyertakan nama saluran IDs dan saluran, konektor Amazon Kendra Slack akan memprioritaskan saluran IDs daripada nama saluran. Jika Anda memilih untuk menyertakan pesan pribadi dan grup tertentu, konektor Amazon Kendra Slack akan mengabaikan semua pesan pribadi dan grup dan hanya merayapi pesan pribadi dan grup yang Anda tentukan. 1. **Mode sinkronisasi** —Pilih cara Anda ingin memperbarui indeks saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Bidang **sumber data default —Pilih dari bidang** sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Slack** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-slack) menggunakan API. [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `SLACK` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **ID tim ruang kerja Slack —ID tim** Slack yang Anda salin dari URL halaman utama Slack Anda. + **Sejak tanggal —Tanggal** untuk mulai merayapi data Anda dari tim ruang kerja Slack Anda. Tanggal harus mengikuti format ini: yyyy-mm-dd. + **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara: + `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. + **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi untuk akun Slack Anda. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "slackToken": "token" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Slack dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Slack](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Saluran tertentu** —Filter berdasarkan saluran publik atau pribadi, dan tentukan saluran tertentu berdasarkan ID mereka. + **Jenis saluran dan pesan** —Apakah Amazon Kendra harus mengindeks saluran publik dan pribadi Anda, grup dan pesan langsung Anda, serta bot Anda dan pesan yang diarsipkan. Jika Anda menggunakan token bot sebagai bagian dari kredensyal otentikasi Slack Anda, Anda harus menambahkan token bot ke saluran yang ingin Anda indeks. Anda tidak dapat mengindeks pesan langsung dan pesan grup menggunakan token bot. + **Lihat ke belakang** —Anda dapat memilih untuk mengonfigurasi `lookBack` parameter sehingga konektor Slack merayapi konten yang diperbarui atau dihapus hingga jumlah jam tertentu sebelum sinkronisasi konektor terakhir Anda. + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan konten Slack tertentu. Jika Anda menggunakan token bot sebagai bagian dari kredensyal otentikasi Slack Anda, Anda harus menambahkan token bot ke saluran yang ingin Anda indeks. Anda tidak dapat mengindeks pesan langsung dan pesan grup menggunakan token bot. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Slack Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat [skema Slack template](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-slack). ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Slack Anda, lihat: + [Mengungkap pengetahuan di ruang kerja Slack dengan pencarian cerdas menggunakan konektor Slack Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/unravel-the-knowledge-in-slack-workspaces-with-intelligent-search-using-the-amazon-kendra-slack-connector/) # Zendesk Zendesk adalah sistem manajemen hubungan pelanggan yang membantu bisnis mengotomatisasi dan meningkatkan interaksi dukungan pelanggan. Anda dapat menggunakan Amazon Kendra untuk mengindeks tiket dukungan Zendesk Anda, komentar tiket, lampiran tiket, artikel pusat bantuan, komentar artikel, lampiran komentar artikel, topik panduan komunitas, posting komunitas, dan komentar posting komunitas. Anda dapat memfilter berdasarkan nama organisasi jika Anda ingin mengindeks tiket yang hanya ada dalam organisasi tertentu. Anda juga dapat memilih untuk menetapkan tanggal crawl kapan Anda ingin memulai crawling data dari Zendesk. Anda dapat terhubung Amazon Kendra ke sumber data Zendesk Anda menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) dan [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Untuk memecahkan masalah konektor sumber data Amazon Kendra Zendesk Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md) **Topics** + [Fitur yang didukung](#supported-features-zendesk) + [Prasyarat](#prerequisites-zendesk) + [Instruksi koneksi](#data-source-procedure-zendesk) + [Pelajari selengkapnya](#zendesk-learn-more) + [Catatan](#zendesk-notes) ## Fitur yang didukung Amazon KendraKonektor sumber data Zendesk mendukung fitur-fitur berikut: + Pemetaan bidang + Kontrol akses pengguna + Filter inklusi/pengecualian + Ubah log, sinkronisasi konten penuh dan tambahan + Cloud privat virtual (VPC) ## Prasyarat Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Zendesk Anda, buat perubahan ini di Zendesk dan AWS akun Anda. **Di Zendesk, pastikan Anda memiliki:** + Membuat akun administratif Zendesk Suite (Professional/Enterprise). + Mencatat URL host Zendesk Anda. Misalnya, *https://\$1sub-domain\$1.zendesk.com/*. **catatan** (On-premise/server) Amazon Kendra memeriksa apakah informasi titik akhir yang disertakan sama dengan informasi titik akhir yang AWS Secrets Manager ditentukan dalam detail konfigurasi sumber data Anda. Ini membantu melindungi dari [masalah wakil yang membingungkan](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html), yang merupakan masalah keamanan di mana pengguna tidak memiliki izin untuk melakukan tindakan tetapi menggunakan Amazon Kendra sebagai proxy untuk mengakses rahasia yang dikonfigurasi dan melakukan tindakan. Jika nanti Anda mengubah informasi titik akhir Anda, Anda harus membuat rahasia baru untuk menyinkronkan informasi ini. + Siapkan Otentikasi OAuth 2.0 menggunakan alur hibah kode otorisasi: 1. Di Pusat Admin, navigasikan ke Aplikasi dan integrasi> APIs > Zendesk API. 1. Pilih tab OAuth Klien dan klik “Tambah OAuth klien”. 1. Konfigurasikan detail OAuth klien: Atur Nama dan Deskripsi Klien, Atur Jenis Klien ke “Rahasia”, Tambahkan Pengalihan yang sesuai URLs (misalnya, https://localhost/callback untuk pengujian), Simpan dan simpan ID Klien dan Rahasia Klien yang dihasilkan dengan aman. 1. Pastikan OAuth klien memiliki cakupan “baca” yang diperlukan (atau “baca tulis” jika Anda memerlukan akses tulis). 1. Hasilkan Token Akses menggunakan alur hibah kode otorisasi: + Di browser, navigasikan ke: `https://{subdomain}.zendesk.com/oauth/authorizations/new?response_type=code&client_id={your_client_id}&redirect_uri={your_redirect_uri}&scope=read` + Otentikasi dan otorisasi aplikasi saat diminta. + Setelah otorisasi, Zendesk mengalihkan ke redirect\$1uri dengan parameter kode (misalnya, kode otorisasi. https://localhost/callback?code=\$1authorization\$1code\$1). Copy + Tukarkan kode otorisasi untuk token akses dengan mengirimkan permintaan POST ke titik akhir token Zendesk: ``` curl -X POST https://{subdomain}.zendesk.com/oauth/tokens \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=authorization_code&code={authorization_code}&client_id={your_client_id}&client_secret={your_client_secret}&redirect_uri={your_redirect_uri}&scope=read" ``` + Zendesk merespons dengan objek JSON yang berisi access\$1token. Ekstrak dan simpan token akses ini dengan aman. 1. Simpan token akses yang dihasilkan dengan aman. Token akses ini akan digunakan untuk integrasi Kendra. + **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). + **Opsional:** Menginstal sertifikat SSL untuk memungkinkan Amazon Kendra untuk terhubung. + Memeriksa setiap dokumen unik di Zendesk dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks. **Di dalam AndaAkun AWS, pastikan Anda memiliki:** + [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks. + [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM. **catatan** Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager. + Menyimpan kredensi otentikasi Zendesk Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasianya. **catatan** Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku). Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data Zendesk Anda. Amazon Kendra Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ## Instruksi koneksi Untuk terhubung Amazon Kendra ke sumber data Zendesk Anda, Anda harus memberikan rincian yang diperlukan dari sumber data Zendesk Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Zendesk untukAmazon Kendra, lihat[Prasyarat](#prerequisites-zendesk). ------ #### [ Console ] **Untuk terhubung Amazon Kendra ke Zendesk** 1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/). 1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks. **catatan** Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** Anda di bawah **Pengaturan indeks**. 1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**. 1. Pada halaman **Tambah sumber data**, pilih **konektor Zendesk**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Zendesk dengan tag** “V2.0". 1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut: 1. Dalam **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi. 1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda. 1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih. 1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut: 1. URL **Zendesk —Masukkan URL** Zendesk Anda. Misalnya, *https://\$1sub-domain\$1.zendesk.com/*. 1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). 1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensi otentikasi Zendesk Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. 1. Buat rahasia baru dengan struktur berikut: ``` { "hostUrl": "https://yoursubdomain.zendesk.com/", "accessToken": "your_access_token" } ``` **catatan** Untuk integrasi Kendra, nama rahasia harus dimulai dengan 'AmazonKendra-Zendesk-' diikuti oleh pengenal pilihan Anda (misalnya,' -Zendesk- '). AmazonKendra MyConnector 1. Simpan dan tambahkan rahasia Anda. 1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**. 1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna. 1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda. **catatan** IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut: 1. **Pilih konten** —Pilih jenis konten yang ingin dirayapi dari tiket, ke artikel pusat bantuan, topik komunitas, dan lainnya. 1. **Nama organisasi** —Masukkan nama organisasi Zendesk untuk memfilter konten. 1. **Sinkronkan tanggal mulai** —Masukkan tanggal dari mana Anda ingin mulai merayapi konten Anda. 1. Pola **Regex —Tambahkan pola** ekspresi reguler untuk menyertakan atau mengecualikan file tertentu. Anda dapat menambahkan hingga 100 pola. 1. **Mode sinkronisasi** —Pilih cara Anda ingin memperbarui indeks saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. + Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda. + Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. + Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir. 1. Di **Sinkronkan jadwal lari** untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda. 1. Pilih **Berikutnya**. 1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut: 1. Bidang **sumber data default —Pilih dari bidang** sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda. 1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang. 1. Pilih **Berikutnya**. 1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan. ------ #### [ API ] **Untuk terhubung Amazon Kendra ke Zendesk** Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) menggunakan API. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini: + **Sumber data** —Tentukan tipe sumber data seperti `ZENDESK` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API. + **URL Host** —Berikan URL host Zendesk Anda sebagai bagian dari konfigurasi koneksi atau detail titik akhir repositori. Misalnya, * https://yoursubdomain.zendesk.com*. + **Ubah log** —Apakah Amazon Kendra harus menggunakan mekanisme log perubahan sumber data Zendesk untuk menentukan apakah dokumen harus diperbarui dalam indeks. **catatan** Gunakan log perubahan jika Anda tidak Amazon Kendra ingin memindai semua dokumen. Jika log perubahan Anda besar, mungkin perlu waktu Amazon Kendra lebih sedikit untuk memindai dokumen di sumber data Zendesk daripada memproses log perubahan. Jika Anda menyinkronkan sumber data Zendesk Anda dengan indeks Anda untuk pertama kalinya, semua dokumen dipindai. + **Rahasia Nama Sumber Daya Amazon (ARN) —Berikan** Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensi otentikasi untuk akun Zendesk Anda. Rahasianya disimpan dalam struktur JSON dengan kunci berikut: ``` { "hostUrl": "https://yoursubdomain.zendesk.com", "clientId": "client ID", "clientSecret": "Zendesk client secret", "userName": "Zendesk user name", "password": "Zendesk password" } ``` + **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Zendesk dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Zendesk](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Anda juga dapat menambahkan fitur opsional berikut: + **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md). + **Jenis dokumen/konten** —Tentukan apakah akan dirayapi: + Tiket Support, komentar and/or tiket, lampiran komentar tiket + Artikel pusat bantuan, lampiran artikel, dan komentar artikel + Memandu topik komunitas, posting, atau posting komentar + **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan konten Slack tertentu. Jika Anda menggunakan token bot sebagai bagian dari kredensi otentikasi Slack Anda, Anda harus menambahkan token bot ke saluran yang ingin Anda indeks. Anda tidak dapat mengindeks pesan langsung dan pesan grup menggunakan token bot. **catatan** Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi. + **Pemfilteran konteks pengguna dan kontrol akses** — Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter). + **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Zendesk Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). **catatan** Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional. Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat Skema [template Zendesk](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-zendesk). ------ ## Pelajari selengkapnya Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Zendesk Anda, lihat: + [Temukan wawasan dari Zendesk dengan pencarian cerdas Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/discover-insights-from-zendesk-with-amazon-kendra-intelligent-search/) ## Catatan + Saat Daftar Kontrol Akses (ACLs) diaktifkan, opsi “Sinkronkan hanya konten baru atau yang dimodifikasi” tidak tersedia karena keterbatasan API Zendesk. Sebaiknya gunakan mode “Sinkronisasi penuh” atau “Sinkronisasi konten baru, dimodifikasi, atau dihapus” sebagai gantinya, atau nonaktifkan ACLs jika Anda perlu menggunakan mode sinkronisasi ini. # Memetakan bidang sumber data Amazon Kendra konektor sumber data dapat memetakan bidang dokumen atau konten dari sumber data Anda ke bidang dalam Amazon Kendra indeks Anda. Secara default, setiap konektor dirancang untuk merayapi bidang sumber data tertentu. Bidang sumber data default dan propertinya tidak dapat diubah atau disesuaikan. Di Amazon Kendra konsol, bidang default dan properti bidang default yang tidak dapat diedit berwarna abu-abu. Amazon Kendra konektor juga memungkinkan Anda untuk memetakan dokumen khusus atau bidang konten dari sumber data Anda ke bidang khusus dalam indeks Anda. Misalnya, jika Anda memiliki bidang di sumber data yang disebut “dept” yang berisi informasi departemen untuk dokumen, Anda dapat memetakannya ke bidang indeks yang disebut “Departemen”. Dengan begitu, Anda dapat menggunakan bidang saat menanyakan dokumen. Anda juga dapat memetakan bidang yang Amazon Kendra dipesan atau umum seperti`_created_at`. Jika sumber data Anda memiliki bidang yang disebut “creation\$1date”, Anda dapat memetakannya ke bidang Amazon Kendra cadangan setara yang disebut. `_created_at` Untuk informasi selengkapnya tentang bidang yang Amazon Kendra dicadangkan, lihat [Atribut atau bidang dokumen](https://docs.aws.amazon.com/kendra/latest/dg/hiw-document-attributes.html). Anda dapat memetakan bidang untuk sebagian besar sumber data. Anda dapat membuat pemetaan bidang untuk sumber data berikut: + Adobe Experience Manager + Alfresco + Aurora (MySQL) + Aurora (PostgreSQL) + Amazon FSx (Jendela) + Amazon FSx (NetApp ONTAP) + Amazon RDS/Aurora + Amazon RDS (Microsoft SQL Server) + Amazon RDS (MySQL) + Amazon RDS (Oracle) + Amazon RDS (PostgreSQL) + Amazon Kendra Perayap Web + WorkDocs + Box + Confluence + Dropbox + Drupal + GitHub + Google Workspace Drives + Gmail + IBM DB2 + Jira + Microsoft Exchange + Microsoft OneDrive + Microsoft SharePoint + Microsoft Teams + Microsoft SQL Server + Microsoft Yammer + MySQL + Oracle Database + PostgreSQL + Quip + Salesforce + ServiceNow + Slack + Zendesk Jika Anda menyimpan dokumen di bucket S3, atau sumber data S3, Anda menentukan bidang menggunakan file metadata JSON. Untuk informasi selengkapnya, lihat [konektor sumber data S3](https://docs.aws.amazon.com/kendra/latest/dg/data-source-s3.html). Memetakan bidang sumber data ke bidang indeks memerlukan tiga langkah: 1. Buat indeks. Untuk informasi lebih lanjut, lihat [Membuat indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html). 1. Perbarui indeks untuk menambahkan bidang. 1. Buat sumber data dan sertakan pemetaan bidang untuk memetakan bidang yang dicadangkan dan bidang khusus apa pun untuk Amazon Kendra mengindeks bidang. Untuk memperbarui indeks untuk menambahkan bidang kustom, gunakan konsol untuk mengedit pemetaan bidang sumber data dan menambahkan bidang khusus atau menggunakan API. [UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html) Anda dapat menambahkan total 500 bidang kustom ke indeks Anda. Untuk sumber data basis data, jika nama kolom basis data cocok dengan nama bidang terpesan, bidang dan kolom akan otomatis dipetakan. Dengan [UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)API, Anda menambahkan bidang cadangan dan kustom menggunakan`DocumentMetadataConfigurationUpdates`. Contoh JSON berikut digunakan `DocumentMetadataConfigurationUpdates` untuk menambahkan bidang yang disebut “Departemen” ke indeks. ``` "DocumentmetadataConfigurationUpdates": [ { "Name": "Department", "Type": "STRING_VALUE" } ] ``` Saat Anda membuat bidang, Anda memiliki opsi untuk mengatur bagaimana bidang digunakan untuk pencarian. Anda dapat memilih dari opsi berikut: + **Displayable** —Menentukan apakah bidang dikembalikan dalam respons kueri. Nilai default-nya `true`. + **Facetable** —Menunjukkan bahwa bidang dapat digunakan untuk membuat faset. Nilai default-nya `false`. + **Dapat dicari** —Menentukan apakah bidang digunakan dalam pencarian. Secara default adalah `true` untuk bidang string dan `false` untuk bidang nomor dan tanggal. + **Sortable** —Menunjukkan bahwa bidang dapat digunakan untuk mengurutkan respons dari kueri. Hanya dapat diatur untuk bidang tanggal, angka, dan string. Tidak dapat diatur untuk bidang daftar string. Contoh JSON berikut digunakan `DocumentMetadataConfigurationUpdates` untuk menambahkan bidang yang disebut “Departemen” ke indeks dan menandainya sebagai facetable. ``` "DocumentMetadataConfigurationUpdates": [ { "Name": "Department", "Type": "STRING_VALUE", "Search": { "Facetable": true } } ] ``` ## Menggunakan bidang dokumen yang Amazon Kendra dicadangkan atau umum Dengan [UpdateIndex API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html), Anda dapat membuat kolom cadangan atau umum menggunakan `DocumentMetadataConfigurationUpdates` dan menentukan nama bidang indeks Amazon Kendra cadangan untuk dipetakan ke attribute/field nama dokumen yang setara. Anda juga dapat membuat bidang khusus. Jika Anda menggunakan konektor sumber data, sebagian besar menyertakan pemetaan bidang yang memetakan bidang dokumen sumber data Anda ke bidang Amazon Kendra indeks. Jika Anda menggunakan konsol, Anda memperbarui bidang dengan memilih sumber data, memilih tindakan edit, dan kemudian melanjutkan di sebelah bagian pemetaan bidang untuk mengonfigurasi sumber data. Anda dapat mengonfigurasi `Search` objek untuk menetapkan bidang sebagai dapat ditampilkan, facetable, dapat dicari, dan dapat diurutkan. Anda dapat mengonfigurasi `Relevance` objek untuk mengatur urutan peringkat bidang, durasi peningkatan, atau periode waktu untuk diterapkan pada peningkatan, kesegaran, nilai kepentingan, dan nilai kepentingan yang dipetakan ke nilai bidang tertentu. Jika Anda menggunakan konsol, Anda dapat mengatur pengaturan pencarian untuk bidang dengan memilih opsi facet di menu navigasi. Untuk mengatur penyetelan relevansi, pilih opsi untuk mencari indeks Anda di menu navigasi, masukkan kueri, dan gunakan opsi panel samping untuk menyetel relevansi pencarian. Anda tidak dapat mengubah jenis bidang setelah Anda membuat bidang. Amazon Kendra memiliki bidang dokumen cadangan atau umum berikut yang dapat Anda gunakan: + `_authors`Daftar satu atau lebih penulis yang bertanggung jawab atas isi dokumen. + `_category`Sebuah kategori yang menempatkan dokumen dalam kelompok tertentu. + `_created_at`Tanggal dan waktu dalam format ISO 8601 bahwa dokumen itu dibuat. Misalnya, 2012-03-25T 12:30:10 \$101:00 adalah format tanggal-waktu ISO 8601 untuk 25 Maret 2012 pukul 12:30 (ditambah 10 detik) di Waktu Eropa Tengah. + `_data_source_id`—Pengidentifikasi sumber data yang berisi dokumen. + `_document_body`—Isi dokumen. + `_document_id`—Pengidentifikasi unik untuk dokumen. + `_document_title`—Judul dokumen. + `_excerpt_page_number`—Nomor halaman dalam file PDF tempat kutipan dokumen muncul. Jika indeks Anda dibuat sebelum 8 September 2020, Anda harus mengindeks ulang dokumen sebelum dapat menggunakan atribut ini. + `_faq_id`—Jika ini adalah dokumen tipe tanya jawab (FAQ), pengenal unik untuk FAQ. + `_file_type`—Jenis file dokumen, seperti pdf atau doc. + `_last_updated_at`Tanggal dan waktu dalam format ISO 8601 bahwa dokumen terakhir diperbarui. Misalnya, 2012-03-25T 12:30:10 \$101:00 adalah format tanggal-waktu ISO 8601 untuk 25 Maret 2012 pukul 12:30 (ditambah 10 detik) di Waktu Eropa Tengah. + `_source_uri`—URI tempat dokumen tersedia. Misalnya, URI dokumen di situs web perusahaan. + `_version`—Pengidentifikasi untuk versi dokumen tertentu. + `_view_count`—Berapa kali dokumen telah dilihat. + `_language_code`(String) —Kode untuk bahasa yang berlaku untuk dokumen. Ini default ke bahasa Inggris jika Anda tidak menentukan bahasa. Untuk informasi selengkapnya tentang bahasa yang didukung, termasuk kodenya, lihat [Menambahkan dokumen dalam bahasa selain bahasa Inggris](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-languages.html). Untuk bidang kustom, Anda membuat bidang ini menggunakan `DocumentMetadataConfigurationUpdates` `UpdateIndex` API, seperti yang Anda lakukan saat membuat bidang cadangan atau umum. Anda harus mengatur tipe data yang sesuai untuk bidang kustom Anda. Jika Anda menggunakan konsol, Anda memperbarui bidang dengan memilih sumber data, memilih tindakan edit, dan kemudian melanjutkan di sebelah bagian pemetaan bidang untuk mengonfigurasi sumber data. Beberapa sumber data tidak mendukung penambahan bidang baru atau bidang khusus. Anda tidak dapat mengubah jenis bidang setelah Anda membuat bidang. Berikut ini adalah jenis yang dapat Anda atur untuk bidang khusus: + Date + Bilangan + String + Daftar string Jika Anda menambahkan dokumen ke indeks menggunakan [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API, `Attributes` daftar dokumen Anda dan Anda membuat bidang menggunakan `DocumentAttribute` objek. fields/attributes Untuk dokumen yang diindeks dari sumber Amazon S3 data, Anda membuat bidang menggunakan [file metadata JSON](https://docs.aws.amazon.com/kendra/latest/dg/s3-metadata.html) yang menyertakan informasi bidang. Jika Anda menggunakan database yang didukung sebagai sumber data, Anda dapat mengonfigurasi bidang menggunakan opsi [pemetaan bidang](https://docs.aws.amazon.com/kendra/latest/dg/data-source-database.html#data-source-procedure-database). # Menambahkan dokumen dalam bahasa selain bahasa Inggris Anda dapat mengindeks dokumen dalam berbagai bahasa. Jika Anda tidak menentukan bahasa, Amazon Kendra indeks dokumen dalam bahasa Inggris secara default. Anda menyertakan kode bahasa untuk dokumen dalam metadata dokumen sebagai bidang. Lihat [Pemetaan bidang](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html) dan [atribut Kustom](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html) untuk informasi selengkapnya tentang `_language_code` bidang untuk dokumen. Anda dapat menentukan kode bahasa untuk semua dokumen Anda di sumber data Anda saat Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Jika dokumen tidak memiliki kode bahasa yang ditentukan dalam bidang metadata, dokumen diindeks menggunakan kode bahasa yang ditentukan untuk semua dokumen di tingkat sumber data. Di konsol, Anda dapat mengindeks dokumen dalam bahasa yang didukung hanya di tingkat sumber data. **Pergi ke **Sumber data**, lalu **Tentukan halaman detail sumber data**, dan pilih bahasa dari Bahasa tarik-turun.** Anda juga dapat mencari atau menanyakan dokumen dalam bahasa yang didukung. Untuk informasi selengkapnya, lihat [Mencari dalam bahasa](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-languages). Bahasa berikut dan kodenya didukung (Bahasa Inggris atau `en` didukung secara default jika Anda tidak menentukan bahasa). Tabel ini mencakup bahasa yang Amazon Kendra mendukung dengan pencarian semantik penuh, serta bahasa yang hanya mendukung pencocokan kata kunci sederhana. Bahasa yang mendukung pencarian semantik penuh ditandai dengan tanda bintang dan dalam teks tebal di tabel berikut. Bahasa Inggris (bahasa default) juga didukung dengan pencarian semantik penuh. | **Nama bahasa** | **Kode bahasa** | | --- | --- | | Arab | ar | | Orang Armenia | hy | | Basque | eu | | Bengali | bn | | Bulgaria | bg | | bahasa katala | ca | | Bahasa Mandarin — disederhanakan dan tradisional\$1 | zh | | Bahasa Ceko | cs | | Orang Denmark | da | | Bahasa Belanda | nl | | orang Finlandia | fi | | Prancis - termasuk Prancis (Kanada) \$1 | fr | | Galicia | gl | | Jerman\$1 | de | | Yunani | el | | bahasa Hindi | hi | | Bahasa Hungaria | hu | | orang Indonesia | id | | orang Irlandia | ga | | Bahasa Italia | it | | Jepang\$1 | ja | | Korea\$1 | ko | | Latvia | lv | | Lituania | lt | | Norwegia | no | | Persia | fa | | Bahasa Portugis | pt | | Portugis (Brasil) \$1 | pt-BR | | Rumania | ro | | Bahasa Rusia | ru | | Sorani | ckb | | Spanyol - termasuk Spanyol (Meksiko) \$1 | es | | Bahasa Swedia | sv | | Turki | tr | *\$1 Pencarian semantik didukung untuk bahasa tersebut.* Untuk bahasa yang mendukung pencarian semantik, fitur berikut didukung. + Relevansi dokumen di luar pencocokan kata kunci sederhana. + FAQs di luar pencocokan kata kunci sederhana. + Mengekstrak jawaban dari dokumen berdasarkan Amazon Kendra pemahaman bacaan. + Ember kepercayaan (sangat tinggi, tinggi, sedang, dan rendah) dari hasil pencarian. Untuk bahasa yang tidak mendukung pencarian semantik, pencocokan kata kunci sederhana didukung untuk relevansi dokumen dan. FAQs [Sinonim](https://docs.aws.amazon.com/kendra/latest/dg/index-synonyms.html) (termasuk sinonim khusus), [pembelajaran tambahan dan umpan balik](https://docs.aws.amazon.com/kendra/latest/dg/submitting-feedback.html), dan [saran kueri](https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html) hanya didukung untuk bahasa Inggris (bahasa default). # Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC Amazon Kendra dapat terhubung ke virtual private cloud (VPC) yang Anda buat Amazon Virtual Private Cloud untuk mengindeks konten yang disimpan dalam sumber data yang berjalan di cloud pribadi Anda. Saat membuat konektor sumber data, Anda dapat menyediakan grup keamanan dan pengidentifikasi subnet untuk subnet yang berisi sumber data Anda. Dengan informasi ini, Amazon Kendra buat elastic network interface yang digunakannya untuk berkomunikasi secara aman dengan sumber data Anda dalam VPC Anda. Untuk menyiapkan konektor sumber Amazon Kendra data Amazon VPC, Anda dapat menggunakan operasi Konsol Manajemen AWS atau [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html)API. Jika Anda menggunakan konsol, Anda menghubungkan VPC selama proses konfigurasi konektor. **catatan** Amazon VPC Fitur ini opsional saat menyiapkan konektor sumber Amazon Kendra data. Jika sumber data Anda dapat diakses dari internet publik, Anda tidak perlu mengaktifkan Amazon VPC fitur tersebut. Tidak semua konektor sumber Amazon Kendra data mendukung Amazon VPC. Jika sumber data Anda tidak berjalan Amazon VPC dan tidak dapat diakses dari internet publik, pertama-tama Anda menghubungkan sumber data Anda ke VPC menggunakan jaringan pribadi virtual (VPN). Kemudian, Anda dapat menghubungkan sumber data Anda Amazon Kendra dengan menggunakan kombinasi Amazon VPC dan AWS Virtual Private Network. Untuk informasi tentang pengaturan VPN, lihat [Site-to-Site VPN dokumentasi](https://docs.aws.amazon.com/vpn/). **Topics** + [Mengkonfigurasi Amazon VPC dukungan untuk konektor Amazon Kendra](connector-vpc-steps.md) + [Siapkan sumber Amazon Kendra data untuk terhubung Amazon VPC](connector-vpc-setup.md) + [Menghubungkan ke basis data di VPC](vpc-example.md) + [Memecahkan masalah koneksi VPC](vpc-connector-troubleshoot.md) # Mengkonfigurasi Amazon VPC dukungan untuk konektor Amazon Kendra Untuk mengonfigurasi Amazon VPC untuk digunakan dengan Amazon Kendra konektor Anda, lakukan langkah-langkah berikut. **Topics** + [Langkah 1. Buat Amazon VPC subnet untuk Amazon Kendra](#connector-vpc-prerequisites-1) + [Langkah 2. Buat grup Amazon VPC keamanan untuk Amazon Kendra](#connector-vpc-prerequisites-2) + [Langkah 3. Konfigurasikan sumber data eksternal Anda dan Amazon VPC](#connector-vpc-prerequisites-3) ## Langkah 1. Buat Amazon VPC subnet untuk Amazon Kendra Buat atau pilih Amazon VPC subnet yang ada yang Amazon Kendra dapat digunakan untuk mengakses sumber data Anda. Subnet yang disiapkan harus berada di salah satu dari berikut Wilayah AWS dan Availability Zone: + AS Barat (Oregon) /us-barat-2—usw2-az1, usw2-az2, usw2-az3 + AS Timur (Virginia N.) /us-timur-1—gunakan1-az1, gunakan1-az2, gunakan1-az4 + AS Timur (Ohio) /us-timur-2—gunakan2-az1, gunakan2-az2, gunakan2-az3 + Asia Pasifik (Tokyo) /ap-timur laut-1 — apne1-az1, apne1-az2, apne1-az4 + Asia Pasifik (Mumbai) /ap-selatan-1—aps1-az1, aps1-az2, aps1-az3 + Asia Pasifik (Singapura) /ap-tenggara 1—apse1-az1, apse1-az2, apse1-az3 + Asia Pasifik (Sydney) /ap-tenggara 2—apse2-az1, apse2-az2, apse2-az3 + Kanada (Tengah) /ca-central-1—cac1-az1, cac1-az2, cac1-az4 + Eropa (Irlandia) /eu-barat-1—euw1-az1, uew1-az2, euw1-az3 + Eropa (London) /eu-barat-2—euw2-az1, euw2-az2, euw2-az3 Sumber data Anda harus dapat diakses dari subnet yang Anda berikan ke Amazon Kendra konektor. Untuk informasi selengkapnya tentang cara mengonfigurasi Amazon VPC subnet, lihat [Subnet untuk Anda Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/configure-subnets.html) di Panduan Pengguna Amazon *VPC*. Jika Amazon Kendra harus merutekan koneksi antara dua atau lebih subnet, Anda dapat menyiapkan beberapa subnet. Misalnya, subnet yang berisi sumber data Anda kehabisan alamat IP. Dalam hal ini, Anda dapat Amazon Kendra menyediakan subnet tambahan yang memiliki alamat IP yang cukup dan terhubung ke subnet pertama. Jika Anda mencantumkan lebih dari satu subnet, subnet harus dapat berkomunikasi satu sama lain. ## Langkah 2. Buat grup Amazon VPC keamanan untuk Amazon Kendra Untuk menghubungkan konektor sumber Amazon Kendra data Anda Amazon VPC, Anda harus menyiapkan satu atau beberapa grup keamanan dari VPC Anda untuk ditetapkan. Amazon Kendra Grup keamanan akan dikaitkan dengan elastic network interface yang dibuat oleh Amazon Kendra. Antarmuka jaringan ini mengontrol lalu lintas masuk dan keluar ke dan dari Amazon Kendra saat mengakses subnet. Amazon VPC Pastikan bahwa aturan keluar grup keamanan Anda memungkinkan lalu lintas dari konektor sumber Amazon Kendra data untuk mengakses subnet dan sumber data yang akan Anda sinkronkan. Misalnya, Anda mungkin menggunakan MySQL konektor untuk menyinkronkan dari MySQL database. Jika Anda menggunakan port default, grup keamanan harus mengizinkan Amazon Kendra untuk mengakses port 3306 pada host yang menjalankan database. Sebaiknya Anda mengonfigurasi grup keamanan default dengan nilai berikut Amazon Kendra untuk digunakan: + **Aturan masuk** - Jika Anda memilih untuk membiarkan ini kosong, semua lalu lintas masuk akan diblokir. + **Aturan keluar** — Tambahkan satu aturan untuk mengizinkan semua lalu lintas keluar sehingga Amazon Kendra dapat memulai permintaan untuk disinkronkan dari sumber data Anda. + **Versi IP** - IPv4 + **Jenis** — Semua lalu lintas + **Protokol** — Semua lalu lintas + **Rentang port** - Semua + **Tujuan** — 0.0.0.0/0 Untuk informasi selengkapnya tentang cara mengonfigurasi grup Amazon VPC [keamanan, lihat Aturan grup keamanan](https://docs.aws.amazon.com/vpc/latest/userguide/security-group-rules.html) di *Panduan Pengguna Amazon VPC*. ## Langkah 3. Konfigurasikan sumber data eksternal Anda dan Amazon VPC Pastikan sumber data eksternal Anda memiliki konfigurasi izin dan pengaturan jaringan yang benar Amazon Kendra untuk mengaksesnya. Anda dapat menemukan petunjuk terperinci tentang cara mengonfigurasi sumber data Anda di bagian prasyarat di setiap halaman konektor. Juga, periksa Amazon VPC pengaturan Anda dan pastikan bahwa sumber data eksternal Anda dapat dijangkau dari subnet yang akan Anda tetapkan. Amazon Kendra Untuk melakukan ini, kami sarankan Anda membuat Amazon EC2 instance di subnet yang sama dengan grup keamanan yang sama dan menguji akses ke sumber data Anda dari Amazon EC2 instance ini. Untuk informasi selengkapnya, lihat [Memecahkan masalah koneksi Amazon VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-connector-troubleshoot.html). # Siapkan sumber Amazon Kendra data untuk terhubung Amazon VPC Saat Anda menambahkan sumber data baru Amazon Kendra, Anda dapat menggunakan Amazon VPC fitur ini jika konektor sumber data yang dipilih mendukung fitur ini. Anda dapat mengatur sumber Amazon Kendra data baru dengan Amazon VPC diaktifkan dengan menggunakan Konsol Manajemen AWS atau Amazon Kendra API. Secara khusus, gunakan operasi [https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html)API, lalu gunakan `VpcConfiguration` parameter untuk memberikan informasi berikut: + `SubnetIds`— Daftar pengidentifikasi subnet Amazon VPC + `SecurityGroupIds`— Daftar pengidentifikasi kelompok Amazon VPC keamanan Jika Anda menggunakan konsol, Anda memberikan Amazon VPC informasi yang diperlukan selama konfigurasi konektor. Untuk menggunakan konsol untuk mengaktifkan fitur Amazon VPC untuk konektor, pertama-tama Anda memilih VPC Amazon. Kemudian, Anda memberikan pengidentifikasi subnet VPC Amazon dan pengidentifikasi grup keamanan VPC Amazon apa pun. Anda dapat memilih subnet Amazon VPC dan grup keamanan Amazon VPC yang Anda buat di Mengonfigurasi [Amazon VPC](https://docs.aws.amazon.com/kendra/latest/dg/connector-vpc-steps.html), atau menggunakan yang sudah ada. **Topics** + [Melihat Amazon VPC pengidentifikasi](#viewing-vpc-identifiers) + [Memeriksa IAM peran sumber data](#vpc-iam-roles) ## Melihat Amazon VPC pengidentifikasi Pengidentifikasi untuk subnet dan grup keamanan dikonfigurasi di konsol. Amazon VPC Untuk melihat pengidentifikasi, gunakan prosedur berikut. **Untuk melihat pengenal subnet** 1. Masuk ke Konsol Manajemen AWS dan buka konsol VPC Amazon di. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/) 1. Dari panel navigasi, pilih **Subnet**. 1. Dari daftar **Subnet**, pilih subnet yang berisi server database Anda. 1. Dari tab **Detail**, buat catatan pengenal di bidang **Subnet ID**. **Untuk melihat pengenal grup keamanan** 1. Masuk ke Konsol Manajemen AWS dan buka konsol VPC Amazon di. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/) 1. Dari panel navigasi, pilih **Grup keamanan**. 1. Dari daftar grup keamanan, pilih grup yang ingin Anda lihat pengenalnya. 1. Dari tab **Detail**, buat catatan pengenal di bidang **ID Grup Keamanan**. ## Memeriksa IAM peran sumber data Pastikan bahwa konektor sumber data Anda AWS Identity and Access Management IAM) peran berisi izin untuk mengakses Anda Amazon VPC. Jika Anda menggunakan konsol untuk membuat peran baru untuk IAM peran Anda, Amazon Kendra secara otomatis menambahkan izin yang benar ke IAM peran Anda atas nama Anda. Jika Anda menggunakan API, atau menggunakan IAM peran yang ada, periksa apakah peran Anda berisi izin untuk mengakses Amazon VPC. Untuk memverifikasi bahwa Anda memiliki izin yang tepat, lihat [IAM peran untuk VPC](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-vpc). Anda dapat memodifikasi sumber data yang ada untuk menggunakan Amazon VPC subnet yang berbeda. Namun, periksa IAM peran sumber data Anda dan, jika perlu, modifikasi untuk mencerminkan perubahan agar konektor sumber Amazon Kendra data berfungsi dengan baik. # Menghubungkan ke basis data di VPC Contoh berikut menunjukkan bagaimana menghubungkan MySQL database yang berjalan di virtual private cloud (VPC). Contohnya mengasumsikan bahwa Anda memulai dengan VPC default Anda dan Anda perlu membuat MySQL database. Jika Anda sudah memiliki VPC, pastikan itu dikonfigurasi seperti yang ditunjukkan. Jika Anda memiliki MySQL database, Anda dapat menggunakannya alih-alih membuat yang baru. **Topics** + [Langkah 1: Konfigurasikan VPC](#vpc-example-1) + [Langkah 2: Buat dan konfigurasikan grup keamanan](#vpc-example-2) + [Langkah 3: Buat basis data](#vpc-example-3) + [Langkah 4: Buat konektor sumber data](#vpc-example-4) ## Langkah 1: Konfigurasikan VPC Konfigurasikan VPC Anda sehingga Anda memiliki subnet pribadi dan grup keamanan Amazon Kendra untuk mengakses MySQL database yang berjalan di subnet. Subnet yang disediakan dalam konfigurasi VPC harus berada di Wilayah AS Barat (Oregon), Wilayah AS Timur (Virginia N.), atau Wilayah Eropa (Irlandia). **Untuk mengkonfigurasi VPC menggunakan Amazon VPC** 1. Masuk ke Konsol Manajemen AWS dan buka konsol VPC Amazon di. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/) 1. Dari panel navigasi, pilih **Tabel perutean**, lalu pilih **Buat tabel perutean**. 1. Untuk bidang **Nama**, masukkan**Private subnet route table**. **Dari dropdown **VPC**, pilih VPC Anda, lalu pilih Buat tabel rute.** Pilih **Tutup** untuk kembali ke daftar tabel perutean. 1. **Dari panel navigasi, pilih gateway **NAT, lalu pilih Buat gateway** NAT.** 1. Dari dropdown **Subnet**, pilih subnet yang merupakan subnet publik. Catat subnet ID. 1. Jika Anda tidak memiliki Alamat IP elastis, pilih **Buat EIP Baru**, pilih **Buat Gateway NAT**, lalu pilih **Tutup**. 1. Dari panel navigasi, pilih **Tabel rute**. 1. Dari daftar tabel perutean, pilih **Tabel rute subnet privat** yang Anda buat pada langkah 3. Dari **Tindakan**, pilih **Edit rute**. 1. Pilih **Tambahkan rute**. Untuk tujuan, masukkan **0.0.0.0/0** untuk memungkinkan semua lalu lintas keluar ke internet. Untuk **Target**, pilih **NAT Gateway**, lalu pilih gateway yang Anda buat di langkah 4. Pilih **Simpan perubahan**, lalu pilih **Tutup**. 1. Dari **Tindakan**, pilih **Edit pengaitan subnet.** 1. Pilih subnet yang ingin dijadikan privat. Jangan memilih subnet dengan gateway NAT yang Anda catat sebelumnya. Pilih **Simpan asosiasi** setelah selesai. ## Langkah 2: Buat dan konfigurasikan grup keamanan Selanjutnya, konfigurasikan grup keamanan untuk basis data Anda. **Untuk membuat dan mengkonfigurasi grup keamanan** 1. Masuk ke Konsol Manajemen AWS dan buka konsol VPC Amazon di. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/) 1. Dari deskripsi VPC Anda, perhatikan CIDR. IPv4 1. Dari panel navigasi, pilih **Grup keamanan** lalu pilih **Buat grup keamanan**. 1. Untuk **Nama grup keamanan**, masukkan **DataSourceInboundSecurityGroup**. Berikan deskripsi, lalu pilih VPC Anda dari daftar. Pilih **Buat grup keamanan** dan kemudian pilih **Tutup**. 1. Pilih tab **Aturan masuk**. 1. Pilih **Edit aturan masuk**, lalu pilih **Tambah** aturan 1. Untuk database, masukkan nomor port untuk **rentang Port**. Misalnya, untuk MySQL itu**3306**, dan, untuk HTTPS, itu**443**. Untuk **Sumber**, ketikkan Perutean Inter-Domain Tanpa Kelas (CIDR) VPC Anda. Pilih **Simpan aturan**, kemudian pilih **Tutup**. Grup keamanan memungkinkan siapa pun dalam VPC untuk terhubung ke basis data, dan memungkinkan koneksi keluar ke internet. ## Langkah 3: Buat basis data Buat database untuk menyimpan dokumen Anda, atau Anda dapat menggunakan database yang ada. Untuk petunjuk tentang cara membuat MySQL database, lihat [https://docs.aws.amazon.com/kendra/latest/dg/data-source-mysql.html](https://docs.aws.amazon.com/kendra/latest/dg/data-source-mysql.html). ## Langkah 4: Buat konektor sumber data Setelah Anda mengkonfigurasi VPC Anda dan membuat database Anda, Anda dapat membuat konektor sumber data untuk database. Untuk informasi tentang konektor database yang Amazon Kendra mendukung, lihat [Konektor yang didukung](https://docs.aws.amazon.com/kendra/latest/dg/data-sources.html). Untuk database Anda, pastikan Anda mengonfigurasi VPC, subnet pribadi yang Anda buat di VPC, dan grup keamanan yang Anda buat di VPC Anda. # Memecahkan masalah koneksi VPC Jika Anda mengalami masalah dengan koneksi virtual private cloud (VPC) Anda, periksa apakah IAM izin, pengaturan grup keamanan, dan tabel rute subnet dikonfigurasi dengan benar. Salah satu penyebab potensial dari sinkronisasi konektor sumber data yang gagal adalah bahwa sumber data mungkin tidak dapat dijangkau dari subnet yang Anda tetapkan. Amazon Kendra Untuk mengatasi masalah ini, sebaiknya Anda membuat Amazon EC2 instance dengan pengaturan yang sama Amazon VPC . Kemudian, coba akses sumber data dari Amazon EC2 instance ini menggunakan panggilan REST API atau metode lain (berdasarkan tipe spesifik sumber data Anda). Jika Anda berhasil mengakses sumber data dari Amazon EC2 instance yang Anda buat, itu berarti sumber data Anda dapat dijangkau dari subnet ini. Oleh karena itu, masalah sinkronisasi Anda tidak terkait dengan sumber data Anda yang tidak dapat diakses oleh Amazon VPC. Jika Anda tidak dapat mengakses Amazon EC2 instans dari konfigurasi VPC dan memvalidasinya dengan Amazon EC2 instance yang Anda buat, Anda perlu memecahkan masalah lebih lanjut. Misalnya, jika Anda memiliki Amazon S3 konektor yang sinkronisasi gagal dengan kesalahan terkait masalah koneksi, Anda dapat mengatur Amazon EC2 instance dengan Amazon VPC konfigurasi yang sama dengan yang Anda tetapkan ke Amazon S3 konektor Anda. Kemudian, gunakan instans Amazon EC2 ini untuk menguji apakah Anda Amazon VPC telah diatur dengan benar. Berikut ini adalah contoh pengaturan Amazon EC2 instance untuk memecahkan masalah Amazon VPC koneksi Anda dengan sumber Amazon S3 data. **Topics** + [Langkah 1: Luncurkan sebuah Amazon EC2 instance](#vpc-connector-troubleshoot-1) + [Langkah 2: Connect ke Amazon EC2 instance](#vpc-connector-troubleshoot-2) + [Langkah 3: Uji Amazon S3 akses](#vpc-connector-troubleshoot-3) ## Langkah 1: Luncurkan sebuah Amazon EC2 instance 1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon EC2 di. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) 1. Pilih **Luncurkan sebuah instance**. 1. Pilih **Pengaturan jaringan**, lalu pilih **Edit**, lalu lakukan hal berikut: 1. Pilih VPC dan **Subnet** yang sama dengan yang Anda tetapkan. Amazon Kendra 1. Untuk **Firewall (grup keamanan)**, pilih **Pilih grup keamanan yang ada**. Kemudian, pilih grup keamanan yang Anda tetapkan Amazon Kendra. **catatan** Kelompok keamanan harus mengizinkan lalu lintas keluar ke Amazon S3. 1. **Setel **Auto-tetapkan IP publik** ke Nonaktifkan.** 1. Dalam **Detail lanjutan**, lakukan hal berikut: + Untuk **profil instans IAM**, pilih **Buat profil IAM baru** untuk membuat dan melampirkan profil IAM instance ke instans Anda. Pastikan profil memiliki izin untuk mengakses Amazon S3. Untuk informasi selengkapnya, [lihat Bagaimana cara memberikan akses Amazon EC2 instans ke Amazon S3 bucket?](https://repost.aws/knowledge-center/ec2-instance-access-s3-bucket) di AWS re:Post. + Biarkan semua pengaturan lainnya sebagai default. 1. Tinjau dan luncurkan Amazon EC2 instance. ## Langkah 2: Connect ke Amazon EC2 instance Setelah Amazon EC2 instance Anda berjalan, buka halaman detail instance Anda dan sambungkan ke instance Anda. Untuk melakukannya, gunakan langkah-langkah di [Connect ke instans Anda tanpa memerlukan alamat IPv4 publik menggunakan EC2 Instance Connect](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connect-with-ec2-instance-connect-endpoint.html) Endpoint di *Panduan Pengguna untuk Instans Amazon EC2 Linux*. ## Langkah 3: Uji Amazon S3 akses Setelah Anda terhubung ke terminal Amazon EC2 instans Anda, jalankan AWS CLI perintah untuk menguji koneksi dari subnet pribadi ini ke Amazon S3 bucket Anda. Untuk menguji Amazon S3 akses, ketik AWS CLI perintah berikut di AWS CLI: `aws s3 ls` Setelah AWS CLI perintah berjalan, tinjau hal-hal berikut: + Jika Anda telah mengatur IAM izin yang diperlukan dengan benar dan Amazon S3 penyiapan Anda benar, Anda akan melihat daftar Amazon S3 bucket Anda. + Jika Anda melihat kesalahan izin seperti`Access Denied`, kemungkinan konfigurasi VPC Anda benar, tetapi ada yang salah dengan IAM izin atau Amazon S3 kebijakan bucket Anda. Jika perintahnya habis waktu, kemungkinan koneksi Anda habis waktu karena pengaturan VPC Anda salah dan instans Amazon EC2 tidak dapat mengakses Amazon S3 dari subnet Anda. Konfigurasikan ulang VPC Anda, dan coba lagi.