View a markdown version of this page

Schemi di modelli di origine dati - Amazon Kendra

Amazon Kendra non è più aperto a nuovi clienti. Per funzionalità simili a Amazon Kendra, esplora le Knowledge Bases di Amazon Bedrock. Ulteriori informazioni.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Schemi di modelli di origine dati

Di seguito sono riportati gli schemi di modello per le origini dati in cui i modelli sono supportati.

Adobe Experience Manager schema del modello

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Fornisci l'URL dell'Adobe Experience Managerhost, il tipo di autenticazione e se utilizzi Adobe Experience Manager (AEM) come servizio cloud o AEM On-Premise come parte della configurazione della connessione o dei dettagli dell'endpoint del repository. Inoltre, specificate il tipo di origine datiAEM, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per gli sviluppatori. Per ulteriori informazioni, consulta Adobe Experience Manager Schema JSON.

La tabella seguente descrive i parametri dello schema AEM JSON.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati.
URL AEM L’URL dell’host Adobe Experience Manager. Ad esempio, se utilizzi AEM On-Premise, includi il nome host e la porta:. https://hostname:port Oppure, se utilizzi AEM as a Cloud Service, è possibile utilizzare l’URL dell’autore: https://author-xxxxxx-xxxxxxx.adobeaemcloud.com.
authType Il tipo di autenticazione impiegato, se Basic o OAuth2.
deploymentType Il tipo di Adobe Experience Manager impiegato, CLOUD o ON_PREMISE.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
  • page

  • asset

Un elenco di oggetti che associano gli attributi o i nomi dei campi delle Adobe Experience Manager pagine e delle risorse ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati.
ora ZoneId

Se utilizzate AEM On-Premise e il fuso orario del server è diverso dal fuso orario del connettore o dell'indice Amazon Kendra AEM, potete specificare il fuso orario del server da allineare al connettore o all'indice AEM.

Il fuso orario predefinito per AEM On-Premise è il fuso orario del connettore o dell' Amazon Kendra indice AEM. Il fuso orario predefinito per AEM come servizio cloud è l'ora media di Greenwich.

  • pagina RootPaths

  • risorsa RootPaths

Un elenco di percorsi root per pagine e asset. Ad esempio, il percorso principale di una pagina potrebbe essere/content/sube il percorso principale di una risorsa potrebbe essere/content/sub/asset1.
CrawlAssets trueper scansionare gli asset.
Esplora le pagine trueper scansionare le pagine.
  • pagina PathInclusionPatterns

  • pagina NameInclusionPatterns

  • risorsa PathInclusionPatterns

  • risorsa TypeInclusionPatterns

  • risorsa NameInclusionPatterns

Un elenco di modelli di espressioni regolari per includere determinate pagine e asset nell’origine dati Adobe Experience Manager. Pagine e asset che corrispondono ai modelli sono inclusi nell’indice. Pagine e asset che non corrispondono ai modelli sono esclusi dall’indice. Se una pagina o asset corrisponde sia a un modello di inclusione sia a un modello di esclusione, il modello di esclusione ha la precedenza e il contenuto non viene incluso nell’indice.
  • pagina PathExclusionPatterns

  • pagina NameExclusionPatterns

  • risorsa PathExclusionPatterns

  • risorsa TypeInclusionPatterns

  • risorsa NameInclusionPatterns

Un elenco di modelli di espressioni regolari per escludere determinate pagine e asset nell’origine dati Adobe Experience Manager. Pagine e asset che corrispondono ai modelli sono esclusi dall’indice. Pagine e asset che non corrispondono ai modelli sono inclusi nell’indice. Se una pagina o asset corrisponde sia a un modello di inclusione sia a un modello di esclusione, il modello di esclusione ha la precedenza e il contenuto non viene incluso nell’indice.
Componenti della pagina Un elenco di nomi per gli specifici componenti della pagina che si intendono indicizzare.
contenuto FragmentVariations Un elenco di nomi per le varianti specifiche salvate di frammenti di contenuto di Adobe Experience Manager che si desiderano indicizzare.
tipo Il tipo di origine dati. Specifica AEM come tipo di origine dati.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretArn L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto che contiene le coppie chiave-valore necessarie per connettersi ad Adobe Experience Manager. Per informazioni su queste coppie chiave-valore, consulta le istruzioni di connessione per Adobe Experience Manager.
version La versione di questo modello attualmente supportata.
{ "$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 schema del modello (Windows)

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Fornisci l'ID del file system come parte della configurazione della connessione o dei dettagli dell'endpoint del repository. È inoltre necessario specificare il tipo di origine datiFSX, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. È quindi necessario specificare TEMPLATE come Type quando si chiama. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per gli sviluppatori. Per informazioni, consulta Amazon FSx Schema JSON (Windows).

La tabella seguente descrive i parametri dello schema JSON Amazon FSx (Windows).

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati.
file SystemId L'identificatore del Amazon FSx file system. Puoi trovare l'ID del tuo file system nella dashboard dei File Systems nella Amazon FSx console.
file SystemType Il tipo di Amazon FSx file system. Da utilizzare Windows File Server come tipo di file system, specificareWINDOWS.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
Tutti Un elenco di oggetti che associano gli attributi o i nomi dei campi dei file nell'origine Amazon FSx dati ai nomi dei campi Amazon Kendra indicizzati. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati.
è CrawlAcl trueper scansionare le informazioni dell'elenco di controllo degli accessi (ACL) dei tuoi documenti, se disponi di un ACL e desideri utilizzarlo per il controllo degli accessi. L'ACL specifica a quali documenti possono accedere utenti e gruppi. Le informazioni ACL vengono utilizzate per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo ai documenti. Per ulteriori informazioni, vedere Filtraggio del contesto utente.
Modelli di inclusione Un elenco di modelli di espressioni regolari per includere determinati file nell'origine dati. Amazon FSx I file che corrispondono ai modelli sono inclusi nell'indice. I file che non corrispondono ai modelli sono esclusi dall’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
Schemi di esclusione Un elenco di modelli di espressioni regolari per escludere determinati file nell'origine Amazon FSx dati. I file che corrispondono ai modelli sono esclusi dall’indice. I file che non corrispondono ai modelli sono inclusi nell’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
abilitare IdentityCrawler trueutilizzare il crawler Amazon Kendra di identità per sincronizzare identity/principal le informazioni su utenti e gruppi con accesso a determinati documenti. Se l'identity crawler è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

tipo Il tipo di origine dati. Per le origini dati del file system Windows, specificareFSX.
{ "$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 schema del modello (NetApp ONTAP)

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Fornisci l'ID del file system e la macchina virtuale di archiviazione (SVM) come parte della configurazione della connessione o dei dettagli dell'endpoint del repository. È inoltre necessario specificare il tipo di origine datiFSXONTAP, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. È quindi necessario specificare TEMPLATE come Type quando si chiama. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per gli sviluppatori. Per informazioni, consulta Amazon FSx (NetApp ONTAP) schema JSON.

La tabella seguente descrive i parametri dello schema JSON Amazon FSx (NetApp ONTAP).

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati.
file SystemId L'identificatore del Amazon FSx file system. Puoi trovare l'ID del tuo file system nella dashboard dei File Systems nella Amazon FSx console. Per informazioni su come creare un file system nella Amazon FSx console per NetApp ONTAP, consulta la Guida introduttiva per NetApp ONTAP nella Guida per l'FSx for ONTAP utente.
file SystemType Il tipo di Amazon FSx file system. Da utilizzare NetApp ONTAP come tipo di file system, specificareONTAP.
SVMid L'identificatore della macchina virtuale di archiviazione (SVM) utilizzata con il Amazon FSx file system per. NetApp ONTAP Puoi trovare il tuo ID SVM accedendo alla dashboard dei File Systems nella Amazon FSx console, selezionando l'ID del file system e quindi selezionando Storage virtual machines. Per informazioni su come creare un file system nella Amazon FSx console perNetApp ONTAP, consulta la Guida introduttiva per NetApp ONTAP nella Guida per l'FSx for ONTAP utente.
Tipo di protocollo Sia che utilizzi il protocollo Common Internet File System (CIFS) per Windows o il protocollo Network File System (NFS) per Linux.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
file Un elenco di oggetti che associano gli attributi o i nomi dei campi dei file nell'origine Amazon FSx dati per Amazon Kendra indicizzare i nomi dei campi. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati. I nomi dei campi dell'origine dati devono essere presenti nei metadati personalizzati dei file.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati.
CrawlaCL trueper scansionare le informazioni dell'elenco di controllo degli accessi (ACL) dei tuoi documenti, se disponi di un ACL e desideri utilizzarlo per il controllo degli accessi. L'ACL specifica a quali documenti possono accedere utenti e gruppi. Le informazioni ACL vengono utilizzate per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo ai documenti. Per ulteriori informazioni, vedere Filtraggio del contesto utente.
Modelli di inclusione Un elenco di modelli di espressioni regolari per includere determinati file nell'origine dati. Amazon FSx I file che corrispondono ai modelli sono inclusi nell'indice. I file che non corrispondono ai modelli sono esclusi dall’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
Schemi di esclusione Un elenco di modelli di espressioni regolari per escludere determinati file nell'origine Amazon FSx dati. I file che corrispondono ai modelli sono esclusi dall’indice. I file che non corrispondono ai modelli sono inclusi nell’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
tipo Il tipo di origine dati. Per le origini dati del NetApp ONTAP file system, specificareFSXONTAP.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretArn

L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto che contiene le coppie chiave-valore necessarie per connettersi al tuo Amazon FSx file system. Il segreto deve contenere una struttura JSON con le seguenti chiavi:

{ "username": "user@corp.example.com", "password": "password" }

Se utilizzi il protocollo NFS per il tuo Amazon FSx file system, il segreto viene archiviato in una struttura JSON con le seguenti chiavi:

{ "leftId": "left ID", "rightId": "right ID", "preSharedKey": "pre-shared key" }
{ "$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" ] }

Alfresco schema del modello

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Fornisci l'ID del Alfresco sito, l'URL del repository, l'URL dell'interfaccia utente, il tipo di autenticazione, se utilizzi il cloud o l'ambiente locale e il tipo di contenuto che desideri scansionare. Lo fornisci come parte della configurazione della connessione o dei dettagli dell'endpoint del repository. Specifica inoltre il tipo di origine datiALFRESCO, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Alfresco Schema JSON.

La tabella seguente descrive i parametri dello schema JSON di Alfresco.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati.
ID del sito L'identificatore del sito Alfresco.
RepoURL L’URL del repository Alfresco. È possibile ottenere l’URL del repository dall’amministratore di Alfresco. Ad esempio, in caso di utilizzo di Alfresco Cloud (PaaS), l’URL del repository potrebbe essere https://company.alfrescocloud.com. Oppure, se lo usi Alfresco On-Premises, l'URL del repository potrebbe essere. https://company-alfresco-instance.company-domain.suffix:port
web AppUrl L’URL dell’interfaccia utente Alfresco. È possibile ottenere l’URL dell’interfaccia utente Alfresco dall’amministratore di Alfresco. Ad esempio, l’URL dell’interfaccia utente potrebbe essere https://example.com.
deposito AdditionalProperties Proprietà aggiuntive per connettersi all'endpoint di repository/data origine.
authType Il tipo di autenticazione impiegato, se OAuth2 o Basic.
tipo (distribuzione) Il tipo di Alfresco impiegato, se PAAS o ON-PREM.
Tipo di esplorazione Il tipo di contenuto che desideri sottoporre a crawling, sia esso ASPECT (contenuto contrassegnato con “Aspetti” in Alfresco), SITE_ID (contenuto all’interno di un sito Alfresco specifico) o ALL_SITES (contenuto presente in tutti i siti Alfresco).
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
  • documento

  • comment

Un elenco di oggetti che associano gli attributi o i nomi dei campi dei documenti e dei commenti Alfresco ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati.
AspectName

Il nome di un 'Aspetto' specifico che desideri indicizzare.

Proprietà dell'aspetto

Un elenco di proprietà specifiche del contenuto «Aspect» che desideri indicizzare.

abilita FineGrainedControl

true per eseguire il crawling di “Aspetti”.

è CrawlComment

trueper scansionare i commenti.

  • inclusione FileNamePatterns

  • inclusione FileTypePatterns

  • inclusione FilePathPatterns

Un elenco di modelli di espressioni regolari per includere determinati file nell’origine dati Alfresco. I file che corrispondono ai modelli sono inclusi nell'indice. I file che non corrispondono ai modelli sono esclusi dall’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
  • esclusione FileNamePatterns

  • esclusione FileTypePatterns

  • esclusione FilePathPatterns

Un elenco di modelli di espressioni regolari per escludere determinati file nell’origine dati Alfresco. I file che corrispondono ai modelli sono esclusi dall’indice. I file che non corrispondono ai modelli sono inclusi nell’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
tipo Il tipo di origine dati. Specifica ALFRESCO come tipo di origine dati.
secretArn

L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto che contiene le coppie chiave-valore necessarie per connettersi al tuo. Alfresco Il segreto deve contenere una struttura JSON con le seguenti chiavi:

In caso di utilizzo dell’autenticazione Base:

{ "username": "user name", "password": "password" }

In caso di utilizzo dell’autenticazione OAuth 2.0:

{ "clientId": "client ID", "clientSecret": "client secret", "tokenUrl": "token URL" }
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

abilita IdentityCrawler trueutilizzare il crawler Amazon Kendra di identità per sincronizzare identity/principal le informazioni su utenti e gruppi con accesso a determinati documenti. Se l'identity crawler è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi.
version La versione di questo modello attualmente supportata.
{ "$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 schema del modello (MySQL)

Includi un JSON che contiene lo schema dell'origine dati come parte dell'oggetto. TemplateConfiguration Specifica il tipo di origine datiJDBC, il tipo di databasemysql, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Aurora (MySQL) schema JSON.

La tabella seguente descrive i parametri dello schema JSON Aurora (MySQL).

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Informazioni di configurazione necessarie per la connessione dell’origine dati.
  • DBTYPE: il tipo di database Java utilizzato, se,, mysqldb2, postgresql o. oracle sqlserver

  • dbHost: il nome dell’host del database.

  • dbPort: la porta del database.

  • dbInstance: l’istanza database.

repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi. Specifica il tipo di origine dati e l’ARN del segreto.

documento

Un elenco di oggetti che associano gli attributi o i nomi dei campi del contenuto del database ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati. Da utilizzare per includere o escludere contenuti specifici nell’origine dati del database.
primaryKey Immetti la chiave primaria per la tabella del database. Questo valore identifica una tabella all’interno del database.
titleColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
bodyColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
sqlQuery Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono pesare meno di 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
timestampColumn Inserisci il nome della colonna che contiene i timestamp. Amazon Kendra utilizza le informazioni relative all'ora per rilevare le modifiche nei contenuti e sincronizzare solo i contenuti modificati.
timestampFormat Immetti il nome della colonna che contiene i formati dei timestamp da utilizzare per rilevare le modifiche ai contenuti e risincronizzare i contenuti.
timezone Immetti il nome della colonna che contiene i fusi orari per il contenuto di cui eseguire il crawling.
modifica DetectingColumns Inserisci i nomi delle colonne che Amazon Kendra verranno utilizzate per rilevare le modifiche al contenuto. Amazon Kendra reindicizzerà il contenuto in caso di modifica in una di queste colonne
consentito UsersColumns Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
consentito GroupsColumn Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
sourceURIColumn Immetti il nome della colonna che contiene gli URL di origine da indicizzare.
è SslEnabled Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono essere inferiori a 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
tipo Il tipo di origine dati. Specifica JDBC come tipo di origine dati.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretArn Il nome della risorsa Amazon (ARN) di un segreto di Secrets Manager contenente il nome utente e la password necessari per connettersi al database. Il segreto deve contenere una struttura JSON con le seguenti chiavi:
{ "user name": "database user name", "password": "password" }
version La versione del modello attualmente supportata.
{ "$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) schema del modello

Includi un JSON che contiene lo schema dell'origine dati come parte dell'oggetto. TemplateConfiguration Specifica il tipo di origine datiJDBC, il tipo di databasepostgresql, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Aurora (PostgreSQL) schema JSON.

La tabella seguente descrive i parametri dello schema Aurora JSON (PostgreSQL).

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Informazioni di configurazione necessarie per la connessione dell’origine dati.
  • DBTYPE: il tipo di database Java utilizzato, se,, mysqldb2, postgresql o. oracle sqlserver

  • dbHost: il nome dell’host del database.

  • dbPort: la porta del database.

  • dbInstance: l’istanza database.

repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi. Specifica il tipo di origine dati e l’ARN del segreto.

documento

Un elenco di oggetti che associano gli attributi o i nomi dei campi del contenuto del database ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati. Da utilizzare per includere o escludere contenuti specifici nell’origine dati del database.
primaryKey Immetti la chiave primaria per la tabella del database. Questo valore identifica una tabella all’interno del database.
titleColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
bodyColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
sqlQuery Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono pesare meno di 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
timestampColumn Inserisci il nome della colonna che contiene i timestamp. Amazon Kendra utilizza le informazioni relative all'ora per rilevare le modifiche nei contenuti e sincronizzare solo i contenuti modificati.
timestampFormat Immetti il nome della colonna che contiene i formati dei timestamp da utilizzare per rilevare le modifiche ai contenuti e risincronizzare i contenuti.
timezone Immetti il nome della colonna che contiene i fusi orari per il contenuto di cui eseguire il crawling.
modifica DetectingColumns Inserisci i nomi delle colonne che Amazon Kendra verranno utilizzate per rilevare le modifiche al contenuto. Amazon Kendra reindicizzerà il contenuto in caso di modifica in una di queste colonne
consentito UsersColumns Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
consentito GroupsColumn Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
sourceURIColumn Immetti il nome della colonna che contiene gli URL di origine da indicizzare.
è SslEnabled Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono essere inferiori a 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
tipo Il tipo di origine dati. Specifica JDBC come tipo di origine dati.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretArn Il nome della risorsa Amazon (ARN) di un segreto di Secrets Manager contenente il nome utente e la password necessari per connettersi al database. Il segreto deve contenere una struttura JSON con le seguenti chiavi:
{ "user name": "database user name", "password": "password" }
version La versione del modello attualmente supportata.
{ "$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 Schema del modello (Microsoft SQL Server)

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Specifica il tipo di origine datiJDBC, il tipo di databasesqlserver, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per gli sviluppatori. Per informazioni, consulta Amazon RDS Schema JSON (Microsoft SQL Server).

La tabella seguente descrive i parametri dello schema JSON Amazon RDS (Microsoft SQL Server).

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Informazioni di configurazione necessarie per la connessione dell’origine dati.
  • DBTYPE: il tipo di database Java utilizzato, se,, mysqldb2, postgresql o. oracle sqlserver

  • dbHost: il nome dell’host del database.

  • dbPort: la porta del database.

  • dbInstance: l’istanza database.

repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi. Specifica il tipo di origine dati e l’ARN del segreto.

documento

Un elenco di oggetti che associano gli attributi o i nomi dei campi del contenuto del database ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati. Da utilizzare per includere o escludere contenuti specifici nell’origine dati del database.
primaryKey Immetti la chiave primaria per la tabella del database. Questo valore identifica una tabella all’interno del database.
titleColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
bodyColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
sqlQuery Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono pesare meno di 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
timestampColumn Inserisci il nome della colonna che contiene i timestamp. Amazon Kendra utilizza le informazioni relative all'ora per rilevare le modifiche nei contenuti e sincronizzare solo i contenuti modificati.
timestampFormat Immetti il nome della colonna che contiene i formati dei timestamp da utilizzare per rilevare le modifiche ai contenuti e risincronizzare i contenuti.
timezone Immetti il nome della colonna che contiene i fusi orari per il contenuto di cui eseguire il crawling.
modifica DetectingColumns Inserisci i nomi delle colonne che Amazon Kendra verranno utilizzate per rilevare le modifiche al contenuto. Amazon Kendra reindicizzerà il contenuto in caso di modifica in una di queste colonne
consentito UsersColumns Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
consentito GroupsColumn Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
sourceURIColumn Immetti il nome della colonna che contiene gli URL di origine da indicizzare.
è SslEnabled Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono essere inferiori a 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
tipo Il tipo di origine dati. Specifica JDBC come tipo di origine dati.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretArn Il nome della risorsa Amazon (ARN) di un segreto di Secrets Manager contenente il nome utente e la password necessari per connettersi al database. Il segreto deve contenere una struttura JSON con le seguenti chiavi:
{ "user name": "database user name", "password": "password" }
version La versione del modello attualmente supportata.
{ "$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 schema del modello (MySQL)

Includi un JSON che contiene lo schema dell'origine dati come parte dell'oggetto. TemplateConfiguration Specifica il tipo di origine datiJDBC, il tipo di databasemysql, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per gli sviluppatori. Per informazioni, consulta Amazon RDS (MySQL) schema JSON.

La tabella seguente descrive i parametri dello schema JSON Amazon RDS (MySQL).

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Informazioni di configurazione necessarie per la connessione dell’origine dati.
  • DBTYPE: il tipo di database Java utilizzato, se,, mysqldb2, postgresql o. oracle sqlserver

  • dbHost: il nome dell’host del database.

  • dbPort: la porta del database.

  • dbInstance: l’istanza database.

repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi. Specifica il tipo di origine dati e l’ARN del segreto.

documento

Un elenco di oggetti che associano gli attributi o i nomi dei campi del contenuto del database ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati. Da utilizzare per includere o escludere contenuti specifici nell’origine dati del database.
primaryKey Immetti la chiave primaria per la tabella del database. Questo valore identifica una tabella all’interno del database.
titleColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
bodyColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
sqlQuery Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono pesare meno di 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
timestampColumn Inserisci il nome della colonna che contiene i timestamp. Amazon Kendra utilizza le informazioni relative all'ora per rilevare le modifiche nei contenuti e sincronizzare solo i contenuti modificati.
timestampFormat Immetti il nome della colonna che contiene i formati dei timestamp da utilizzare per rilevare le modifiche ai contenuti e risincronizzare i contenuti.
timezone Immetti il nome della colonna che contiene i fusi orari per il contenuto di cui eseguire il crawling.
modifica DetectingColumns Inserisci i nomi delle colonne che Amazon Kendra verranno utilizzate per rilevare le modifiche al contenuto. Amazon Kendra reindicizzerà il contenuto in caso di modifica in una di queste colonne
consentito UsersColumns Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
consentito GroupsColumn Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
sourceURIColumn Immetti il nome della colonna che contiene gli URL di origine da indicizzare.
è SslEnabled Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono essere inferiori a 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
tipo Il tipo di origine dati. Specifica JDBC come tipo di origine dati.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretArn Il nome della risorsa Amazon (ARN) di un segreto di Secrets Manager contenente il nome utente e la password necessari per connettersi al database. Il segreto deve contenere una struttura JSON con le seguenti chiavi:
{ "user name": "database user name", "password": "password" }
version La versione del modello attualmente supportata.
{ "$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 schema del modello (Oracle)

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Specifica il tipo di origine datiJDBC, il tipo di databaseoracle, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per gli sviluppatori. Per informazioni, consulta Amazon RDS schema JSON (Oracle).

La tabella seguente descrive i parametri dello schema JSON Amazon RDS (Oracle).

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Informazioni di configurazione necessarie per la connessione dell’origine dati.
  • DBTYPE: il tipo di database Java utilizzato, se,, mysqldb2, postgresql o. oracle sqlserver

  • dbHost: il nome dell’host del database.

  • dbPort: la porta del database.

  • dbInstance: l’istanza database.

repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi. Specifica il tipo di origine dati e l’ARN del segreto.

documento

Un elenco di oggetti che associano gli attributi o i nomi dei campi del contenuto del database ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati. Da utilizzare per includere o escludere contenuti specifici nell’origine dati del database.
primaryKey Immetti la chiave primaria per la tabella del database. Questo valore identifica una tabella all’interno del database.
titleColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
bodyColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
sqlQuery Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono pesare meno di 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
timestampColumn Inserisci il nome della colonna che contiene i timestamp. Amazon Kendra utilizza le informazioni relative all'ora per rilevare le modifiche nei contenuti e sincronizzare solo i contenuti modificati.
timestampFormat Immetti il nome della colonna che contiene i formati dei timestamp da utilizzare per rilevare le modifiche ai contenuti e risincronizzare i contenuti.
timezone Immetti il nome della colonna che contiene i fusi orari per il contenuto di cui eseguire il crawling.
modifica DetectingColumns Inserisci i nomi delle colonne che Amazon Kendra verranno utilizzate per rilevare le modifiche al contenuto. Amazon Kendra reindicizzerà il contenuto in caso di modifica in una di queste colonne
consentito UsersColumns Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
consentito GroupsColumn Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
sourceURIColumn Immetti il nome della colonna che contiene gli URL di origine da indicizzare.
è SslEnabled Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono essere inferiori a 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
tipo Il tipo di origine dati. Specifica JDBC come tipo di origine dati.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretArn Il nome della risorsa Amazon (ARN) di un segreto di Secrets Manager contenente il nome utente e la password necessari per connettersi al database. Il segreto deve contenere una struttura JSON con le seguenti chiavi:
{ "user name": "database user name", "password": "password" }
version La versione del modello attualmente supportata.
{ "$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 schema del modello (PostgreSQL)

Includi un JSON che contiene lo schema dell'origine dati come parte dell'oggetto. TemplateConfiguration Specifica il tipo di origine datiJDBC, il tipo di databasepostgresql, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per gli sviluppatori. Per informazioni, consulta Amazon RDS (PostgreSQL) schema JSON.

La tabella seguente descrive i parametri dello schema Amazon RDS JSON (PostgreSQL).

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Informazioni di configurazione necessarie per la connessione dell’origine dati.
  • DBTYPE: il tipo di database Java utilizzato, se,, mysqldb2, postgresql o. oracle sqlserver

  • dbHost: il nome dell’host del database.

  • dbPort: la porta del database.

  • dbInstance: l’istanza database.

repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi. Specifica il tipo di origine dati e l’ARN del segreto.

documento

Un elenco di oggetti che associano gli attributi o i nomi dei campi del contenuto del database ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati. Da utilizzare per includere o escludere contenuti specifici nell’origine dati del database.
primaryKey Immetti la chiave primaria per la tabella del database. Questo valore identifica una tabella all’interno del database.
titleColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
bodyColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
sqlQuery Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono pesare meno di 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
timestampColumn Inserisci il nome della colonna che contiene i timestamp. Amazon Kendra utilizza le informazioni relative all'ora per rilevare le modifiche nei contenuti e sincronizzare solo i contenuti modificati.
timestampFormat Immetti il nome della colonna che contiene i formati dei timestamp da utilizzare per rilevare le modifiche ai contenuti e risincronizzare i contenuti.
timezone Immetti il nome della colonna che contiene i fusi orari per il contenuto di cui eseguire il crawling.
modifica DetectingColumns Inserisci i nomi delle colonne che Amazon Kendra verranno utilizzate per rilevare le modifiche al contenuto. Amazon Kendra reindicizzerà il contenuto in caso di modifica in una di queste colonne
consentito UsersColumns Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
consentito GroupsColumn Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
sourceURIColumn Immetti il nome della colonna che contiene gli URL di origine da indicizzare.
è SslEnabled Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono essere inferiori a 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
tipo Il tipo di origine dati. Specifica JDBC come tipo di origine dati.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretArn Il nome della risorsa Amazon (ARN) di un segreto di Secrets Manager contenente il nome utente e la password necessari per connettersi al database. Il segreto deve contenere una struttura JSON con le seguenti chiavi:
{ "user name": "database user name", "password": "password" }
version La versione del modello attualmente supportata.
{ "$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 schema del modello

Includi un JSON che contiene lo schema dell'origine dati come parte della configurazione del modello. Fornisci il nome del bucket S3 come parte della configurazione della connessione o dei dettagli dell'endpoint del repository. Specifica inoltre il tipo di origine dati e le altre configurazioni S3 necessarie. Quindi si specifica TEMPLATE come Type quando si chiama CreateDataSource.

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Schema JSON S3.

La tabella seguente descrive i parametri dello schema Amazon S3 JSON.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati.
BucketName Il nome del tuo Amazon S3 secchio.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati
  • Schemi di inclusione

  • Schemi di esclusione

  • Prefissi di inclusione

  • Prefissi di esclusione

Un elenco di modelli di espressioni regolari per includere o escludere file specifici nell'origine dati. Amazon S3 I file che corrispondono ai modelli sono inclusi nell'indice. I file che non corrispondono ai modelli sono esclusi dall’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
acl ConfigurationFilePath Il percorso del file che controlla l'accesso ai documenti in un Amazon Kendra indice.
metadati FilesPrefix La posizione all'interno del bucket per i file di metadati.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

tipo Il tipo di origine dati. Specifica S3 come tipo di origine dati.
version La versione del modello supportata.
{ "$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 Schema del modello Web Crawler

Includi un JSON che contiene lo schema dell'origine dati come parte dell'oggetto. TemplateConfiguration

Fornisci gli URL iniziali o iniziali oppure puoi fornire gli URL della mappa del sito, come parte della configurazione della connessione o dei dettagli degli endpoint del repository. Invece di elencare manualmente tutti i tuoi URL, puoi fornire il percorso del Amazon S3 bucket che memorizza un file di testo per il tuo elenco di URL iniziali o file XML della mappa del sito, che puoi raggruppare in un file ZIP in S3.

È inoltre possibile specificare il tipo di origine datiWEBCRAWLERV2, le credenziali di autenticazione del sito Web e il tipo di autenticazione se i siti Web richiedono l'autenticazione e altre configurazioni necessarie.

Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Importante

La creazione del connettore Web Crawler v2.0 non è supportata da. CloudFormation Usa il connettore Web Crawler v1.0 se hai bisogno di supporto. CloudFormation

Quando selezioni i siti Web da indicizzare, devi rispettare la Policy di uso accettabile di Amazon e tutti gli altri termini di Amazon. Ricorda che devi utilizzare Amazon Kendra Web Crawler solo per indicizzare le tue pagine Web o le pagine Web che hai l'autorizzazione a indicizzare. Per sapere come impedire a Amazon Kendra Web Crawler di indicizzare i tuoi siti Web, consulta. Configurazione del file per Web Crawler robots.txt Amazon Kendra

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Amazon Kendra Schema JSON di Web Crawler.

La tabella seguente descrive i parametri dello schema JSON di Amazon Kendra Web Crawler.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati.
sito MapUrls L’elenco degli URL delle mappe dei siti per i siti web che desideri sottoporre a crawling. È possibile elencare fino a tre URL di mappe dei siti.
s3 SeedUrl Il percorso S3 del file di testo che archivia l’elenco degli URL iniziali o di partenza. Ad esempio, s3://bucket-name/directory/. Ogni URL nel file di testo deve essere formattato su una riga separata. È possibile elencare fino a 100 URL iniziali in un file.
s3 SiteMapUrl Il percorso S3 dei file XML delle mappe dei siti. Ad esempio, s3://bucket-name/directory/. È possibile elencare fino a tre URL di mappe dei siti. Puoi raggruppare più file Sitemap in un file ZIP e archiviare il file ZIP nel tuo bucket. Amazon S3
seme UrlConnections L'elenco degli URL iniziali o iniziali per i siti Web che desideri scansionare. Puoi elencare fino a 100 URL iniziali.
URL di ricerca L'URL iniziale o iniziale.
autenticazione Il tipo di autenticazione se i tuoi siti web richiedono la stessa autenticazione, altrimenti specificaNoAuthentication.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
  • Pagina Web

  • attachment

Un elenco di oggetti che associano gli attributi o i nomi dei campi delle pagine Web e dei file delle pagine Web ai nomi dei campi di Amazon Kendra indicizzazione. Ad esempio, il tag del titolo della pagina Web HTML può essere mappato al campo dell'_document_titleindice. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati.
Limite di velocità Il numero massimo di URL di cui viene eseguito il crawling per host di sito web al minuto.
massimo FileSize La dimensione massima (in MB) di una pagina Web o di un allegato da sottoporre a scansione.
Profondità di esplorazione Il numero di livelli dall’URL iniziale da sottoporre a crawling. Ad esempio, la pagina URL iniziale ha profondità 1 e tutti i collegamenti ipertestuali su questa pagina che vengono anch’essi sottoposti a crawling hanno profondità 2.
max LinksPerUrl Il numero massimo di URL in una pagina Web da includere durante la scansione di un sito Web. Questo numero è per pagina web. Quando le pagine Web di un sito Web vengono sottoposte a scansione, vengono sottoposti a scansione anche tutti gli URL a cui le pagine Web si collegano. Gli URL di una pagina Web vengono sottoposti a scansione in ordine di apparizione.
scansione SubDomain trueper eseguire la scansione dei domini del sito Web con i sottodomini. Ad esempio, se l'URL iniziale è "abc.example.com«, anche" "e" a.abc.example.com "vengono sottoposti a scansioneb.abc.example.com. Se non imposti crawlSubDomain o non lo crawlAllDomain impostitrue, esegue la scansione Amazon Kendra solo dei domini dei siti Web che desideri scansionare.
scansionare AllDomain trueper eseguire la scansione dei domini del sito Web con sottodomini e altri domini a cui le pagine Web si collegano. Se non lo crawlSubDomain impostitrue, esegue la scansione Amazon Kendra solo dei domini dei siti Web di cui desideri eseguire la scansione. crawlAllDomain
Honor Robots true per rispettare le indicazioni robots.txt dei siti web da sottoporre a crawling. Queste direttive controllano il modo in cui Amazon Kendra Web Crawler esegue la scansione dei siti Web, se Amazon Kendra può eseguire la scansione solo di contenuti specifici o non eseguire la scansione di alcun contenuto.
Scansiona gli allegati trueper eseguire la scansione dei file a cui si collegano le pagine Web.
  • inclusione URLCrawlPatterns

  • inclusione URLIndexPatterns

Un elenco di modelli di espressioni regolari da includere nella scansione di determinati URL e nell'indicizzazione di eventuali collegamenti ipertestuali su queste pagine Web URL. Gli URL che corrispondono ai modelli sono inclusi nell’indice. Gli URL che non corrispondono ai modelli sono esclusi dall’indice. Se un URL corrisponde sia a un modello di inclusione che a uno di esclusione, il modello di esclusione ha la precedenza e le pagine Web non sono incluse nell'indice URL/website.
  • esclusione URLCrawlPatterns

  • esclusione URLIndexPatterns

Un elenco di modelli di espressioni regolari per escludere la scansione di determinati URL e l'indicizzazione di eventuali collegamenti ipertestuali su queste pagine Web URL. Gli URL che corrispondono ai modelli sono esclusi dall’indice. Gli URL che non corrispondono ai modelli sono inclusi nell’indice. Se un URL corrisponde sia a un modello di inclusione che a uno di esclusione, il modello di esclusione ha la precedenza e le pagine Web non sono incluse nell'indice URL/website.
inclusione FileIndexPatterns Un elenco di modelli di espressioni regolari per includere determinati file di pagine web. I file che corrispondono ai modelli sono inclusi nell'indice. I file che non corrispondono ai modelli sono esclusi dall’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
esclusione FileIndexPatterns Un elenco di modelli di espressioni regolari per escludere determinati file di pagine Web. I file che corrispondono ai modelli sono esclusi dall’indice. I file che non corrispondono ai modelli sono inclusi nell’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
implicito WaitDuration

implicito WaitDuration specifica per quanto tempo il connettore aspetterà, in secondi, prima di eseguire la scansione di una pagina web.

Intervallo: 0-10

ad esempio. «implicito WaitDuration «: «5"

proxy Informazioni sulla configurazione richiesta per effettuare la connessione ai siti Web interni tramite un proxy Web.
host Il nome host del server proxy che desideri utilizzare per connetterti ai siti Web interni. Ad esempio, il nome host di https://a.example.com/page1.html è "a.example.com».
port Il numero di porta del server proxy che desideri utilizzare per connetterti ai siti Web interni. Ad esempio, 443 è la porta standard per HTTPS.
SecretARN (proxy) Se sono necessarie le credenziali del proxy web per connettersi all'host di un sito Web, è possibile creare un AWS Secrets Manager segreto che memorizza le credenziali. Immetti il nome della risorsa Amazon (ARN) del segreto.
tipo Il tipo di origine dati. Specifica WEBCRAWLERV2 come tipo di origine dati.
secretArn

L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto utilizzato se i tuoi siti Web richiedono l'autenticazione per accedere ai siti Web. Le credenziali di autenticazione per il sito web vengono archiviate nel segreto che contiene coppie chiave-valore JSON.

Se utilizzi basic o NTML/Kerberos, inserisci il nome utente e la password. Le chiavi JSON nel segreto devono essere userName e password. Il protocollo di autenticazione NTLM include l’hashing delle password e il protocollo di autenticazione Kerberos include la crittografia delle password.

Se utilizzi SAML o l'autenticazione tramite modulo, inserisci il nome utente e la password, XPath per il campo del nome utente (e il pulsante del nome utente se usi SAML), XPaths per il campo e il pulsante della password e l'URL della pagina di accesso. Le chiavi JSON nel segreto devono essere userName, password, userNameFieldXpath, userNameButtonXpath, passwordFieldXpath, passwordButtonXpath e loginPageUrl. È possibile trovare gli XPath (XML Path Language) degli elementi utilizzando gli strumenti per sviluppatori del browser web. Gli XPath solitamente seguono questo formato: //tagname[@Attribute='Value'].

Amazon Kendra controlla anche se le informazioni sugli endpoint (URL iniziali) incluse nel segreto sono le stesse informazioni sugli endpoint specificate nei dettagli di configurazione dell'endpoint dell'origine dati.

version La versione di questo modello attualmente supportata.
{ "$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" ] }

Schema del modello Confluence

Includi un JSON che contiene lo schema dell'origine dati come parte dell'oggetto. TemplateConfiguration Fornisci l'URL dell'host di Confluence, il metodo di hosting e il tipo di autenticazione come parte della configurazione della connessione o dei dettagli dell'endpoint del repository. Specificate anche il tipo di origine datiCONFLUENCEV2, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Schema JSON di Confluence.

La tabella seguente descrive i parametri dello schema JSON di Confluence.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
deposito EndpointMetadata Le informazioni sull’endpoint per l’origine dati.
hostUrl L'URL della tua istanza Confluence. Ad esempio, https://example.confluence.com.
tipo Il metodo di hosting per la tua istanza Confluence, se e. SAAS ON_PREM
authType Il metodo di autenticazione per la tua istanza Confluence, se,, oBasic. OAuth2 Personal-token
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
  • spazio

  • page

  • blog

  • comment

  • attachment

Un elenco di oggetti che associano gli attributi o i nomi dei campi degli spazi, delle pagine, dei blog, dei commenti e degli allegati di Confluence ai Amazon Kendra nomi dei campi di indice. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati. I nomi dei campi dell'origine dei dati Confluence devono essere presenti nei metadati personalizzati di Confluence.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati.
è CrawlAcl Configura true in modo da eseguire la scansione delle informazioni dell'elenco di controllo degli accessi (ACL) dei tuoi documenti, se disponi di un ACL e desideri utilizzarlo per il controllo degli accessi. Tieni presente che l'ACL specifica a quali documenti possono accedere utenti e gruppi. Le informazioni ACL vengono utilizzate per filtrare i risultati della ricerca in base all'accesso dell'utente o del suo gruppo ai documenti. Ciò significa che se isCrawlACL è disattivata, i documenti possono essere ricercati pubblicamente. Per ulteriori informazioni, consulta Filtraggio del contesto utente.
campo ForUserId Specifica email se desideri utilizzare l'email dell'utente per l'ID utente. emailviene utilizzato per impostazione predefinita ed è attualmente l'unico tipo di ID utente supportato.
  • inclusione SpaceKeyFilter

  • esclusione SpaceKeyFilter

  • pagina EX TitleReg

  • blog TitleReg EX

  • commento TitleReg EX

  • allegato TitleReg EX

  • inclusione FileTypePatterns

  • esclusione FileTypePatterns

  • inclusione UrlPatterns

  • esclusione UrlPatterns

Un elenco di modelli di espressioni regolari da includere per and/or escludere determinati file nell'origine dati Confluence. I file che corrispondono ai modelli sono inclusi nell'indice. I file che non corrispondono ai modelli sono esclusi dall’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
ProxyHost Il nome host del proxy web che usi, senza il protocollo http:// orhttps://.

ProxyPort

Il numero di porta utilizzato dal protocollo di trasporto degli URL dell'host. Deve essere un valore numerico compreso tra 0 e 65535.
  • è CrawlPersonalSpace

  • è CrawlArchivedSpace

  • è CrawlArchivedPage

  • è CrawlPage

  • è CrawlBlog

  • è CrawlPageComment

  • è CrawlPageAttachment

  • è CrawlBlogComment

  • è CrawlBlogAttachment

trueper scansionare i file presenti negli spazi personali, nelle pagine, nei blog, nei commenti alle pagine, negli allegati di pagina, nei commenti e negli allegati del blog di Confluence.
massimo FileSizeInMegaBytes Specifica il limite di dimensione del file in MB che Amazon Kendra può essere scansionato. Amazon Kendra esegue la scansione solo dei file entro il limite di dimensione definito. La dimensione predefinita dei file è 50 MB. La dimensione massima dei file deve essere maggiore di 0 MB e inferiore o uguale a 50 MB.
tipo Il tipo di origine dati. Specifica CONFLUENCEV2 come tipo di origine dati.
abilita IdentityCrawler trueutilizzare il crawler Amazon Kendra di identità per sincronizzare identity/principal le informazioni su utenti e gruppi con accesso a determinati documenti. Se l'identity crawler è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretARN L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto che contiene le coppie chiave-valore necessarie per connettersi a Confluence. Per informazioni su queste coppie chiave-valore, consulta le istruzioni di connessione per Confluence. https://docs.aws.amazon.com/kendra/latest/dg/data-source-v2-confluence.html#data-source-procedure-v2-confluence
version La versione di questo modello attualmente supportata.
{ "$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" ] }

Schema del modello Dropbox

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Fornisci la chiave dell'app Dropbox, il segreto dell'app e il token di accesso come parte del segreto che memorizza le tue credenziali di autenticazione. Specifica anche il tipo di origine datiDROPBOX, il tipo di token di accesso che desideri utilizzare (temporaneo o permanente) e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando CreateDataSource chiami.

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Schema JSON di Dropbox.

La tabella seguente descrive i parametri dello schema JSON di Dropbox.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati. Questa fonte di dati non specifica un endpoint in. repositoryEndpointMetadata Piuttosto, le informazioni sulla connessione sono incluse in un AWS Secrets Manager segreto che forniscisecretArn.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
  • file

  • carta

  • cartaceo

  • scorciatoia

Un elenco di oggetti che associano gli attributi o i nomi dei campi dei tuoi file Dropbox, Dropbox Paper e le scorciatoie ai Amazon Kendra nomi dei campi di indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

abilita IdentityCrawler trueutilizzare il crawler Amazon Kendra di identità per sincronizzare identity/principal le informazioni su utenti e gruppi con accesso a determinati documenti. Se l'identity crawler è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi.
secretARN L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto che contiene le coppie chiave-valore necessarie per connettersi al tuo Dropbox. Il segreto deve contenere una struttura JSON con le seguenti chiavi:
{ "appKey": "Dropbox app key", "appSecret": "Dropbox app secret", "accesstoken": "temporary access token or refresh access token" }
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati.
è CrawlAcl trueper scansionare le informazioni dell'elenco di controllo degli accessi (ACL) dei tuoi documenti, se disponi di un ACL e desideri utilizzarlo per il controllo degli accessi. L'ACL specifica a quali documenti possono accedere utenti e gruppi. Le informazioni ACL vengono utilizzate per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo ai documenti. Per ulteriori informazioni, vedere Filtraggio del contesto utente.
  • inclusione FileNamePatterns

  • inclusione FileTypePatterns

Un elenco di modelli di espressioni regolari per includere determinati nomi e tipi di file nella tua origine dati Dropbox. I file che corrispondono ai modelli sono inclusi nell'indice. I file che non corrispondono ai modelli sono esclusi dall’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
  • esclusione FileNamePatterns

  • esclusione FileTypePatterns

Un elenco di modelli di espressioni regolari per escludere determinati nomi e tipi di file nella tua origine dati Dropbox. I file che corrispondono ai modelli sono esclusi dall’indice. I file che non corrispondono ai modelli sono inclusi nell’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
  • File di scansione

  • Carta di esplorazione

  • Crawl Paper T

  • Scelta rapida per Crawl

trueper eseguire la scansione dei file contenuti nei tuoi documenti Dropbox, Dropbox Paper, nei modelli di Dropbox Paper e nelle scorciatoie delle pagine web archiviate nel tuo Dropbox.
tipo Il tipo di origine dati. Specifica DROPBOX come tipo di origine dati.
Tipo di token Specifica il tipo di token di accesso: token di accesso permanente o temporaneo. Ti consigliamo di creare un token di accesso di aggiornamento che non scada mai in Dropbox anziché basarti su un token di accesso monouso che scade dopo 4 ore. Crei un'app e un token di accesso per l'aggiornamento nella Console per sviluppatori di Dropbox e fornisci il token di accesso in segreto.
version La versione di questo modello attualmente supportata.
{ "$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" ] }

Schema del modello Drupal

Includi un JSON che contiene lo schema dell'origine dati come parte dell'oggetto. TemplateConfiguration Fornisci l'URL dell'host Drupal e il tipo di autenticazione come parte della configurazione della connessione o dei dettagli dell'endpoint del repository. Specifica anche il tipo di origine dati come DRUPAL, un segreto per le tue credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come quando chiami. Type CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Schema JSON di Drupal.

La seguente tabella descrive i parametri dello schema JSON di Drupal.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati.
hostUrl L'URL host del tuo sito web Drupal. Ad esempio, https://<hostname>/<drupalsitename>.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati.
  • contenuto

  • comment

  • attachment

Un elenco di oggetti che mappano gli attributi o i nomi dei campi dei propri file Drupal. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati. I nomi dei campi dell’origine dati Drupal devono essere presenti nei metadati personalizzati di Drupal.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati.
  • inclusione FileNamePatterns

  • articolo TitleInclusionPatterns

  • pagina TitleInclusionPatterns

  • personalizzato ContentTitleInclusionPatterns

  • base BlockTitleInclusionPatterns

  • personalizzato BlockTitleInclusionPatterns

Un elenco di modelli di espressioni regolari per includere determinati file nell’origine dati Drupal. I file che corrispondono ai modelli sono inclusi nell'indice. I file che non corrispondono ai modelli sono esclusi dall’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
  • esclusione FileNamePatterns

  • articolo TitleExclusionPatterns

  • pagina TitleExclusionPatterns

  • personalizzato ContentTitleExclusionPatterns

  • base BlockTitleExclusionPatterns

  • personalizzato BlockTitleExclusionPatterns

Un elenco di modelli di espressioni regolari per escludere determinati file nell’origine dati Drupal. I file che corrispondono ai modelli sono esclusi dall’indice. I file che non corrispondono ai modelli sono inclusi nell’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
contentDefinitions
  • contentType

  • fieldDefinition

  • è CrawlComments

  • è CrawlFiles

  • è CrawlArticle

  • è CrawlBasicPage

  • è CrawlBasicBlock

  • è CrawlCustomContentTypesList

Specifica i tipi di contenuto su cui eseguire il crawling e se eseguirlo su commenti e allegati per i tipi di contenuto selezionati.
tipo Il tipo di origine dati. Specifica DRUPAL come tipo di origine dati.
authType Il tipo di autenticazione impiegato, se BASIC-AUTH o OAUTH2.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

abilita IdentityCrawler trueutilizzare il crawler Amazon Kendra di identità per sincronizzare identity/principal le informazioni su utenti e gruppi con accesso a determinati documenti. Se l'identity crawler è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi.
secretARN L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto che contiene le coppie chiave-valore necessarie per connettersi a Drupal. Il segreto deve contenere una struttura JSON con le seguenti chiavi:

In caso di utilizzo dell’autenticazione Base:

{ "username": "user name", "passwords": "password" }

In caso di utilizzo dell’autenticazione OAuth 2.0:

{ "username": "user name", "password": "password", "clientId": "client id", "clientSecret": "client secret" }
version La versione di questo modello attualmente supportata.
{ "$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 schema del modello

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Fornisci l'URL dell' GitHub host, il nome dell'organizzazione e se utilizzi il GitHub cloud o l' GitHub ambiente locale come parte della configurazione della connessione o dei dettagli dell'endpoint del repository. Specifica inoltre il tipo di origine datiGITHUB, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta GitHub Schema JSON.

La tabella seguente descrive i parametri dello schema GitHub JSON.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati.
tipo Specificare il tipo come SAAS oON_PREMISE.
hostUrl L'URL dell' GitHub host. Ad esempio, se utilizzi GitHub SaaS/Enterprise Cloud: https://api.github.com. Oppure, se usi GitHub premises/Enterprise on-Server: https://on-prem-host-url/api/v3/.
organizationName Puoi trovare il nome della tua organizzazione quando accedi al GitHub desktop e vai a Le tue organizzazioni nel menu a discesa con la tua immagine del profilo.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
  • GHRepository

  • GHCommit

  • gh IssueDocument

  • gh IssueComment

  • gh IssueAttachment

  • Documento GHPR

  • Commento GHPR

  • Allegato GHPR

Un elenco di oggetti che associano gli attributi o i nomi dei campi del GitHub contenuto ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati.
è CrawlAcl trueper scansionare le informazioni dell'elenco di controllo degli accessi (ACL) dei tuoi documenti, se disponi di un ACL e desideri utilizzarlo per il controllo degli accessi. L'ACL specifica a quali documenti possono accedere e cercare utenti e gruppi. Le informazioni ACL vengono utilizzate per filtrare i risultati della ricerca in base all'accesso dell'utente o del suo gruppo ai documenti. Per ulteriori informazioni, vedere Filtraggio del contesto utente.
campo ForUserId Specifica il tipo di ID utente che desideri utilizzare per la scansione degli ACL. Specifica email se desideri utilizzare l'email dell'utente per l'ID utente o username se desideri utilizzare il nome utente per l'ID utente. Se non specifichi un'opzione, email viene utilizzata per impostazione predefinita.
repositoryFilter Un elenco di nomi dei repository e dei nomi dei rami specifici che si desiderano indicizzare.
CrawlRepository trueper eseguire la scansione dei repository.
scansionare RepositoryDocuments trueper scansionare i documenti del repository.
Problema di scansione trueper analizzare i problemi.
gattonare IssueComment trueper scansionare i commenti relativi ai problemi.
scansionare IssueCommentAttachment trueper scansionare gli allegati dei commenti dei problemi.
scansionare PullRequest trueper scansionare le pull request.
gattonare PullRequestComment trueper scansionare i commenti delle pull request.
scansionare PullRequestCommentAttachment trueper scansionare gli allegati dei commenti delle pull request.
  • inclusione FolderNamePatterns

  • inclusione FileTypePatterns

  • inclusione FileNamePatterns

Un elenco di modelli di espressioni regolari per includere determinati contenuti nell'origine GitHub dati. I contenuti che corrispondono ai modelli sono inclusi nell’indice. I contenuti che non corrispondono ai modelli sono esclusi dall’indice. Se un contenuto corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il contenuto non viene incluso nell’indice.
  • esclusione FolderNamePatterns

  • esclusione FileTypePatterns

  • esclusione FileNamePatterns

Un elenco di modelli di espressioni regolari per escludere determinati contenuti nell'origine GitHub dati. I contenuti che corrispondono ai modelli sono esclusi dall’indice. I contenuti che non corrispondono ai modelli sono inclusi nell’indice. Se un contenuto corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il contenuto non viene incluso nell’indice.
tipo Il tipo di origine dati. Specifica GITHUB come tipo di origine dati.
abilitare IdentityCrawler trueutilizzare il crawler Amazon Kendra di identità per sincronizzare identity/principal le informazioni su utenti e gruppi con accesso a determinati documenti. Se l'identity crawler è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretArn

L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto che contiene le coppie chiave-valore necessarie per connettersi al tuo. GitHub Il segreto deve contenere una struttura JSON con le seguenti chiavi:

{ "personalToken": "token" }
version La versione di questo modello attualmente supportata.

Di seguito è riportato lo schema 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" ] }

Schema del modello Gmail

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Specifica il tipo di origine datiGMAIL, un segreto per le tue credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Schema JSON di Gmail.

La tabella seguente descrive i parametri dello schema JSON di Gmail.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati. Questa fonte di dati non specifica un endpoint in. repositoryEndpointMetadata Piuttosto, le informazioni sulla connessione sono incluse in un AWS Secrets Manager segreto che forniscisecretArn.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi. Specifica il tipo di origine dati e l’ARN del segreto.
  • message

  • attachments

Un elenco di oggetti che associano gli attributi o i nomi dei campi dei messaggi e degli allegati di Gmail ai nomi dei campi Amazon Kendra dell'indice. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati.
  • inclusione LabelNamePatterns

  • esclusione LabelNamePatterns

  • inclusione AttachmentTypePatterns

  • esclusione AttachmentTypePatterns

  • inclusione AttachmentNamePatterns

  • esclusione AttachmentNamePatterns

  • inclusione SubjectFilter

  • esclusione SubjectFilter

  • è SubjectAnd

  • inclusione FromFilter

  • esclusione FromFilter

  • inclusione ToFilter

  • esclusione ToFilter

  • inclusione CcFilter

  • esclusione CcFilter

  • inclusione BccFilter

  • esclusione BccFilter

Un elenco di modelli di espressioni regolari per includere o escludere messaggi con nomi di oggetto specifici nell'origine dati di Gmail. I file che corrispondono ai modelli sono inclusi nell'indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
prima DateFilter Specifica i messaggi e gli allegati da includere prima di una particolare data.
dopo DateFilter Specifica i messaggi e gli allegati da includere dopo una particolare data.
è CrawlAttachment Un valore booleano per scegliere se eseguire il crawling degli allegati dei messaggi. I messaggi vengono sottoposti a crawling in modo automatico.
tipo Il tipo di origine dati. Specifica GMAIL come tipo di origine dati.
dovrebbe CrawlDraftMessages Un valore booleano per scegliere se eseguire il crawling delle bozze di messaggi.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

Importante

Poiché non esiste un'API per aggiornare i messaggi Gmail eliminati definitivamente, qualsiasi sincronizzazione dei contenuti nuovi, modificati o eliminati:

  • Non rimuoverà dal tuo indice i messaggi eliminati definitivamente da Gmail Amazon Kendra

  • Non sincronizzerà le modifiche nelle etichette email di Gmail

Per sincronizzare le modifiche apportate alle etichette delle origini dati di Gmail e i messaggi email eliminati definitivamente con il tuo Amazon Kendra indice, devi eseguire periodicamente delle scansioni complete.

secretARN L'Amazon Resource Name (ARN) di un segreto di Secrets Manager che contiene le coppie chiave-valore necessarie per connettersi a Gmail. Il segreto deve contenere una struttura JSON con le seguenti chiavi:
{ "adminAccountEmailId": "service account email", "clientEmailId": "user account email", "privateKey": "private key" }
version La versione del modello attualmente supportata.
{ "$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" ] }

Schema del modello di Google Drive

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Specifica il tipo di origine datiGOOGLEDRIVE2, un segreto per le tue credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Schema JSON di Google Drive.

La tabella seguente descrive i parametri dello schema JSON di Google Drive.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’origine dati esterna.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati. Questa fonte di dati non specifica un endpoint. Scegli il tipo di autenticazione: serviceAccount e OAuth2. Le informazioni sulla connessione sono incluse in un AWS Secrets Manager segreto fornito dall'secretArnutente.
authType Scegli tra serviceAccount e OAuth2 in base al tuo caso d'uso.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
  • file

  • comment

Un elenco di oggetti che associano gli attributi o i nomi dei campi di Google Drive ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati
  • max FileSizeInMegaBytes

Specifica un limite di dimensione del file in MB che Amazon Kendra deve essere scansionato.
  • È un commento Crawl

trueper eseguire la scansione dei commenti nell'origine dati di Google Drive.
  • è CrawlMyDriveAndSharedWithMe

trueper eseguire la scansione MyDrive e condividere con me Drives nell'origine dati di Google Drive.
  • è CrawlSharedDrives

trueper eseguire la scansione di Shared Drives nell'origine dati di Google Drive.
è CrawlAcl trueper scansionare le informazioni dell'elenco di controllo degli accessi (ACL) dei tuoi documenti, se disponi di un ACL e desideri utilizzarlo per il controllo degli accessi. L'ACL specifica a quali documenti possono accedere e cercare utenti e gruppi. Le informazioni ACL vengono utilizzate per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo ai documenti. Per ulteriori informazioni, vedere Filtraggio del contesto utente.
  • escludere UserAccounts

  • escludere SharedDrives

  • escludere MimeTypes

  • esclusione FileTypePatterns

  • esclusione FileNamePatterns

  • esclusione FilePathFilter

Un elenco di modelli di espressioni regolari per escludere determinati file nell'origine dati di Google Drive. I file che corrispondono ai modelli sono esclusi dall’indice. I file che non corrispondono ai modelli sono inclusi nell’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
  • includere UserAccounts

  • includere SharedDrives

  • includere MimeTypes

  • inclusione FileTypePatterns

  • inclusione FileNamePatterns

  • inclusione FilePathFilter

Un elenco di modelli di espressioni regolari per includere determinati file nell'origine dati di Google Drive. I file che corrispondono ai modelli sono inclusi nell'indice. I file che non corrispondono ai modelli sono esclusi dall’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
tipo Il tipo di origine dati. Specifica GOOOGLEDRIVEV2 come tipo di origine dati.
abilitare IdentityCrawler trueutilizzare il crawler Amazon Kendra di identità per sincronizzare identity/principal le informazioni su utenti e gruppi con accesso a determinati documenti. Se l'identity crawler è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretARN L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto che contiene le coppie chiave-valore necessarie per connettersi a Google Drive. Il segreto deve contenere una struttura JSON con le seguenti chiavi:

Se si utilizza l'autenticazione dell'account di servizio Google:

{ "clientEmail": "user account email", "adminAccountEmail": "service account email", "privateKey": "private key" }

Se si utilizza l'autenticazione OAuth 2.0:

{ "clientID": "OAuth client ID", "clientSecret": "client secret", "refreshToken": "refresh token" }
version La versione di questo modello attualmente supportata.
{ "$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" ] }

Schema del modello IBM DB2

Includi un JSON che contiene lo schema dell'origine dati come parte dell'oggetto. TemplateConfiguration Specifica il tipo di origine datiJDBC, il tipo di databasedb2, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Schema JSON IBM DB2.

La tabella seguente descrive i parametri dello schema JSON IBM DB2.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Informazioni di configurazione necessarie per la connessione dell’origine dati.
  • DBTYPE: il tipo di database Java utilizzato, se,, mysqldb2, postgresql o. oracle sqlserver

  • dbHost: il nome dell’host del database.

  • dbPort: la porta del database.

  • dbInstance: l’istanza database.

repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi. Specifica il tipo di origine dati e l’ARN del segreto.

documento

Un elenco di oggetti che associano gli attributi o i nomi dei campi del contenuto del database ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati. Da utilizzare per includere o escludere contenuti specifici nell’origine dati del database.
primaryKey Immetti la chiave primaria per la tabella del database. Questo valore identifica una tabella all’interno del database.
titleColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
bodyColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
sqlQuery Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono pesare meno di 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
timestampColumn Inserisci il nome della colonna che contiene i timestamp. Amazon Kendra utilizza le informazioni relative all'ora per rilevare le modifiche nei contenuti e sincronizzare solo i contenuti modificati.
timestampFormat Immetti il nome della colonna che contiene i formati dei timestamp da utilizzare per rilevare le modifiche ai contenuti e risincronizzare i contenuti.
timezone Immetti il nome della colonna che contiene i fusi orari per il contenuto di cui eseguire il crawling.
modifica DetectingColumns Inserisci i nomi delle colonne che Amazon Kendra verranno utilizzate per rilevare le modifiche al contenuto. Amazon Kendra reindicizzerà il contenuto in caso di modifica in una di queste colonne
consentito UsersColumns Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
consentito GroupsColumn Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
sourceURIColumn Immetti il nome della colonna che contiene gli URL di origine da indicizzare.
è SslEnabled Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono essere inferiori a 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
tipo Il tipo di origine dati. Specifica JDBC come tipo di origine dati.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretArn Il nome della risorsa Amazon (ARN) di un segreto di Secrets Manager contenente il nome utente e la password necessari per connettersi al database. Il segreto deve contenere una struttura JSON con le seguenti chiavi:
{ "user name": "database user name", "password": "password" }
version La versione del modello attualmente supportata.
{ "$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" ] }

Schema del modello di Microsoft Exchange

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. L'ID del tenant viene fornito come parte della configurazione della connessione o dei dettagli dell'endpoint del repository. Specifica inoltre il tipo di origine datiMSEXCHANGE, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Schema JSON di Microsoft Exchange.

La tabella seguente descrive i parametri dello schema JSON di Microsoft Exchange.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati.
ID inquilino L’ID del tenant Microsoft 365. Puoi trovare il tuo ID tenant nelle proprietà del tuo portale di Azure Active Directory o nella tua applicazione OAuth.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
  • e-mail

  • attachment

  • calendario

  • contatti

  • notes

Un elenco di oggetti che associano gli attributi o i nomi dei campi dell'origine dati di Microsoft Exchange ai campi di Amazon Kendra indice. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per il contenuto dell’origine dati
Schemi di inclusione Un elenco di modelli di espressioni regolari per includere determinati file nell'origine dati di Microsoft Exchange. I file che corrispondono ai modelli sono inclusi nell'indice. I file che non corrispondono ai modelli sono esclusi dall’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
Modelli di esclusione Un elenco di modelli di espressioni regolari per escludere determinati file nell'origine dati di Microsoft Exchange. I file che corrispondono ai modelli sono esclusi dall’indice. I file che non corrispondono ai modelli sono inclusi nell’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
  • inclusione UsersList

  • inclusione UsersFileName

  • inclusione DomainUsers

Un elenco di modelli di espressioni regolari per includere determinati utenti e file utente nell'origine dati di Microsoft Exchange. Gli utenti che corrispondono ai modelli vengono inclusi nell'indice. Gli utenti che non corrispondono ai modelli vengono esclusi dall'indice. Se un utente corrisponde sia a un modello di inclusione che a uno di esclusione, il modello di esclusione ha la precedenza e l'utente non viene incluso nell'indice.
  • esclusione UsersList

  • esclusione UsersFileName

  • esclusione DomainUsers

Un elenco di modelli di espressioni regolari per escludere determinati utenti e file utente nell'origine dati di Microsoft Exchange. Gli utenti che corrispondono ai modelli vengono esclusi dall'indice. Gli utenti che non corrispondono ai modelli vengono inclusi nell'indice. Se un utente corrisponde sia a un modello di esclusione che a uno di inclusione, il modello di esclusione ha la precedenza e l'utente non viene incluso nell'indice.
S3bucketName Il nome del bucket S3, se lo desideri utilizzare.
  • CrawlCalendar

  • Crawl Notes

  • Contatti Crawl

  • gattonare FolderAcl

trueper eseguire la scansione di questi tipi di contenuti e accedere alle informazioni di controllo dell'origine dati di Microsoft Exchange.
iniziare CalendarDateTime Puoi configurare una data-ora di inizio specifica per il contenuto del tuo calendario.
fine CalendarDateTime È possibile configurare una data-ora di fine specifica per il contenuto del calendario.
subject È possibile configurare una riga dell'oggetto specifica per il contenuto della posta.
Invia un'email da Puoi configurare un'email specifica per il contenuto della posta «Da» o del mittente.
Invia un'email a È possibile configurare un'email specifica per il contenuto della posta «A» o per il destinatario.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

tipo Il tipo di origine dati. Specifica MSEXCHANGE come tipo di origine dati.
secretARN L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto che contiene le coppie chiave-valore necessarie per connettersi a Microsoft Exchange. Ciò include il tuo ID cliente e il tuo segreto cliente che viene generato quando crei un'applicazione OAuth nel portale di Azure.
version La versione di questo modello attualmente supportata.
{ "$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" ] }

Schema del OneDrive modello Microsoft

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Fornisci l'ID del tenant come parte della configurazione della connessione o dei dettagli dell'endpoint del repository. Specifica inoltre il tipo di origine dati e un segreto per le credenziali di autenticazione e altre configurazioni necessarie. ONEDRIVEV2 Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Schema Microsoft JSON OneDrive.

La tabella seguente descrive i parametri dello schema Microsoft OneDrive JSON.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati.
ID inquilino L’ID del tenant Microsoft 365. Puoi trovare il tuo ID tenant nelle proprietà del tuo portale di Azure Active Directory o nella tua applicazione OAuth.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
file Un elenco di oggetti che associano gli attributi o i nomi dei campi dei OneDrive file Microsoft ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati
  • utente NameFilter

  • utente FilterPath

  • inclusione FileTypePatterns

  • esclusione FileTypePatterns

  • inclusione FileNamePatterns

  • esclusione FileNamePatterns

  • inclusione FilePathPatterns

  • esclusione FilePathPatterns

  • inclusione OneNoteSectionNamePatterns

  • esclusione OneNoteSectionNamePatterns

  • inclusione OneNotePageNamePatterns

  • esclusione OneNotepageNamePatterns

Puoi scegliere di indicizzare file, OneNote sezioni, OneNote pagine specifici e filtrare in base al nome utente.
è UserNameOnS3 true per fornire un elenco di nomi utente in un file archiviato in un Amazon S3.
tipo Il tipo di origine dati. Specifica ONEDRIVEV2 come tipo di origine dati.
abilitare IdentityCrawler trueutilizzare il crawler Amazon Kendra di identità per sincronizzare identity/principal le informazioni su utenti e gruppi con accesso a determinati documenti. Se l'identity crawler è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi.
tipo Il tipo di origine dati. Specifica ONEDRIVEV2 come tipo di origine dati.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretARN L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto che contiene le coppie chiave-valore necessarie per connettersi a Microsoft. OneDrive Il segreto deve contenere una struttura JSON con le seguenti chiavi:
{ "clientId": "client ID", "clientSecret": "client secret" }
version La versione di questo modello attualmente supportata.
{ "$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" ] }

Schema del SharePoint modello Microsoft

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Fornisci il SharePoint sito URL/URLs, il dominio e anche un ID tenant, se richiesto come parte della configurazione della connessione o dei dettagli dell'endpoint del repository. Specifica inoltre il tipo di origine datiSHAREPOINTV2, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi lo specifichi TEMPLATE come Tipo quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta SharePoint Schema JSON.

La tabella seguente descrive i parametri dello schema Microsoft SharePoint JSON.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l'endpoint dell'origine dati
repository EndpointMetadata Le informazioni sull'endpoint per l'origine dati
ID tenant L'ID del tenant del tuo account. SharePoint
domain Il dominio del tuo SharePoint account.
URL del sito Gli URL host del tuo account. SharePoint
repository AdditionalProperties Proprietà aggiuntive per connettersi all'endpoint di repository/data origine.
Nome del bucket S3 Il nome del Amazon S3 bucket in cui è archiviato il certificato autofirmato di Azure AD. X.509
Nome del certificato S3 Il nome del certificato X.509 autofirmato di Azure AD archiviato nel bucket. Amazon S3
authType Il tipo di autenticazione che usi, se,OAuth2,,OAuth2Certificate, OAuth2App BasicOAuth2_RefreshToken, NTLM o. Kerberos
version La SharePoint versione che usi, indipendentemente dal fatto che Server oOnline.
su PremVersion La versione SharePoint del server che utilizzi, indipendentemente dal fatto che 2013 oSubscriptionEdition.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
  • evento

  • page

  • file

  • link

  • attachment

  • comment

Un elenco di oggetti che associano gli attributi o i nomi dei campi del SharePoint contenuto ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati.
  • evento TitleFilterRegEx

  • pagina TitleFilterRegEx

  • link TitleFilterRegEx

  • inclusione FilePath

  • esclusione FilePath

  • inclusione FileTypePatterns

  • esclusione FileTypePatterns

  • inclusione FileNamePatterns

  • esclusione FileNamePatterns

  • inclusione OneNoteSectionNamePatterns

  • esclusione OneNoteSectionNamePatterns

  • inclusione OneNotePageNamePatterns

  • esclusione OneNotePageNamePatterns

Un elenco di modelli di espressioni regolari per include/exclude determinati contenuti nell'origine SharePoint dati. Gli elementi di contenuto che corrispondono ai modelli di inclusione sono inclusi nell'indice. Gli elementi di contenuto che non corrispondono ai modelli di inclusione vengono esclusi dall'indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
  • File di esplorazione

  • Esplora pagine

  • CrawEvents

  • Commenti Crawl

  • Collegamenti di scansione

  • Allegati CrawLat

trueper scansionare questi tipi di contenuti.
CrawLACL trueper scansionare le informazioni dell'elenco di controllo degli accessi (ACL) dei tuoi documenti, se disponi di un ACL e desideri utilizzarlo per il controllo degli accessi. L'ACL specifica a quali documenti possono accedere e cercare utenti e gruppi. Le informazioni ACL vengono utilizzate per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo ai documenti. Per ulteriori informazioni, vedere Filtraggio del contesto utente.
campo ForUserId Specifica email se desideri utilizzare l'email dell'utente per l'ID utente o userPrincipalName se desideri utilizzare un nome utente per l'ID utente. Se non specifichi un'opzione, email viene utilizzata per impostazione predefinita.
Configurazione ACL Specificare o ACLWithLDAPEmailFmtACLWithManualEmailFmt, o. ACLWithUsernameFmtM
Dominio di posta elettronica Il dominio dell'email. Ad esempio, "amazon.com".
  • è CrawlLocalGroupMapping

  • è CrawlAdGroupMapping

trueper scansionare le informazioni sulla mappatura dei gruppi.
ProxyHost Il nome host del proxy web utilizzato, senza il protocollo http://o https://.
ProxyPort Il numero di porta utilizzato dal protocollo di trasporto degli URL dell'host. Deve essere un valore numerico compreso tra 0 e 65535.
tipo Specifica SHAREPOINTV2 come tipo di origine dati.
abilitare IdentityCrawler trueutilizzare il crawler Amazon Kendra di identità per sincronizzare identity/principal le informazioni su utenti e gruppi con accesso a determinati documenti. Se l'identity crawler è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretARN L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto che contiene le coppie chiave-valore necessarie per connettersi al tuo. SharePoint Per informazioni su queste coppie chiave-valore, consulta le istruzioni di connessione per Online e Server. SharePoint SharePoint
version La versione di questo modello attualmente supportata.
{ "$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", "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" ] }

Schema del modello di Microsoft SQL Server

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Specifica il tipo di origine datiJDBC, il tipo di databasesqlserver, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Schema JSON di Microsoft SQL Server.

La tabella seguente descrive i parametri dello schema JSON di Microsoft SQL Server.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Informazioni di configurazione necessarie per la connessione dell’origine dati.
  • DBTYPE: il tipo di database Java utilizzato, se,, mysqldb2, postgresql o. oracle sqlserver

  • dbHost: il nome dell’host del database.

  • dbPort: la porta del database.

  • dbInstance: l’istanza database.

repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi. Specifica il tipo di origine dati e l’ARN del segreto.

documento

Un elenco di oggetti che associano gli attributi o i nomi dei campi del contenuto del database ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati. Da utilizzare per includere o escludere contenuti specifici nell’origine dati del database.
primaryKey Immetti la chiave primaria per la tabella del database. Questo valore identifica una tabella all’interno del database.
titleColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
bodyColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
sqlQuery Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono pesare meno di 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
timestampColumn Inserisci il nome della colonna che contiene i timestamp. Amazon Kendra utilizza le informazioni relative all'ora per rilevare le modifiche nei contenuti e sincronizzare solo i contenuti modificati.
timestampFormat Immetti il nome della colonna che contiene i formati dei timestamp da utilizzare per rilevare le modifiche ai contenuti e risincronizzare i contenuti.
timezone Immetti il nome della colonna che contiene i fusi orari per il contenuto di cui eseguire il crawling.
modifica DetectingColumns Inserisci i nomi delle colonne che Amazon Kendra verranno utilizzate per rilevare le modifiche al contenuto. Amazon Kendra reindicizzerà il contenuto in caso di modifica in una di queste colonne
consentito UsersColumns Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
consentito GroupsColumn Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
sourceURIColumn Immetti il nome della colonna che contiene gli URL di origine da indicizzare.
è SslEnabled Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono essere inferiori a 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
tipo Il tipo di origine dati. Specifica JDBC come tipo di origine dati.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretArn Il nome della risorsa Amazon (ARN) di un segreto di Secrets Manager contenente il nome utente e la password necessari per connettersi al database. Il segreto deve contenere una struttura JSON con le seguenti chiavi:
{ "user name": "database user name", "password": "password" }
version La versione del modello attualmente supportata.
{ "$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" ] }

Schema del modello Microsoft Teams

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Fornisci l'ID del tenant come parte della configurazione della connessione o dei dettagli dell'endpoint del repository. Specifica inoltre il tipo di origine datiMSTEAMS, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Schema JSON di Microsoft Teams.

La tabella seguente descrive i parametri dello schema JSON di Microsoft Teams.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati.
ID inquilino L’ID del tenant Microsoft 365. Puoi trovare il tuo ID tenant nelle proprietà del tuo portale di Azure Active Directory o nella tua applicazione OAuth.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
  • Messaggio di chat

  • Allegato alla chat

  • Post sul canale

  • Channel Wiki

  • Allegato al canale

  • Chat di riunione

  • File della riunione

  • Nota sulla riunione

  • Riunione del calendario

Un elenco di oggetti che associano gli attributi o i nomi dei campi del contenuto di Microsoft Teams ai nomi dei campi Amazon Kendra indicizzati. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati.
Modello di pagamento Specifica il tipo di modello di pagamento da utilizzare con l'origine dati Microsoft Teams. I modelli di pagamento A sono limitati ai modelli di licenza e pagamento che richiedono la conformità alla sicurezza. I modelli di pagamento B sono adatti per modelli di licenza e pagamento che non richiedono conformità alla sicurezza.
  • inclusione TeamNameFilter

  • inclusione ChannelNameFilter

  • inclusione FileNamePatterns

  • inclusione FileTypePatterns

  • inclusione UserEmailFilter

  • inclusione OneNoteSectionNamePatterns

  • inclusione OneNotePageNamePatterns

Un elenco di modelli di espressioni regolari per includere determinati contenuti nell'origine dati di Microsoft Teams. I contenuti che corrispondono ai modelli sono inclusi nell’indice. I contenuti che non corrispondono ai modelli sono esclusi dall’indice. Se un contenuto corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il contenuto non viene incluso nell’indice.
  • esclusione TeamNameFilter

  • esclusione ChannelNameFilter

  • esclusione FileNamePatterns

  • esclusione FileTypePatterns

  • esclusione UserEmailFilter

  • esclusione OneNoteSectionNamePatterns

  • esclusione OneNotePageNamePatterns

Un elenco di modelli di espressioni regolari per escludere determinati contenuti nell'origine dati di Microsoft Teams. I contenuti che corrispondono ai modelli sono esclusi dall’indice. I contenuti che non corrispondono ai modelli sono inclusi nell’indice. Se un contenuto corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il contenuto non viene incluso nell’indice.
  • è CrawlChatMessage

  • è CrawlChatAttachment

  • è CrawlChannelPost

  • è CrawlChannelAttachment

  • è CrawlChannelWiki

  • è CrawlCalendarMeeting

  • è CrawlMeetingChat

  • è CrawlMeetingFile

  • è CrawlMeetingNote

trueper eseguire la scansione di questi tipi di contenuti nell'origine dati Microsoft Teams.
inizia CalendarDateTime Puoi configurare una data-ora di inizio specifica per il contenuto del tuo calendario.
fine CalendarDateTime È possibile configurare una data-ora di fine specifica per il contenuto del calendario.
tipo Il tipo di origine dati. Specifica MSTEAMS come tipo di origine dati.
abilitare IdentityCrawler trueutilizzare il crawler Amazon Kendra di identità per sincronizzare identity/principal le informazioni su utenti e gruppi con accesso a determinati documenti. Se l'identity crawler è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretArn L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto che contiene le coppie chiave-valore necessarie per connettersi a Microsoft Teams. Ciò include l'ID cliente e il segreto del cliente che vengono generati quando crei un'applicazione OAuth nel portale di Azure.
version La versione di questo modello attualmente supportata.
{ "$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" ] }

Schema del modello Microsoft Yammer

Includi un JSON che contiene lo schema dell'origine dati come parte dell'oggetto. TemplateConfiguration Specifica il tipo di origine datiYAMMER, un segreto per le tue credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Tipo quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori.

La tabella seguente descrive i parametri dello schema JSON di Microsoft Yammer.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’origine dati esterna.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati. Questa fonte di dati non specifica un endpoint in. repositoryEndpointMetadata Piuttosto, le informazioni sulla connessione sono incluse in un AWS Secrets Manager segreto che forniscisecretArn.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
  • comunità

  • user

  • message

  • attachment

Un elenco di oggetti che associano gli attributi o i nomi dei campi del contenuto di Microsoft Yammer ai nomi dei campi dell'indice di Amazon Kendra. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati
Modelli di inclusione Un elenco di modelli di espressioni regolari per includere determinati file nell'origine dati Microsoft Yammer. I file che corrispondono ai modelli sono inclusi nell'indice. I file che non corrispondono ai modelli sono esclusi dall’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
Schemi di esclusione Un elenco di modelli di espressioni regolari per escludere determinati file nell'origine dati Microsoft Yammer. I file che corrispondono ai modelli sono esclusi dall’indice. I file che non corrispondono ai modelli sono inclusi nell’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
Data dalla data È possibile scegliere di configurare un sinceDate parametro in modo che il connettore Microsoft Yammer esegua la scansione del contenuto in base a uno specifico. sinceDate
comunità NameFilter Puoi scegliere di indicizzare contenuti specifici della community.
  • è CrawlMessage

  • è CrawlAttachment

  • è CrawlPrivateMessage

trueper scansionare messaggi, allegati e messaggi privati.
tipo Specifica YAMMER come tipo di origine dati.
secretARN L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto che contiene le coppie chiave-valore necessarie per connettersi a Microsoft Yammer. Ciò include il nome utente e la password di Microsoft Yammer, l'ID e il segreto client generati quando crei un'applicazione OAuth nel portale di Azure.
usa ChangeLog trueper utilizzare il registro delle modifiche di Microsoft Yammer per determinare quali documenti devono essere aggiornati nell'indice.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

abilita IdentityCrawler trueutilizzare il crawler Amazon Kendra di identità per sincronizzare identity/principal le informazioni su utenti e gruppi con accesso a determinati documenti. Se l'identity crawler è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi.
{ "$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" ] }

Schema del modello MySQL

Includi un JSON che contiene lo schema dell'origine dati come parte dell'oggetto. TemplateConfiguration Specifica il tipo di origine datiJDBC, il tipo di databasemysql, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Schema MySQL JSON.

La tabella seguente descrive i parametri dello schema MySQL JSON.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Informazioni di configurazione necessarie per la connessione dell’origine dati.
  • DBTYPE: il tipo di database Java utilizzato, se,, mysqldb2, postgresql o. oracle sqlserver

  • dbHost: il nome dell’host del database.

  • dbPort: la porta del database.

  • dbInstance: l’istanza database.

repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi. Specifica il tipo di origine dati e l’ARN del segreto.

documento

Un elenco di oggetti che associano gli attributi o i nomi dei campi del contenuto del database ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati. Da utilizzare per includere o escludere contenuti specifici nell’origine dati del database.
primaryKey Immetti la chiave primaria per la tabella del database. Questo valore identifica una tabella all’interno del database.
titleColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
bodyColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
sqlQuery Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono pesare meno di 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
timestampColumn Inserisci il nome della colonna che contiene i timestamp. Amazon Kendra utilizza le informazioni relative all'ora per rilevare le modifiche nei contenuti e sincronizzare solo i contenuti modificati.
timestampFormat Immetti il nome della colonna che contiene i formati dei timestamp da utilizzare per rilevare le modifiche ai contenuti e risincronizzare i contenuti.
timezone Immetti il nome della colonna che contiene i fusi orari per il contenuto di cui eseguire il crawling.
modifica DetectingColumns Inserisci i nomi delle colonne che Amazon Kendra verranno utilizzate per rilevare le modifiche al contenuto. Amazon Kendra reindicizzerà il contenuto in caso di modifica in una di queste colonne
consentito UsersColumns Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
consentito GroupsColumn Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
sourceURIColumn Immetti il nome della colonna che contiene gli URL di origine da indicizzare.
è SslEnabled Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono essere inferiori a 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
tipo Il tipo di origine dati. Specifica JDBC come tipo di origine dati.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretArn Il nome della risorsa Amazon (ARN) di un segreto di Secrets Manager contenente il nome utente e la password necessari per connettersi al database. Il segreto deve contenere una struttura JSON con le seguenti chiavi:
{ "user name": "database user name", "password": "password" }
version La versione del modello attualmente supportata.
{ "$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" ] }

Schema del modello di database Oracle

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Specifica il tipo di origine datiJDBC, il tipo di databaseoracle, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Schema JSON del database Oracle.

La tabella seguente descrive i parametri dello schema JSON di Oracle Database.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Informazioni di configurazione necessarie per la connessione dell’origine dati.
  • DBTYPE: il tipo di database Java utilizzato, se,, mysqldb2, postgresql o. oracle sqlserver

  • dbHost: il nome dell’host del database.

  • dbPort: la porta del database.

  • dbInstance: l’istanza database.

repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi. Specifica il tipo di origine dati e l’ARN del segreto.

documento

Un elenco di oggetti che associano gli attributi o i nomi dei campi del contenuto del database ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati. Da utilizzare per includere o escludere contenuti specifici nell’origine dati del database.
primaryKey Immetti la chiave primaria per la tabella del database. Questo valore identifica una tabella all’interno del database.
titleColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
bodyColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
sqlQuery Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono pesare meno di 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
timestampColumn Inserisci il nome della colonna che contiene i timestamp. Amazon Kendra utilizza le informazioni relative all'ora per rilevare le modifiche nei contenuti e sincronizzare solo i contenuti modificati.
timestampFormat Immetti il nome della colonna che contiene i formati dei timestamp da utilizzare per rilevare le modifiche ai contenuti e risincronizzare i contenuti.
timezone Immetti il nome della colonna che contiene i fusi orari per il contenuto di cui eseguire il crawling.
modifica DetectingColumns Inserisci i nomi delle colonne che Amazon Kendra verranno utilizzate per rilevare le modifiche al contenuto. Amazon Kendra reindicizzerà il contenuto in caso di modifica in una di queste colonne
consentito UsersColumns Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
consentito GroupsColumn Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
sourceURIColumn Immetti il nome della colonna che contiene gli URL di origine da indicizzare.
è SslEnabled Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono essere inferiori a 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
tipo Il tipo di origine dati. Specifica JDBC come tipo di origine dati.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretArn Il nome della risorsa Amazon (ARN) di un segreto di Secrets Manager contenente il nome utente e la password necessari per connettersi al database. Il segreto deve contenere una struttura JSON con le seguenti chiavi:
{ "user name": "database user name", "password": "password" }
version La versione del modello attualmente supportata.
{ "$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" ] }

Schema del modello PostgreSQL

Includi un JSON che contiene lo schema dell'origine dati come parte dell'oggetto. TemplateConfiguration Specifica il tipo di origine datiJDBC, il tipo di databasepostgresql, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Schema JSON PostgreSQL.

La tabella seguente descrive i parametri dello schema JSON di PostgreSQL.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Informazioni di configurazione necessarie per la connessione dell’origine dati.
  • DBTYPE: il tipo di database Java utilizzato, se,, mysqldb2, postgresql o. oracle sqlserver

  • dbHost: il nome dell’host del database.

  • dbPort: la porta del database.

  • dbInstance: l’istanza database.

repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi. Specifica il tipo di origine dati e l’ARN del segreto.

documento

Un elenco di oggetti che associano gli attributi o i nomi dei campi del contenuto del database ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati. Da utilizzare per includere o escludere contenuti specifici nell’origine dati del database.
primaryKey Immetti la chiave primaria per la tabella del database. Questo valore identifica una tabella all’interno del database.
titleColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
bodyColumn Immetti il nome della colonna del titolo del documento all’interno della tabella del database.
sqlQuery Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono pesare meno di 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
timestampColumn Inserisci il nome della colonna che contiene i timestamp. Amazon Kendra utilizza le informazioni relative all'ora per rilevare le modifiche nei contenuti e sincronizzare solo i contenuti modificati.
timestampFormat Immetti il nome della colonna che contiene i formati dei timestamp da utilizzare per rilevare le modifiche ai contenuti e risincronizzare i contenuti.
timezone Immetti il nome della colonna che contiene i fusi orari per il contenuto di cui eseguire il crawling.
modifica DetectingColumns Inserisci i nomi delle colonne che Amazon Kendra verranno utilizzate per rilevare le modifiche al contenuto. Amazon Kendra reindicizzerà il contenuto in caso di modifica in una di queste colonne
consentito UsersColumns Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
consentito GroupsColumn Immetti il nome della colonna che contiene gli ID utente a cui consentire l’accesso ai contenuti.
sourceURIColumn Immetti il nome della colonna che contiene gli URL di origine da indicizzare.
è SslEnabled Immetti le istruzioni per query SQL come le operazioni SELECT e JOIN. Le query SQL devono essere inferiori a 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
tipo Il tipo di origine dati. Specifica JDBC come tipo di origine dati.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretArn Il nome della risorsa Amazon (ARN) di un segreto di Secrets Manager contenente il nome utente e la password necessari per connettersi al database. Il segreto deve contenere una struttura JSON con le seguenti chiavi:
{ "user name": "database user name", "password": "password" }
version La versione del modello attualmente supportata.
{ "$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" ] }

Schema del modello Salesforce

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Fornisci l'URL dell'host di Salesforce come parte della configurazione della connessione o dei dettagli dell'endpoint del repository. Specifica anche il tipo di origine datiSALESFORCEV2, un segreto per le tue credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Schema JSON di Salesforce.

La tabella seguente descrive i parametri dello schema JSON di Salesforce.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati.
hostUrl L'URL dell'istanza di Salesforce da indicizzare.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
  • account

  • contact

  • campaign

  • caso

  • product

  • lead

  • contract

  • compagno

  • profile

  • idea

  • listino prezzi

  • task

  • soluzione

  • attachment

  • user

  • documento

  • articoli di conoscenza

  • gruppo

  • opportunity

  • cicaleccio

  • Entità personalizzata

Un elenco di oggetti che associano gli attributi o i nomi dei campi delle entità Salesforce ai nomi dei campi Amazon Kendra indicizzati. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
secretARN L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto che contiene le coppie chiave-valore necessarie per connettersi a Salesforce. Il segreto deve contenere una struttura JSON con le seguenti chiavi:

Per Client Credentials Flow:

{ "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" }

Per Username-Password Flow:

{ "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 Opzioni di configurazione aggiuntive per i contenuti dell’origine dati
  • Filtro dell'account

  • Filtro di contatto

  • Filtro CASE

  • Filtro campagna

  • Filtro contrattuale

  • Filtro di gruppo

  • Filtro Lead

  • Filtro del prodotto

  • Filtro opportunità

  • Filtro per i partner

  • Filtro PriceBook

  • Filtro Idea

  • Filtro di profilo

  • Filtro attività

  • Filtro della soluzione

  • Filtro utente

  • Filtro Chatter

  • Filtro per documenti

  • conoscenza ArticleFilter

  • Entità personalizzate

Una raccolta di stringhe che specifica quali entità filtrare.

Schemi di inclusione

  • inclusione DocumentFileTypePatterns

  • inclusione DocumentFileNamePatterns

  • inclusione AccountFileTypePatterns

  • inclusione CampaignFileTypePatterns

  • inclusione DocumentFileNamePatterns

  • inclusione CampaignFileNamePatterns

  • inclusione CaseFileTypePatterns

  • inclusione CaseFileNamePatterns

  • inclusione ContactFileTypePatterns

  • inclusione ContractFileNamePatterns

  • inclusione LeadFileTypePatterns

  • inclusione LeadFileNamePatterns

  • inclusione OpportunityFileTypePatterns

  • inclusione OpportunityFileNamePatterns

  • inclusione SolutionFileTypePatterns

  • inclusione SolutionFileNamePatterns

  • inclusione TaskFileTypePatterns

  • inclusione TaskFileNamePatterns

  • inclusione GroupFileTypePatterns

  • inclusione GroupFileNamePatterns

  • inclusione ChatterFileTypePatterns

  • inclusione ChatterFileNamePatterns

  • inclusione CustomEntityFileTypePatterns

  • inclusione CustomEntityFileNamePatterns

Un elenco di modelli di espressioni regolari per includere determinati file nell'origine dati Salesforce. I file che corrispondono ai modelli sono inclusi nell'indice. I file che non corrispondono ai modelli sono esclusi dall’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.

Modelli di esclusione

  • esclusione DocumentFileTypePatterns

  • esclusione DocumentFileNamePatterns

  • esclusione AccountFileTypePatterns

  • esclusione CampaignFileTypePatterns

  • esclusione CampaignFileNamePatterns

  • esclusione CaseFileTypePatterns

  • esclusione CaseFileNamePatterns

  • esclusione ContactFileTypePatterns

  • esclusione ContractFileNamePatterns

  • esclusione LeadFileTypePatterns

  • esclusione LeadFileNamePatterns

  • esclusione OpportunityFileTypePatterns

  • esclusione OpportunityFileNamePatterns

  • esclusione SolutionFileTypePatterns

  • esclusione SolutionFileNamePatterns

  • esclusione TaskFileTypePatterns

  • esclusione TaskFileNamePatterns

  • esclusione GroupFileTypePatterns

  • esclusione GroupFileNamePatterns

  • esclusione ChatterFileTypePatterns

  • esclusione ChatterFileNamePatterns

  • esclusione CustomEntityFileTypePatterns

  • esclusione CustomEntityFileNamePatterns

Un elenco di modelli di espressioni regolari per escludere determinati file nell'origine dati Salesforce. I file che corrispondono ai modelli sono esclusi dall’indice. I file che non corrispondono ai modelli sono inclusi nell’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
  • è CrawlAccount

  • è CrawlContact

  • è CrawlCase

  • è CrawlCampaign

  • è CrawlProduct

  • è CrawlLead

  • è CrawlContract

  • è CrawlPartner

  • è CrawlProfile

  • è CrawlIdea

  • è CrawlPricebook

  • è CrawlDocument

  • gattonare SharedDocument

  • è CrawlGroup

  • è CrawlOpportunity

  • è CrawlChatter

  • è CrawlUser

  • è CrawlSolution

  • è CrawlTask

  • è CrawlAccountAttachments

  • è CrawlContactAttachments

  • è CrawlCaseAttachments

  • è CrawlCampaignAttachments

  • è CrawlLeadAttachments

  • è CrawlContractAttachments

  • è CrawlGroupAttachments

  • è CrawlOpportunityAttachments

  • è CrawlChatterAttachments

  • è CrawlSolutionAttachments

  • è CrawlTaskAttachments

  • è CrawlCustomEntityAttachments

  • è CrawlKnowledgeArticles

    • è CrawlDraft

    • è CrawlPublish

    • è CrawlArchived

trueper scansionare questi tipi di file nel tuo account Salesforce.
tipo Il tipo di origine dati. Specifica SALESFORCEV2 come tipo di origine dati.
abilita IdentityCrawler trueutilizzare il crawler Amazon Kendra di identità per sincronizzare identity/principal le informazioni su utenti e gruppi con accesso a determinati documenti. Se l'identity crawler è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

version La versione di questo modello attualmente supportata.
{ "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "connectionConfiguration": { "type": "object", "properties": { "repositoryEndpointMetadata": { "type": "object", "properties": { "hostUrl": { "type": "string", "pattern": "https:.*" }, "authType": { "type": "string", "enum": [ "clientCredentials", "usernamePassword" ] } }, "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 schema del modello

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Fornisci l'URL dell' ServiceNow host, il tipo di autenticazione e la versione dell'istanza come parte della configurazione della connessione o dei dettagli dell'endpoint del repository. Specifica inoltre il tipo di origine datiSERVICENOWV2, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta ServiceNow Schema JSON.

La tabella seguente descrive i parametri dello schema ServiceNow JSON.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati.
hostUrl L'URL dell' ServiceNow host. Ad esempio, your-domain.service-now.com.
authType Il tipo di autenticazione impiegato, se basicAuth o OAuth2.
servizio ora InstanceVersion La ServiceNow versione che usi. Puoi scegliere traTokyo, SandiegoRome, eOthers.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
  • Articolo di conoscenza

  • attachment

  • Catalogo dei servizi

  • incidente

Un elenco di oggetti che associano gli attributi o i nomi dei campi degli articoli di ServiceNow conoscenza, degli allegati, del catalogo dei servizi e degli incidenti ai nomi dei campi di Amazon Kendra indicizzazione. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati. I nomi dei campi dell'origine ServiceNow dati devono essere presenti nei metadati ServiceNow personalizzati.
proprietà aggiuntive Opzioni di configurazione aggiuntive per i contenuti dell’origine dati.
max FileSizeInMegaBytes Specifica il limite di dimensione del file in MB che Amazon Kendra eseguirà la scansione. Amazon Kendra eseguirà la scansione solo dei file entro il limite di dimensione definito. La dimensione predefinita dei file è 50 MB. La dimensione massima dei file deve essere maggiore di 0 MB e inferiore o uguale a 50 MB.
  • conoscenza ArticleFilter

  • incidente QueryFilter

  • servizio CatalogQueryFilter

  • conoscenza ArticleTitleRegExp

  • servizio CatalogTitleRegExp

  • incidente TitleRegExp

  • inclusione FileTypePatterns

  • esclusione FileTypePatterns

  • inclusione FileNamePatterns

  • esclusione FileNamePatterns

  • incidente StateType

Un elenco di modelli di espressioni regolari da includere per and/or escludere determinati file nell'origine ServiceNow dati. I file che corrispondono ai modelli sono inclusi nell'indice. I file che non corrispondono ai modelli sono esclusi dall’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
  • è CrawlKnowledgeArticle

  • è CrawlKnowledgeArticleAttachment

  • includere PublicArticlesOnly

  • è CrawlServiceCatalog

  • è CrawlServiceCatalogAttachment

  • è CrawlActiveServiceCatalog

  • è CrawlInactiveServiceCatalog

  • è CrawlIncident

  • è CrawlIncidentAttachment

  • è CrawlActiveIncident

  • è CrawlInactiveIncident

  • applicare ACLForKnowledgeArticle

  • applicare ACLForServiceCatalog

  • applicare ACLForIncident

trueper scansionare articoli ServiceNow informativi, cataloghi di servizi, incidenti e allegati.
tipo Il tipo di origine dati. Specifica SERVICENOWV2 come tipo di origine dati.
abilitare IdentityCrawler trueutilizzare il crawler Amazon Kendra di identità per sincronizzare identity/principal le informazioni su utenti e gruppi con accesso a determinati documenti. Se l'identity crawler è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

secretARN L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto che contiene le coppie chiave-valore necessarie per connettersi al tuo. ServiceNow Il segreto deve contenere una struttura JSON con le seguenti chiavi:
{ "username": "user name", "password": "password" }
Se si utilizza l’autenticazione OAuth2, il segreto deve contenere una struttura JSON con le seguenti chiavi:
{ "username": "user name", "password": "password", "clientId": "client id", "clientSecret": "client secret" }
version La versione del modello attualmente supportata.
{ "$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" ] }

Schema del modello Slack

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Fornisci l'URL dell'host come parte della configurazione della connessione o dei dettagli dell'endpoint del repository. Specifica inoltre il tipo di origine datiSLACK, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Schema JSON di Slack.

La tabella seguente descrive i parametri dello schema JSON di Slack.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati.
teamId L'ID del team Slack che hai copiato dall'URL della tua pagina principale di Slack.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
Tutti Un elenco di oggetti che associano gli attributi o i nomi dei campi dei tuoi Slack contenuti ai nomi dei campi di Amazon Kendra indicizzazione.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati.
Schemi di inclusione Un elenco di modelli di espressioni regolari per includere contenuti specifici nell’origine dati Slack. I contenuti che corrispondono ai modelli sono inclusi nell’indice. I contenuti che non corrispondono ai modelli sono esclusi dall’indice. Se un contenuto corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il contenuto non viene incluso nell’indice.
Schemi di esclusione Un elenco di modelli di espressioni regolari per escludere contenuti specifici nell’origine dati Slack. I contenuti che corrispondono ai modelli sono esclusi dall’indice. I contenuti che non corrispondono ai modelli sono inclusi nell'indice. Se un contenuto corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il contenuto non viene incluso nell’indice.
scansione BotMessages trueper scansionare i messaggi dei bot.
Escludi archiviati trueper escludere la scansione dei messaggi archiviati.
Tipo di conversazione Il tipo di conversazione che desideri indicizzare sePUBLIC_CHANNEL,, ePRIVATE_CHANNEL. GROUP_MESSAGE DIRECT_MESSAGE
Filtro di canale Il tipo di canale che si desidera indicizzare, private_channel o public_channel.
Dalla data È possibile scegliere di configurare un parametro sinceDate in modo che il connettore per Slack esegua il crawling del contenuto in base a un valore sinceDate specifico.
Guarda indietro Puoi scegliere di configurare un lookBack parametro in modo che il Slack connettore esegua la scansione dei contenuti aggiornati o eliminati fino a un numero specificato di ore prima dell'ultima sincronizzazione del connettore.
syncMode

Specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

tipo Il tipo di origine dati. Specifica SLACK come tipo di origine dati.
abilitare IdentityCrawler trueutilizzare il crawler Amazon Kendra di identità per sincronizzare identity/principal le informazioni su utenti e gruppi con accesso a determinati documenti. Se l'identity crawler è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi.
secretArn

L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto che contiene le coppie chiave-valore necessarie per connettersi al tuo. Slack Il segreto deve contenere una struttura JSON con le seguenti chiavi:

{ "slackToken": "token" }
version La versione di questo modello attualmente supportata.
{ "$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" ] }

Schema del modello Zendesk

Includi un JSON che contiene lo schema dell'origine dati come parte dell'TemplateConfigurationoggetto. Fornisci l'URL dell'host come parte della configurazione della connessione o dei dettagli dell'endpoint del repository. Specifica inoltre il tipo di origine datiZENDESK, un segreto per le credenziali di autenticazione e altre configurazioni necessarie. Quindi specifichi TEMPLATE come Type quando chiami. CreateDataSource

Puoi utilizzare il modello fornito in questa guida per sviluppatori. Per informazioni, consulta Schema JSON di Zendesk.

La tabella seguente descrive i parametri dello schema JSON di Zendesk.

Configurazione Description
connectionConfiguration Informazioni di configurazione per l’endpoint per l’origine dati.
repository EndpointMetadata Le informazioni sull’endpoint per l’origine dati.
URL dell'host L'URL dell'host Zendesk. Ad esempio, https://yoursubdomain.zendesk.com.
repositoryConfigurations Informazioni di configurazione per il contenuto dell’origine dati. Ad esempio, la configurazione di tipi specifici di contenuti e mappature dei campi.
  • ticket

  • Commento sul biglietto

  • biglietto CommentAttachment

  • articolo

  • Commento all'articolo

  • Allegato all'articolo

  • Argomento della community

  • comunità PostComment

Un elenco di oggetti che associano gli attributi o i nomi dei campi dei ticket Zendesk ai nomi dei campi dell'indice Amazon Kendra. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
secretARN L'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto che contiene le coppie chiave-valore necessarie per connettersi a Zendesk. Il segreto deve contenere una struttura JSON con le seguenti chiavi: URL host, ID client, segreto client, nome utente e password.
additionalProperties Opzioni di configurazione aggiuntive per i contenuti dell’origine dati
organizzazione NameFilter Puoi scegliere di indicizzare i ticket esistenti all'interno di una specifica organizzazione.
A partire da Data Puoi scegliere di configurare un sinceDate parametro in modo che il connettore Zendesk esegua la scansione del contenuto in base a uno specifico. sinceDate
Schemi di inclusione Un elenco di modelli di espressioni regolari per includere determinati file nell'origine dati Zendesk. I file che corrispondono ai modelli sono inclusi nell'indice. I file che non corrispondono ai modelli sono esclusi dall’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
Schemi di esclusione Un elenco di modelli di espressioni regolari per escludere determinati file nell'origine dati Zendesk. I file che corrispondono ai modelli sono esclusi dall’indice. I file che non corrispondono ai modelli sono inclusi nell’indice. Se un file corrisponde sia a un modello di esclusione sia a un modello di inclusione, il modello di esclusione ha la precedenza e il file non viene incluso nell’indice.
  • è CrawlTicket

  • è CrawlTicketComment

  • è CrawlTicketCommentAttachment

  • è CrawlArticle

  • è CrawlArticleComment

  • è CrawlArticleAttachment

  • è CrawlCommunityTopic

  • è CrawlCommunityPost

  • è CrawlCommunityPostComment

Inserisci "true" per eseguire la scansione di questi tipi di contenuti.
tipo Specifica ZENDESK come tipo di origine dati.
usa ChangeLog Inserisci "true" per utilizzare il registro delle modifiche di Zendesk e determinare quali documenti devono essere aggiornati nell'indice. A seconda delle dimensioni del registro delle modifiche, potrebbe essere più veloce scansionare i documenti in Zendesk. Se stai sincronizzando la tua fonte di dati Zendesk con il tuo indice per la prima volta, tutti i documenti vengono scansionati.
{ "$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" ] }