. |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Objekten, die Ihren Drupal-Dateien Attribute oder Feldnamen zuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). Die Feldnamen der Drupal-Datenquelle müssen in Ihren benutzerdefinierten Drupal-Metadaten vorhanden sein. |
| additionalProperties | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste mit Mustern für reguläre Ausdrücke, um bestimmte Dateien in Ihrer Drupal-Datenquelle einzuschließen. Dateien, die den Mustern entsprechen, werden in den Index eingeschlossen. Dateien, die nicht den Mustern entsprechen, werden aus dem Index ausgeschlossen. Wenn eine Datei sowohl einem Ein- als auch einem Ausschlussmuster entspricht, hat das Ausschlussmuster Vorrang und die Datei wird nicht in den Index eingeschlossen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste mit Mustern für reguläre Ausdrücke, um bestimmte Dateien in Ihrer Drupal-Datenquelle auszuschließen. Dateien, die dem Muster entsprechen, werden aus dem Index ausgeschlossen. Dateien, die den Mustern nicht entsprechen, werden in den Index eingeschlossen. Wenn eine Datei sowohl einem Aus- als auch einem Einschlussmuster entspricht, hat das Ausschlussmuster Vorrang und die Datei wird nicht in den Index eingeschlossen. |
| contentDefinitions[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Geben Sie an, welche Inhaltstypen gecrawlt werden sollen, und ob Kommentare und Anhänge für die ausgewählten Inhaltstypen gecrawlt werden. |
| type | Der Typ der Datenquelle. Geben Sie DRUPAL als Datenquellentyp an. |
| authType | Der verwendete Authentifizierungstyp, ob BASIC-AUTH oder OAUTH2. |
| syncMode | Geben Sie an, wie Ihr Index aktualisiert werden Amazon Kendra soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Sie können wählen zwischen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| enableIdentityCrawler | trueum den Identity Crawler zu verwenden Amazon Kendra, um identity/principal Informationen über Benutzer und Gruppen mit Zugriff auf bestimmte Dokumente zu synchronisieren. Wenn Identity Crawler ausgeschaltet ist, können alle Dokumente öffentlich durchsucht werden. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen hochzuladen. |
| secretARN | Der Amazon-Ressourcenname (ARN) eines AWS Secrets Manager Geheimnisses, das die Schlüssel-Wert-Paare enthält, die für die Verbindung mit Ihrem Drupal erforderlich sind. Das Geheimnis muss eine JSON-Struktur mit den folgenden Schlüsseln enthalten: **Wenn Sie die grundlegende Authentifizierung verwenden:**{
"username": "user name",
"passwords": "password"
} **Wenn Sie die 2.0-Authentifizierung verwenden OAuth :**{
"username": "user name",
"password": "password",
"clientId": "client id",
"clientSecret": "client secret"
} |
| version | Die Version dieser Vorlage, die derzeit unterstützt wird. |
### Drupal-JSON-Schema
```
{
"$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 Vorlagenschema
Sie fügen eine JSON-Datei ein, die das Datenquellenschema als Teil des [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)Objekts enthält. Sie geben die GitHub Host-URL, den Namen der Organisation und die Angabe, ob Sie GitHub Cloud oder GitHub lokal verwenden, als Teil der Verbindungskonfiguration oder der Repository-Endpunktdetails an. Geben Sie außerdem den Typ der Datenquelle`GITHUB`, ein Geheimnis für Ihre Authentifizierungsdaten und andere erforderliche Konfigurationen an. Geben Sie dann `TEMPLATE` an`Type`, wann Sie anrufen [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html).
Sie können die in diesem Entwicklerhandbuch enthaltene Vorlage verwenden. Siehe [GitHub JSON-Schema](#github-json).
In der folgenden Tabelle werden die Parameter des GitHub JSON-Schemas beschrieben.
| Konfiguration | Description |
| --- | --- |
| connectionConfiguration | Konfigurationsinformationen für den Endpunkt für die Datenquelle. |
| repositoryEndpointMetadata | Die Endpunktinformationen für die Datenquelle. |
| type | Geben Sie den Typ entweder als SAAS oder anON\$1PREMISE. |
| hostUrl | Die GitHub Host-URL. Wenn Sie beispielsweise GitHub SaaS/Enterprise Cloud verwenden:. https://api.github.com Oder, wenn Sie einen GitHub lokalen Server/Enterprise Server verwenden:. https://on-prem-host-url/api/v3/ |
| organizationName | Sie finden den Namen Ihrer Organisation, wenn Sie sich bei GitHub Desktop anmelden und in der Dropdownliste Ihres Profilbilds zu Ihre Organisationen gehen. |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. Beispielsweise die Konfiguration bestimmter Inhaltstypen und Feldzuordnungen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Objekten, die die Attribute oder Feldnamen Ihres GitHub Inhalts Amazon Kendra Indexfeldnamen zuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). |
| additionalProperties | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. |
| isCrawlAcl | trueum die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente zu durchsuchen, falls Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen und welche sie durchsuchen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). |
| fieldForUserID | Geben Sie den Typ der Benutzer-ID an, die Sie für das ACL-Crawling verwenden möchten. Geben Sie an, email ob Sie die Benutzer-E-Mail für die Benutzer-ID verwenden möchten, oder username ob Sie den Benutzernamen für die Benutzer-ID verwenden möchten. Wenn Sie keine Option angeben, email wird diese Option standardmäßig verwendet. |
| repositoryFilter | Eine Liste der Namen der spezifischen Repositorys und der Branch-Namen, die Sie indexieren möchten. |
| CrawlRepository | trueum Repositorys zu crawlen. |
| crawlRepositoryDocuments | trueum Repository-Dokumente zu crawlen. |
| Problem crawlen | trueum Probleme zu crawlen. |
| crawlIssueComment | trueum Problemkommentare zu crawlen. |
| crawlIssueCommentAnlage | trueum Dateikommentaranhänge zu crawlen. |
| crawlPullRequest | trueum Pull-Requests zu crawlen. |
| crawlPullRequestKommentar | trueum Kommentare zu Pull-Requests zu crawlen. |
| crawlPullRequestCommentAttachment | truezum Crawlen von Anhängen von Pull-Request-Kommentaren. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Mustern für reguläre Ausdrücke, um bestimmte Inhalte in Ihre GitHub Datenquelle aufzunehmen. Elemente, die den Mustern entsprechen, werden in den Index eingeschlossen. Inhalte, die nicht den Mustern entsprechen, werden aus dem Index ausgeschlossen. Wenn Inhalte sowohl einem Ein- als auch einem Ausschlussmuster entsprechen, hat das Ausschlussmuster Vorrang und die Inhalte werden nicht in den Index eingeschlossen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Mustern mit regulären Ausdrücken, um bestimmte Inhalte in Ihrer GitHub Datenquelle auszuschließen. Inhalte, die den Mustern entsprechen, werden aus dem Index ausgeschlossen. Inhalte, die den Mustern nicht entsprechen, werden in den Index eingeschlossen. Wenn Inhalte sowohl einem Ein- als auch einem Ausschlussmuster entsprechen, hat das Ausschlussmuster Vorrang und die Inhalte werden nicht in den Index eingeschlossen. |
| type | Der Typ der Datenquelle. Geben Sie GITHUB als Datenquellentyp an. |
| enableIdentityCrawler | trueum den Identity Crawler zu verwenden Amazon Kendra, um identity/principal Informationen über Benutzer und Gruppen mit Zugriff auf bestimmte Dokumente zu synchronisieren. Wenn Identity Crawler ausgeschaltet ist, können alle Dokumente öffentlich durchsucht werden. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen hochzuladen. |
| syncMode | Geben Sie an, wie Ihr Index aktualisiert werden Amazon Kendra soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Sie können wählen zwischen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| secretArn | Der Amazon-Ressourcenname (ARN) eines AWS Secrets Manager Geheimnisses, das die Schlüssel-Wert-Paare enthält, die für die Verbindung mit Ihrem erforderlich sind. GitHub Das Geheimnis muss eine JSON-Struktur mit den folgenden Schlüsseln enthalten: {
"personalToken": "token"
} |
| version | Die Version dieser Vorlage, die derzeit unterstützt wird. |
### GitHub JSON-Schema
Das Folgende ist das GitHub JSON-Schema:
```
{
"$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"
]
}
```
## Gmail-Vorlagenschema
Sie fügen eine JSON-Datei ein, die das Datenquellenschema als Teil des [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekts enthält. Geben Sie den Typ der Datenquelle als`GMAIL`, ein Geheimnis für Ihre Authentifizierungsdaten und andere erforderliche Konfigurationen an. Geben Sie dann `TEMPLATE` an`Type`, wann Sie anrufen [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Sie können die in diesem Entwicklerhandbuch enthaltene Vorlage verwenden. Siehe [Gmail-JSON-Schema](#gmail-json).
In der folgenden Tabelle werden die Parameter des Gmail-JSON-Schemas beschrieben.
| Konfiguration | Description |
| --- | --- |
| connectionConfiguration | Konfigurationsinformationen für den Endpunkt für die Datenquelle. |
| repositoryEndpointMetadata | Die Endpunktinformationen für die Datenquelle. Diese Datenquelle spezifiziert keinen Endpunkt inrepositoryEndpointMetadata. Vielmehr sind die Verbindungsinformationen in einem AWS Secrets Manager Geheimnis enthalten, das Sie angebensecretArn. |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. Beispielsweise die Konfiguration bestimmter Inhaltstypen und Feldzuordnungen. Geben Sie den Typ der Datenquelle und den geheimen ARN an. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Objekten, die die Attribute oder Feldnamen Ihrer Gmail-Nachrichten und -Anlagen Amazon Kendra Indexfeldnamen zuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). |
| additionalProperties | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste mit Mustern für reguläre Ausdrücke, mit denen Sie Nachrichten mit bestimmten Betreffnamen in Ihre Gmail-Datenquelle aufnehmen oder ausschließen können. Dateien, die den Mustern entsprechen, werden in den Index eingeschlossen. Wenn eine Datei sowohl einem Ein- als auch einem Ausschlussmuster entspricht, hat das Ausschlussmuster Vorrang und die Datei wird nicht in den Index eingeschlossen. |
| beforeDateFilter | Geben Sie Nachrichten und Anhänge an, die vor einem bestimmten Datum eingeschlossen werden sollen. |
| afterDateFilter | Geben Sie Nachrichten und Anhänge an, die nach einem bestimmten Datum eingeschlossen werden sollen. |
| isCrawlAttachment | Ein boolescher Wert, mit dem Sie auswählen können, ob Sie Anhänge crawlen möchten. Nachrichten werden automatisch gecrawlt. |
| type | Der Typ der Datenquelle. Geben Sie GMAIL als Datenquellentyp an. |
| shouldCrawlDraftNachrichten | Ein boolescher Wert, mit dem Sie auswählen können, ob Sie Nachrichtenentwürfe crawlen möchten. |
| syncMode | Geben Sie an, wie Ihr Index aktualisiert werden Amazon Kendra soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Sie können wählen zwischen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) Da es keine API zum Aktualisieren dauerhaft gelöschter Gmail-Nachrichten gibt, werden alle neuen, geänderten oder gelöschten Inhalte synchronisiert: Nachrichten, die dauerhaft aus Gmail gelöscht wurden, werden nicht aus Ihrem Amazon Kendra Index entfernt Synchronisiert keine Änderungen an Gmail-E-Mail-Labels Um die Änderungen an den Labels Ihrer Gmail-Datenquelle und dauerhaft gelöschte E-Mail-Nachrichten mit Ihrem Amazon Kendra Index zu synchronisieren, müssen Sie regelmäßig vollständige Crawls ausführen. |
| secretARN | Der Amazon-Ressourcenname (ARN) eines Secrets Manager Manager-Geheimnisses, das die Schlüssel-Wert-Paare enthält, die für die Verbindung mit Ihrem Gmail erforderlich sind. Das Geheimnis muss eine JSON-Struktur mit den folgenden Schlüsseln enthalten: {
"adminAccountEmailId": "service account email",
"clientEmailId": "user account email",
"privateKey": "private key"
} |
| version | Die Version der Vorlage, die derzeit unterstützt wird. |
### Gmail-JSON-Schema
```
{
"$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"
]
}
```
## Google Drive-Vorlagenschema
Sie fügen eine JSON-Datei ein, die das Datenquellenschema als Teil des [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekts enthält. Geben Sie den Typ der Datenquelle als`GOOGLEDRIVE2`, ein Geheimnis für Ihre Authentifizierungsdaten und andere erforderliche Konfigurationen an. Geben Sie dann `TEMPLATE` an`Type`, wann Sie anrufen [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Sie können die in diesem Entwicklerhandbuch enthaltene Vorlage verwenden. Siehe [Google Drive-JSON-Schema](#googledrive-json).
In der folgenden Tabelle werden die Parameter des Google Drive-JSON-Schemas beschrieben.
| Konfiguration | Description |
| --- | --- |
| connectionConfiguration | Konfigurationsinformationen für die Datenquelle. |
| repositoryEndpointMetadata | Die Endpunktinformationen für die Datenquelle. Diese Datenquelle spezifiziert keinen Endpunkt. Sie wählen Ihren Authentifizierungstyp aus: serviceAccount undOAuth2. Die Verbindungsinformationen sind in einem AWS Secrets Manager geheimen Schlüssel enthalten, den Sie angebensecretArn. |
| authType | Wählen Sie OAuth2 je nach Anwendungsfall zwischen serviceAccount und. |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. Beispielsweise die Konfiguration bestimmter Inhaltstypen und Feldzuordnungen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Objekten, die die Attribute oder Feldnamen Ihres Google Drive Amazon Kendra Indexfeldnamen zuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). |
| additionalProperties | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Geben Sie eine Dateigrößenbeschränkung für Dateien an MBs , die gecrawlt Amazon Kendra werden sollen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | trueum Kommentare in Ihrer Google Drive-Datenquelle zu crawlen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | trueum Drive-Laufwerke in Ihrer Google Drive-Datenquelle zu crawlen MyDrive und mit mir geteilt zu haben. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | trueum Shared Drives in Ihrer Google Drive-Datenquelle zu crawlen. |
| isCrawlAcl | trueum die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente zu durchsuchen, falls Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen und welche sie durchsuchen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste mit Mustern für reguläre Ausdrücke, um bestimmte Dateien in Ihrer Google Drive-Datenquelle auszuschließen. Dateien, die dem Muster entsprechen, werden aus dem Index ausgeschlossen. Dateien, die den Mustern nicht entsprechen, werden in den Index eingeschlossen. Wenn eine Datei sowohl einem Aus- als auch einem Einschlussmuster entspricht, hat das Ausschlussmuster Vorrang und die Datei wird nicht in den Index eingeschlossen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste mit Mustern für reguläre Ausdrücke, um bestimmte Dateien in Ihre Google Drive-Datenquelle aufzunehmen. Dateien, die den Mustern entsprechen, werden in den Index eingeschlossen. Dateien, die nicht den Mustern entsprechen, werden aus dem Index ausgeschlossen. Wenn eine Datei sowohl einem Ein- als auch einem Ausschlussmuster entspricht, hat das Ausschlussmuster Vorrang und die Datei wird nicht in den Index eingeschlossen. |
| type | Der Typ der Datenquelle. Geben Sie GOOOGLEDRIVEV2 als Datenquellentyp an. |
| enableIdentityCrawler | trueum den Identity Crawler zu verwenden Amazon Kendra, um identity/principal Informationen über Nutzer und Gruppen mit Zugriff auf bestimmte Dokumente zu synchronisieren. Wenn Identity Crawler ausgeschaltet ist, können alle Dokumente öffentlich durchsucht werden. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen hochzuladen. |
| syncMode | Geben Sie an, wie Ihr Index aktualisiert werden Amazon Kendra soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Sie können wählen zwischen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| secretARN | Der Amazon-Ressourcenname (ARN) eines AWS Secrets Manager Geheimnisses, das die Schlüssel-Wert-Paare enthält, die für die Verbindung mit Ihrem Google Drive erforderlich sind. Das Geheimnis muss eine JSON-Struktur mit den folgenden Schlüsseln enthalten: ****Wenn Sie die Authentifizierung für das Google-Dienstkonto verwenden:{
"clientEmail": "user account email",
"adminAccountEmail": "service account email",
"privateKey": "private key"
} ****Wenn Sie die OAuth 2.0-Authentifizierung verwenden: {
"clientID": "OAuth client ID",
"clientSecret": "client secret",
"refreshToken": "refresh token"
} |
| version | Die Version dieser Vorlage, die derzeit unterstützt wird. |
### Google Drive-JSON-Schema
```
{
"$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"
]
}
```
## DB2 IBM-Vorlagenschema
Sie fügen eine JSON-Datei ein, die das Datenquellenschema als Teil des [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekts enthält. Geben Sie den Typ der Datenquelle als`JDBC`, den Datenbanktyp als`db2`, ein Geheimnis für Ihre Authentifizierungsdaten und andere erforderliche Konfigurationen an. Geben Sie dann `TEMPLATE` an`Type`, wann Sie anrufen [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Sie können die in diesem Entwicklerhandbuch enthaltene Vorlage verwenden. Siehe [IBM DB2 JSON-Schema](#ibm-db2-json).
In der folgenden Tabelle werden die Parameter des IBM DB2 JSON-Schemas beschrieben.
| Konfiguration | Description |
| --- | --- |
| connectionConfiguration | Konfigurationsinformationen für den Endpunkt für die Datenquelle. |
| repositoryEndpointMetadata | Erforderliche Konfigurationsinformationen für die Verbindung mit Ihrer Datenquelle.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. Beispielsweise die Konfiguration bestimmter Inhaltstypen und Feldzuordnungen. Geben Sie den Typ der Datenquelle und den geheimen ARN an. |
| document | Eine Liste von Objekten, die die Attribute oder Feldnamen Ihres Datenbankinhalts Amazon Kendra Indexfeldnamen zuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). |
| additionalProperties | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. Wird verwendet, um bestimmte Inhalte in Ihrer Datenbankdatenquelle ein- oder auszuschließen. |
| primaryKey | Geben Sie den Primärschlüssel für die Datenbanktabelle an. Dadurch wird eine Tabelle in Ihrer Datenbank identifiziert. |
| titleColumn | Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein. |
| bodyColumn | Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein. |
| sqlQuery | Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen müssen weniger als 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht. |
| timestampColumn | Geben Sie den Namen der Spalte ein, die Zeitstempel enthält. Amazon Kendra verwendet Zeitstempelinformationen, um Änderungen an Ihrem Inhalt zu erkennen und nur geänderte Inhalte zu synchronisieren. |
| timestampFormat | Geben Sie den Namen der Spalte ein, die Zeitstempelformate enthält, die verwendet werden sollen, um Inhaltsänderungen zu erkennen und Ihre Inhalte erneut zu synchronisieren. |
| timezone | Geben Sie den Namen der Spalte ein, die Zeitzonen für den Inhalt enthält, der durchsucht werden soll. |
| changeDetectingColumns | Geben Sie die Namen der Spalten ein, anhand derer Inhaltsänderungen erkannt Amazon Kendra werden sollen. Amazon Kendra indexiert den Inhalt neu, wenn sich eine dieser Spalten ändert |
| allowedUsersColumns | Geben Sie den Namen der Spalte ein, die den Benutzer IDs enthält, dem der Zugriff auf den Inhalt gewährt werden soll. |
| allowedGroupsColumn | Geben Sie den Namen der Spalte ein, die den Benutzer enthält IDs , dem der Zugriff auf Inhalte gewährt werden soll. |
| Quelle URIColumn | Geben Sie den Namen der Spalte ein, die die URLs zu indizierende Quelle enthält. |
| isSslEnabled | Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen müssen weniger als 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht. |
| type | Der Typ der Datenquelle. Geben Sie JDBC als Datenquellentyp an. |
| syncMode | Geben Sie an, wie Ihr Index aktualisiert werden Amazon Kendra soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Sie können wählen zwischen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| secretArn | Der Amazon-Ressourcenname (ARN) eines Secrets-Manager-Secrets, das den Benutzernamen und das Passwort enthält, die für die Verbindung mit Ihrer Datenbank erforderlich sind. Das Geheimnis muss eine JSON-Struktur mit den folgenden Schlüsseln enthalten: {
"user name": "database user name",
"password": "password"
} |
| version | Die Version der Vorlage, die derzeit unterstützt wird. |
### IBM DB2 JSON-Schema
```
{
"$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"
]
}
```
## Microsoft Exchange-Vorlagenschema
Sie fügen eine JSON-Datei ein, die das Datenquellenschema als Teil des [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekts enthält. Sie geben die Mandanten-ID als Teil der Verbindungskonfiguration oder der Repository-Endpunktdetails an. Geben Sie außerdem den Typ der Datenquelle`MSEXCHANGE`, ein Geheimnis für Ihre Authentifizierungsdaten und andere erforderliche Konfigurationen an. Geben Sie dann `TEMPLATE` an`Type`, wann Sie anrufen [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Sie können die in diesem Entwicklerhandbuch enthaltene Vorlage verwenden. Siehe [Microsoft Exchange-JSON-Schema](#msexchange-json).
In der folgenden Tabelle werden die Parameter des Microsoft Exchange-JSON-Schemas beschrieben.
| Konfiguration | Description |
| --- | --- |
| connectionConfiguration | Konfigurationsinformationen für den Endpunkt für die Datenquelle. |
| repositoryEndpointMetadata | Die Endpunktinformationen für die Datenquelle. |
| TenantID | Die Microsoft 365-Mandanten-ID. Sie finden Ihre Mandanten-ID in den Eigenschaften Ihres Azure Active Directory-Portals oder in Ihrer OAuth Anwendung. |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. Beispielsweise die Konfiguration bestimmter Inhaltstypen und Feldzuordnungen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Objekten, die die Attribute oder Feldnamen Ihrer Microsoft Exchange-Datenquelle Amazon Kendra Indexfeldern zuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). |
| additionalProperties | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. |
| Inklusionsmuster | Eine Liste von Mustern für reguläre Ausdrücke, um bestimmte Dateien in Ihre Microsoft Exchange-Datenquelle aufzunehmen. Dateien, die den Mustern entsprechen, werden in den Index eingeschlossen. Dateien, die nicht den Mustern entsprechen, werden aus dem Index ausgeschlossen. Wenn eine Datei sowohl einem Ein- als auch einem Ausschlussmuster entspricht, hat das Ausschlussmuster Vorrang und die Datei wird nicht in den Index eingeschlossen. |
| Ausschlussmuster | Eine Liste von Mustern für reguläre Ausdrücke, um bestimmte Dateien in Ihrer Microsoft Exchange-Datenquelle auszuschließen. Dateien, die dem Muster entsprechen, werden aus dem Index ausgeschlossen. Dateien, die den Mustern nicht entsprechen, werden in den Index eingeschlossen. Wenn eine Datei sowohl einem Aus- als auch einem Einschlussmuster entspricht, hat das Ausschlussmuster Vorrang und die Datei wird nicht in den Index eingeschlossen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Mustern für reguläre Ausdrücke, um bestimmte Benutzer und Benutzerdateien in Ihre Microsoft Exchange-Datenquelle aufzunehmen. Benutzer, die den Mustern entsprechen, werden in den Index aufgenommen. Benutzer, die den Mustern nicht entsprechen, werden aus dem Index ausgeschlossen. Wenn ein Benutzer sowohl einem Inklusions- als auch einem Ausschlussmuster entspricht, hat das Ausschlussmuster Vorrang und der Benutzer wird nicht in den Index aufgenommen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Mustern für reguläre Ausdrücke, um bestimmte Benutzer und Benutzerdateien in Ihrer Microsoft Exchange-Datenquelle auszuschließen. Benutzer, die den Mustern entsprechen, werden aus dem Index ausgeschlossen. Benutzer, die den Mustern nicht entsprechen, werden in den Index aufgenommen. Wenn ein Benutzer sowohl einem Ausschluss- als auch einem Einschlussmuster entspricht, hat das Ausschlussmuster Vorrang und der Benutzer wird nicht in den Index aufgenommen. |
| S3-Bucket-Name | Der Name Ihres S3-Buckets, falls Sie diesen verwenden möchten. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | trueum diese Arten von Inhalts- und Zugriffskontrollinformationen in Ihrer Microsoft Exchange-Datenquelle zu crawlen. |
| startCalendarDateZeit | Sie können ein bestimmtes Startdatum und eine bestimmte Startzeit für Ihren Kalenderinhalt konfigurieren. |
| endCalendarDateUhrzeit | Sie können ein bestimmtes Enddatum und eine bestimmte Endzeit für Kalenderinhalte konfigurieren. |
| subject | Sie können eine bestimmte Betreffzeile für Ihren E-Mail-Inhalt konfigurieren. |
| EmailFrom | Sie können eine bestimmte E-Mail für den Inhalt Ihrer Absender- oder Absendermail konfigurieren. |
| E-Mail an | Sie können eine bestimmte E-Mail für den Inhalt Ihrer „An“ -E-Mail oder Empfänger-Mail konfigurieren. |
| syncMode | Geben Sie an, wie Ihr Index aktualisiert werden Amazon Kendra soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Sie können wählen zwischen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| type | Der Typ der Datenquelle. Geben Sie MSEXCHANGE als Datenquellentyp an. |
| secretARN | Der Amazon-Ressourcenname (ARN) eines AWS Secrets Manager Geheimnisses, das die Schlüssel-Wert-Paare enthält, die für die Verbindung mit Ihrem Microsoft Exchange erforderlich sind. Dazu gehören Ihre Client-ID und Ihr geheimer Client-Schlüssel, der generiert wird, wenn Sie eine OAuth Anwendung im Azure-Portal erstellen. |
| version | Die Version dieser Vorlage, die derzeit unterstützt wird. |
### Microsoft Exchange-JSON-Schema
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"tenantId": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"minLength": 36,
"maxLength": 36
}
},
"required": ["tenantId"]
}
}
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"email": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"attachment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "DATE","LONG"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"calendar": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"contacts": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"notes": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
}
},
"required": ["email"
]
},
"additionalProperties": {
"type": "object",
"properties": {
"inclusionPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionUsersList": {
"type": "array",
"items": {
"type": "string",
"format": "email"
}
},
"exclusionUsersList": {
"type": "array",
"items": {
"type": "string",
"format": "email"
}
},
"s3bucketName": {
"type": "string"
},
"inclusionUsersFileName": {
"type": "string"
},
"exclusionUsersFileName": {
"type": "string"
},
"inclusionDomainUsers": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionDomainUsers": {
"type": "array",
"items": {
"type": "string"
}
},
"crawlCalendar": {
"type": "boolean"
},
"crawlNotes": {
"type": "boolean"
},
"crawlContacts": {
"type": "boolean"
},
"crawlFolderAcl": {
"type": "boolean"
},
"startCalendarDateTime": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$"
},
{
"type": "string",
"pattern": ""
}
]
},
"endCalendarDateTime": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$"
},
{
"type": "string",
"pattern": ""
}
]
},
"subject": {
"type": "array",
"items": {
"type": "string"
}
},
"emailFrom": {
"type": "array",
"items": {
"type": "string",
"format": "email"
}
},
"emailTo": {
"type": "array",
"items": {
"type": "string",
"format": "email"
}
}
},
"required": [
]
},
"syncMode": {
"type": "string",
"enum": [
"FORCED_FULL_CRAWL",
"FULL_CRAWL",
"CHANGE_LOG"
]
},
"type" : {
"type" : "string",
"pattern": "MSEXCHANGE"
},
"secretArn": {
"type": "string"
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"syncMode",
"additionalProperties",
"secretArn",
"type"
]
}
```
## OneDrive Microsoft-Vorlagenschema
Sie fügen eine JSON-Datei ein, die das Datenquellenschema als Teil des [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekts enthält. Sie geben die Mandanten-ID als Teil der Verbindungskonfiguration oder der Repository-Endpunktdetails an. Geben Sie außerdem den Typ der Datenquelle und ein Geheimnis für Ihre Authentifizierungsdaten sowie andere erforderliche Konfigurationen an. `ONEDRIVEV2` Geben Sie dann `TEMPLATE` an`Type`, wann Sie anrufen [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Sie können die in diesem Entwicklerhandbuch enthaltene Vorlage verwenden. Siehe [Microsoft OneDrive JSON-Schema](#onedrive-json).
In der folgenden Tabelle werden die Parameter des Microsoft OneDrive JSON-Schemas beschrieben.
| Konfiguration | Description |
| --- | --- |
| connectionConfiguration | Konfigurationsinformationen für den Endpunkt für die Datenquelle. |
| repositoryEndpointMetadata | Die Endpunktinformationen für die Datenquelle. |
| TenantID | Die Microsoft 365-Mandanten-ID. Sie finden Ihre Mandanten-ID in den Eigenschaften Ihres Azure Active Directory-Portals oder in Ihrer OAuth Anwendung. |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. Beispielsweise die Konfiguration bestimmter Inhaltstypen und Feldzuordnungen. |
| file | Eine Liste von Objekten, die die Attribute oder Feldnamen Ihrer OneDrive Microsoft-Dateien Amazon Kendra Indexfeldnamen zuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). |
| additionalProperties | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Sie können wählen, ob Sie bestimmte Dateien, OneNote Abschnitte und OneNote Seiten indizieren und nach Benutzernamen filtern möchten. |
| isUserNameAuf S3 | true, um eine Liste von Benutzernamen anzugeben, die in einer Datei in einem Amazon S3-Bucket gespeichert sind. |
| type | Der Typ der Datenquelle. Geben Sie ONEDRIVEV2 als Datenquellentyp an. |
| enableIdentityCrawler | trueum den Identity Crawler zu verwenden Amazon Kendra, um identity/principal Informationen über Benutzer und Gruppen mit Zugriff auf bestimmte Dokumente zu synchronisieren. Wenn Identity Crawler ausgeschaltet ist, können alle Dokumente öffentlich durchsucht werden. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen hochzuladen. |
| type | Der Typ der Datenquelle. Geben Sie ONEDRIVEV2 als Datenquellentyp an. |
| syncMode | Geben Sie an, wie Ihr Index aktualisiert werden Amazon Kendra soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Sie können wählen zwischen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| secretARN | Der Amazon-Ressourcenname (ARN) eines AWS Secrets Manager Geheimnisses, das die Schlüssel-Wert-Paare enthält, die für die Verbindung mit Ihrem Microsoft erforderlich sind. OneDrive Das Geheimnis muss eine JSON-Struktur mit den folgenden Schlüsseln enthalten: {
"clientId": "client ID",
"clientSecret": "client secret"
} |
| version | Die Version dieser Vorlage, die derzeit unterstützt wird. |
### Microsoft OneDrive JSON-Schema
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"tenantId": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"minLength": 36,
"maxLength": 36
}
},
"required": [
"tenantId"
]
}
},
"required": [
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"file": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE",
"LONG"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
}
}
},
"additionalProperties": {
"type": "object",
"properties": {
"userNameFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"userFilterPath": {
"type": "string"
},
"isUserNameOnS3": {
"type": "boolean"
},
"inclusionFileTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFileTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFilePathPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFilePathPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionOneNoteSectionNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionOneNoteSectionNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionOneNotePageNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionOneNotePageNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": []
},
"enableIdentityCrawler": {
"type": "boolean"
},
"type": {
"type": "string",
"pattern": "ONEDRIVEV2"
},
"syncMode": {
"type": "string",
"enum": [
"FULL_CRAWL",
"FORCED_FULL_CRAWL",
"CHANGE_LOG"
]
},
"secretArn": {
"type": "string",
"minLength": 20,
"maxLength": 2048
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"syncMode",
"additionalProperties",
"secretArn",
"type"
]
}
```
## SharePoint Microsoft-Vorlagenschema
Sie fügen eine JSON-Datei ein, die das Datenquellenschema als Teil des [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekts enthält. Sie geben die SharePoint Site-URL/URLs, die Domain und bei Bedarf auch eine Mandanten-ID als Teil der Verbindungskonfiguration oder der Repository-Endpunktdetails an. Geben Sie außerdem den Typ der Datenquelle`SHAREPOINTV2`, ein Geheimnis für Ihre Authentifizierungsdaten und andere erforderliche Konfigurationen an. Sie geben dann `TEMPLATE` den **Typ** an, wenn Sie anrufen [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Sie können die in diesem Entwicklerhandbuch enthaltene Vorlage verwenden. Siehe [SharePoint JSON-Schema](#sharepoint-json).
In der folgenden Tabelle werden die Parameter des Microsoft SharePoint JSON-Schemas beschrieben.
| Konfiguration | Description |
| --- | --- |
| connectionConfiguration | Konfigurationsinformationen für den Endpunkt der Datenquelle |
| repositoryEndpointMetadata | Die Endpunktinformationen für die Datenquelle |
| TenantID | Die Mieter-ID Ihres SharePoint Kontos. |
| Domain | Die Domain Ihres SharePoint Kontos. |
| URLs der Website | Der Gastgeber URLs Ihres SharePoint Kontos. |
| repositoryAdditionalProperties | Zusätzliche Eigenschaften für die Verbindung mit dem repository/data Quellendpunkt. |
| S3-Bucket-Name | Der Name des Amazon S3 Buckets, in dem Ihr selbstsigniertes Azure AD-X.509-Zertifikat gespeichert ist. |
| Name des S3-Zertifikats | Der Name des selbstsignierten Azure AD-X.509-Zertifikats, das in Ihrem Bucket gespeichert ist. Amazon S3 |
| authType | Die Art der Authentifizierung, die Sie verwenden, obOAuth2,OAuth2Certificate,,OAuth2App, Basic OAuth2\$1RefreshTokenNTLM, oder. Kerberos |
| version | Die SharePoint Version, die Sie verwenden, ob Server oderOnline. |
| onPremVersion | Die SharePoint Serverversion, die Sie verwenden, ob2013, 20162019, oderSubscriptionEdition. |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. Beispielsweise die Konfiguration bestimmter Inhaltstypen und Feldzuordnungen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Objekten, die die Attribute oder Feldnamen Ihres SharePoint Inhalts Amazon Kendra Indexfeldnamen zuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). |
| additionalProperties | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Mustern mit regulären Ausdrücken für include/exclude bestimmte Inhalte in Ihrer SharePoint Datenquelle. Inhaltselemente, die den Einschlussmustern entsprechen, werden in den Index aufgenommen. Inhaltselemente, die nicht den Inklusionsmustern entsprechen, werden aus dem Index ausgeschlossen. Wenn eine Datei sowohl einem Ein- als auch einem Ausschlussmuster entspricht, hat das Ausschlussmuster Vorrang und die Datei wird nicht in den Index eingeschlossen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | trueum diese Art von Inhalten zu crawlen. |
| Cl crawlen | trueum die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente zu durchsuchen, falls Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen und welche sie durchsuchen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). |
| fieldForUserID | Geben Sie an, email ob Sie die Benutzer-E-Mail für die Benutzer-ID verwenden möchten, oder userPrincipalName ob Sie einen Benutzernamen für die Benutzer-ID verwenden möchten. Wenn Sie keine Option angeben, email wird diese Option standardmäßig verwendet. |
| ACL-Konfiguration | Geben Sie entweder ACLWithLDAPEmailFmtACLWithManualEmailFmt, oder an. ACLWithUsernameFmtM |
| E-Mail-Domäne | Die Domain der E-Mail. Beispiel, „amazon.com“. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | trueum Informationen zur Gruppenzuweisung zu crawlen. |
| ProxyHost | Der Hostname des Webproxys, den Sie verwenden, ohne das Protokoll http://oder https://. |
| ProxyPort | Die vom Host-URL-Transportprotokoll verwendete Portnummer. Muss ein numerischer Wert zwischen 0 und 65535 sein. |
| type | Geben Sie SHAREPOINTV2 als Datenquellentyp an. |
| enableIdentityCrawler | trueum den Identity Crawler zu verwenden Amazon Kendra, um identity/principal Informationen über Benutzer und Gruppen mit Zugriff auf bestimmte Dokumente zu synchronisieren. Wenn Identity Crawler ausgeschaltet ist, können alle Dokumente öffentlich durchsucht werden. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen hochzuladen. |
| syncMode | Geben Sie an, wie Ihr Index aktualisiert werden Amazon Kendra soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Sie können wählen zwischen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| secretARN | Der Amazon-Ressourcenname (ARN) eines AWS Secrets Manager Geheimnisses, das die Schlüssel-Wert-Paare enthält, die für die Verbindung mit Ihrem erforderlich sind. SharePoint Informationen zu diesen Schlüssel-Wert-Paaren finden Sie unter [Verbindungsanweisungen für SharePoint ](https://docs.aws.amazon.com/kendra/latest/dg/data-source-v2-sharepoint.html#data-source-procedure-v2-sharepoint) Online und Server. SharePoint |
| version | Die Version dieser Vorlage, die derzeit unterstützt wird. |
## SharePoint JSON-Schema
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"tenantId": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"minLength": 36,
"maxLength": 36
},
"domain": {
"type": "string"
},
"siteUrls": {
"type": "array",
"items": {
"type": "string",
"pattern": "https://.*"
}
},
"repositoryAdditionalProperties": {
"type": "object",
"properties": {
"s3bucketName": {
"type": "string"
},
"s3certificateName": {
"type": "string"
},
"authType": {
"type": "string",
"enum": [
"OAuth2",
"OAuth2Certificate",
"OAuth2App",
"Basic",
"OAuth2_RefreshToken",
"NTLM",
"Kerberos"
]
},
"version": {
"type": "string",
"enum": [
"Server",
"Online"
]
},
"onPremVersion": {
"type": "string",
"enum": [
"",
"2013",
"2016",
"2019",
"SubscriptionEdition"
]
}
},
"required": [
"authType",
"version"
]
}
},
"required": [
"siteUrls",
"domain",
"repositoryAdditionalProperties"
]
}
},
"required": [
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"event": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"page": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE",
"LONG"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"file": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE",
"LONG"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"link": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"attachment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"comment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
}
}
},
"additionalProperties": {
"type": "object",
"properties": {
"eventTitleFilterRegEx": {
"type": "array",
"items": {
"type": "string"
}
},
"pageTitleFilterRegEx": {
"type": "array",
"items": {
"type": "string"
}
},
"linkTitleFilterRegEx": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFilePath": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFilePath": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFileTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFileTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionOneNoteSectionNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionOneNoteSectionNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionOneNotePageNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionOneNotePageNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"crawlFiles": {
"type": "boolean"
},
"crawlPages": {
"type": "boolean"
},
"crawlEvents": {
"type": "boolean"
},
"crawlComments": {
"type": "boolean"
},
"crawlLinks": {
"type": "boolean"
},
"crawlAttachments": {
"type": "boolean"
},
"crawlListData": {
"type": "boolean"
},
"crawlAcl": {
"type": "boolean"
},
"fieldForUserId": {
"type": "string"
},
"aclConfiguration": {
"type": "string",
"enum": [
"ACLWithLDAPEmailFmt",
"ACLWithManualEmailFmt",
"ACLWithUsernameFmt"
]
},
"emailDomain": {
"type": "string"
},
"isCrawlLocalGroupMapping": {
"type": "boolean"
},
"isCrawlAdGroupMapping": {
"type": "boolean"
},
"proxyHost": {
"type": "string"
},
"proxyPort": {
"type": "string"
}
},
"required": [
]
},
"type": {
"type": "string",
"pattern": "SHAREPOINTV2"
},
"enableIdentityCrawler": {
"type": "boolean"
},
"syncMode": {
"type": "string",
"enum": [
"FULL_CRAWL",
"FORCED_FULL_CRAWL",
"CHANGE_LOG"
]
},
"secretArn": {
"type": "string",
"minLength": 20,
"maxLength": 2048
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"enableIdentityCrawler",
"syncMode",
"additionalProperties",
"secretArn",
"type"
]
}
```
## Microsoft SQL Server-Vorlagenschema
Sie fügen eine JSON-Datei ein, die das Datenquellenschema als Teil des [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekts enthält. Geben Sie den Typ der Datenquelle als`JDBC`, den Datenbanktyp als`sqlserver`, ein Geheimnis für Ihre Authentifizierungsdaten und andere erforderliche Konfigurationen an. Geben Sie dann `TEMPLATE` an`Type`, wann Sie anrufen [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Sie können die in diesem Entwicklerhandbuch enthaltene Vorlage verwenden. Siehe [JSON-Schema für Microsoft SQL Server](#ms-sql-server-json).
In der folgenden Tabelle werden die Parameter des Microsoft SQL Server-JSON-Schemas beschrieben.
| Konfiguration | Description |
| --- | --- |
| connectionConfiguration | Konfigurationsinformationen für den Endpunkt für die Datenquelle. |
| repositoryEndpointMetadata | Erforderliche Konfigurationsinformationen für die Verbindung mit Ihrer Datenquelle.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. Beispielsweise die Konfiguration bestimmter Inhaltstypen und Feldzuordnungen. Geben Sie den Typ der Datenquelle und den geheimen ARN an. |
| document | Eine Liste von Objekten, die die Attribute oder Feldnamen Ihres Datenbankinhalts Amazon Kendra Indexfeldnamen zuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). |
| additionalProperties | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. Wird verwendet, um bestimmte Inhalte in Ihrer Datenbankdatenquelle ein- oder auszuschließen. |
| primaryKey | Geben Sie den Primärschlüssel für die Datenbanktabelle an. Dadurch wird eine Tabelle in Ihrer Datenbank identifiziert. |
| titleColumn | Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein. |
| bodyColumn | Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein. |
| sqlQuery | Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen müssen weniger als 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht. |
| timestampColumn | Geben Sie den Namen der Spalte ein, die Zeitstempel enthält. Amazon Kendra verwendet Zeitstempelinformationen, um Änderungen an Ihrem Inhalt zu erkennen und nur geänderte Inhalte zu synchronisieren. |
| timestampFormat | Geben Sie den Namen der Spalte ein, die Zeitstempelformate enthält, die verwendet werden sollen, um Inhaltsänderungen zu erkennen und Ihre Inhalte erneut zu synchronisieren. |
| timezone | Geben Sie den Namen der Spalte ein, die Zeitzonen für den Inhalt enthält, der durchsucht werden soll. |
| changeDetectingColumns | Geben Sie die Namen der Spalten ein, anhand derer Inhaltsänderungen erkannt Amazon Kendra werden sollen. Amazon Kendra indexiert den Inhalt neu, wenn sich eine dieser Spalten ändert |
| allowedUsersColumns | Geben Sie den Namen der Spalte ein, die den Benutzer IDs enthält, dem der Zugriff auf den Inhalt gewährt werden soll. |
| allowedGroupsColumn | Geben Sie den Namen der Spalte ein, die den Benutzer enthält IDs , dem der Zugriff auf Inhalte gewährt werden soll. |
| Quelle URIColumn | Geben Sie den Namen der Spalte ein, die die URLs zu indizierende Quelle enthält. |
| isSslEnabled | Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen müssen weniger als 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht. |
| type | Der Typ der Datenquelle. Geben Sie JDBC als Datenquellentyp an. |
| syncMode | Geben Sie an, wie Ihr Index aktualisiert werden Amazon Kendra soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Sie können wählen zwischen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| secretArn | Der Amazon-Ressourcenname (ARN) eines Secrets-Manager-Secrets, das den Benutzernamen und das Passwort enthält, die für die Verbindung mit Ihrer Datenbank erforderlich sind. Das Geheimnis muss eine JSON-Struktur mit den folgenden Schlüsseln enthalten: {
"user name": "database user name",
"password": "password"
} |
| version | Die Version der Vorlage, die derzeit unterstützt wird. |
### JSON-Schema für Microsoft SQL Server
```
{
"$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"
]
}
```
## Microsoft Teams-Vorlagenschema
Sie fügen eine JSON-Datei ein, die das Datenquellenschema als Teil des [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekts enthält. Sie geben die Mandanten-ID als Teil der Verbindungskonfiguration oder der Repository-Endpunktdetails an. Geben Sie außerdem den Typ der Datenquelle`MSTEAMS`, ein Geheimnis für Ihre Authentifizierungsdaten und andere erforderliche Konfigurationen an. Geben Sie dann `TEMPLATE` an`Type`, wann Sie anrufen [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Sie können die in diesem Entwicklerhandbuch enthaltene Vorlage verwenden. Siehe [JSON-Schema für Microsoft Teams](#msteams-json).
In der folgenden Tabelle werden die Parameter des Microsoft Teams-JSON-Schemas beschrieben.
| Konfiguration | Description |
| --- | --- |
| connectionConfiguration | Konfigurationsinformationen für den Endpunkt für die Datenquelle. |
| repositoryEndpointMetadata | Die Endpunktinformationen für die Datenquelle. |
| TenantID | Die Microsoft 365-Mandanten-ID. Sie finden Ihre Mandanten-ID in den Eigenschaften Ihres Azure Active Directory-Portals oder in Ihrer OAuth Anwendung. |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. Beispielsweise die Konfiguration bestimmter Inhaltstypen und Feldzuordnungen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Objekten, die die Attribute oder Feldnamen Ihrer Microsoft Teams-Inhalte Amazon Kendra Indexfeldnamen zuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). |
| additionalProperties | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. |
| Zahlungsmodell | Gibt an, welche Art von Zahlungsmodell mit Ihrer Microsoft Teams-Datenquelle verwendet werden soll. Die Zahlungsmodelle des Modells A sind auf Lizenz- und Zahlungsmodelle beschränkt, für die die Einhaltung der Sicherheitsvorschriften erforderlich ist. Die Zahlungsmodelle des Modells B eignen sich für Lizenz- und Zahlungsmodelle, für die keine Sicherheitsvorschriften erforderlich sind. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Mustern für reguläre Ausdrücke, um bestimmte Inhalte in Ihre Microsoft Teams-Datenquelle aufzunehmen. Elemente, die den Mustern entsprechen, werden in den Index eingeschlossen. Inhalte, die nicht den Mustern entsprechen, werden aus dem Index ausgeschlossen. Wenn Inhalte sowohl einem Ein- als auch einem Ausschlussmuster entsprechen, hat das Ausschlussmuster Vorrang und die Inhalte werden nicht in den Index eingeschlossen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Mustern mit regulären Ausdrücken, um bestimmte Inhalte in Ihrer Microsoft Teams-Datenquelle auszuschließen. Inhalte, die den Mustern entsprechen, werden aus dem Index ausgeschlossen. Inhalte, die den Mustern nicht entsprechen, werden in den Index eingeschlossen. Wenn Inhalte sowohl einem Ein- als auch einem Ausschlussmuster entsprechen, hat das Ausschlussmuster Vorrang und die Inhalte werden nicht in den Index eingeschlossen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | trueum diese Arten von Inhalten in Ihrer Microsoft Teams-Datenquelle zu crawlen. |
| startCalendarDateZeit | Sie können ein bestimmtes Startdatum und eine bestimmte Startzeit für Ihren Kalenderinhalt konfigurieren. |
| endCalendarDateUhrzeit | Sie können ein bestimmtes Enddatum und eine bestimmte Endzeit für Kalenderinhalte konfigurieren. |
| type | Der Typ der Datenquelle. Geben Sie MSTEAMS als Datenquellentyp an. |
| enableIdentityCrawler | trueum den Identity Crawler zu verwenden Amazon Kendra, um identity/principal Informationen über Benutzer und Gruppen mit Zugriff auf bestimmte Dokumente zu synchronisieren. Wenn Identity Crawler ausgeschaltet ist, können alle Dokumente öffentlich durchsucht werden. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen hochzuladen. |
| syncMode | Geben Sie an, wie Ihr Index aktualisiert werden Amazon Kendra soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Sie können wählen zwischen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| secretArn | Der Amazon-Ressourcenname (ARN) eines AWS Secrets Manager Geheimnisses, das die Schlüssel-Wert-Paare enthält, die für die Verbindung mit Ihren Microsoft Teams erforderlich sind. Dazu gehören Ihre Client-ID und Ihr geheimer Client-Schlüssel, der generiert wird, wenn Sie eine OAuth Anwendung im Azure-Portal erstellen. |
| version | Die Version dieser Vorlage, die derzeit unterstützt wird. |
### JSON-Schema für Microsoft Teams
```
{
"$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"
]
}
```
## Microsoft Yammer-Vorlagenschema
Sie fügen eine JSON-Datei hinzu, die das Datenquellenschema als Teil des [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekts enthält. Geben Sie den Typ der Datenquelle als`YAMMER`, ein Geheimnis für Ihre Authentifizierungsdaten und andere erforderliche Konfigurationen an. Sie geben dann `TEMPLATE` den **Typ** an, wenn Sie anrufen [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Sie können die in diesem Entwicklerhandbuch enthaltene Vorlage verwenden.
In der folgenden Tabelle werden die Parameter des Microsoft Yammer-JSON-Schemas beschrieben.
| Konfiguration | Description |
| --- | --- |
| connectionConfiguration | Konfigurationsinformationen für die Datenquelle. |
| repositoryEndpointMetadata | Die Endpunktinformationen für die Datenquelle. Diese Datenquelle spezifiziert keinen Endpunkt inrepositoryEndpointMetadata. Vielmehr sind die Verbindungsinformationen in einem AWS Secrets Manager Geheimnis enthalten, das Sie angebensecretArn. |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. Beispielsweise die Konfiguration bestimmter Inhaltstypen und Feldzuordnungen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Objekten, die Attribute oder Feldnamen von Microsoft Yammer-Inhalten Amazon Kendra Kendra-Indexfeldnamen zuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). |
| additionalProperties | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. |
| Einschlussmuster | Eine Liste von Mustern für reguläre Ausdrücke, um bestimmte Dateien in Ihre Microsoft Yammer-Datenquelle aufzunehmen. Dateien, die den Mustern entsprechen, werden in den Index eingeschlossen. Dateien, die nicht den Mustern entsprechen, werden aus dem Index ausgeschlossen. Wenn eine Datei sowohl einem Ein- als auch einem Ausschlussmuster entspricht, hat das Ausschlussmuster Vorrang und die Datei wird nicht in den Index eingeschlossen. |
| Ausschlussmuster | Eine Liste von Mustern für reguläre Ausdrücke zum Ausschließen bestimmter Dateien in Ihrer Microsoft Yammer-Datenquelle. Dateien, die dem Muster entsprechen, werden aus dem Index ausgeschlossen. Dateien, die den Mustern nicht entsprechen, werden in den Index eingeschlossen. Wenn eine Datei sowohl einem Aus- als auch einem Einschlussmuster entspricht, hat das Ausschlussmuster Vorrang und die Datei wird nicht in den Index eingeschlossen. |
| SinceDate | Sie können einen sinceDate Parameter so konfigurieren, dass der Microsoft Yammer-Connector Inhalte auf der Grundlage eines bestimmten Inhalts crawlt. sinceDate |
| communityNameFilter | Sie können wählen, ob bestimmte Community-Inhalte indexiert werden sollen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | trueum Nachrichten, Nachrichtenanhänge und private Nachrichten zu crawlen. |
| type | Geben Sie YAMMER als Datenquellentyp an. |
| secretARN | Der Amazon-Ressourcenname (ARN) eines AWS Secrets Manager Geheimnisses, das die Schlüssel-Wert-Paare enthält, die für die Verbindung mit Ihrem Microsoft Yammer erforderlich sind. Dazu gehören Ihr Microsoft Yammer-Benutzername und Ihr Passwort sowie Ihre Client-ID und Ihr Client-Geheimnis, die generiert werden, wenn Sie eine OAuth Anwendung im Azure-Portal erstellen. |
| useChangeLog | trueum anhand des Microsoft Yammer-Änderungsprotokolls zu ermitteln, welche Dokumente im Index aktualisiert werden müssen. |
| syncMode | Geben Sie an, wie Ihr Index aktualisiert werden Amazon Kendra soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Sie können wählen zwischen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| enableIdentityCrawler | trueum den Identity Crawler zu verwenden Amazon Kendra, um identity/principal Informationen über Benutzer und Gruppen mit Zugriff auf bestimmte Dokumente zu synchronisieren. Wenn Identity Crawler ausgeschaltet ist, können alle Dokumente öffentlich durchsucht werden. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen hochzuladen. |
### Microsoft Yammer-JSON-Schema
```
{
"$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"
]
}
```
## MySQL-Vorlagenschema
Sie fügen eine JSON-Datei ein, die das Datenquellenschema als Teil des [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekts enthält. Geben Sie den Typ der Datenquelle als`JDBC`, den Datenbanktyp als`mysql`, ein Geheimnis für Ihre Authentifizierungsdaten und andere erforderliche Konfigurationen an. Geben Sie dann `TEMPLATE` an`Type`, wann Sie anrufen [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Sie können die in diesem Entwicklerhandbuch enthaltene Vorlage verwenden. Siehe [MySQL JSON-Schema](#mysql-json).
In der folgenden Tabelle werden die Parameter des MySQL-JSON-Schemas beschrieben.
| Konfiguration | Description |
| --- | --- |
| connectionConfiguration | Konfigurationsinformationen für den Endpunkt für die Datenquelle. |
| repositoryEndpointMetadata | Erforderliche Konfigurationsinformationen für die Verbindung mit Ihrer Datenquelle.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. Beispielsweise die Konfiguration bestimmter Inhaltstypen und Feldzuordnungen. Geben Sie den Typ der Datenquelle und den geheimen ARN an. |
| document | Eine Liste von Objekten, die die Attribute oder Feldnamen Ihres Datenbankinhalts Amazon Kendra Indexfeldnamen zuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). |
| additionalProperties | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. Wird verwendet, um bestimmte Inhalte in Ihrer Datenbankdatenquelle ein- oder auszuschließen. |
| primaryKey | Geben Sie den Primärschlüssel für die Datenbanktabelle an. Dadurch wird eine Tabelle in Ihrer Datenbank identifiziert. |
| titleColumn | Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein. |
| bodyColumn | Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein. |
| sqlQuery | Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen müssen weniger als 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht. |
| timestampColumn | Geben Sie den Namen der Spalte ein, die Zeitstempel enthält. Amazon Kendra verwendet Zeitstempelinformationen, um Änderungen an Ihrem Inhalt zu erkennen und nur geänderte Inhalte zu synchronisieren. |
| timestampFormat | Geben Sie den Namen der Spalte ein, die Zeitstempelformate enthält, die verwendet werden sollen, um Inhaltsänderungen zu erkennen und Ihre Inhalte erneut zu synchronisieren. |
| timezone | Geben Sie den Namen der Spalte ein, die Zeitzonen für den Inhalt enthält, der durchsucht werden soll. |
| changeDetectingColumns | Geben Sie die Namen der Spalten ein, anhand derer Inhaltsänderungen erkannt Amazon Kendra werden sollen. Amazon Kendra indexiert den Inhalt neu, wenn sich eine dieser Spalten ändert |
| allowedUsersColumns | Geben Sie den Namen der Spalte ein, die den Benutzer IDs enthält, dem der Zugriff auf den Inhalt gewährt werden soll. |
| allowedGroupsColumn | Geben Sie den Namen der Spalte ein, die den Benutzer enthält IDs , dem der Zugriff auf Inhalte gewährt werden soll. |
| Quelle URIColumn | Geben Sie den Namen der Spalte ein, die die URLs zu indizierende Quelle enthält. |
| isSslEnabled | Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen müssen weniger als 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht. |
| type | Der Typ der Datenquelle. Geben Sie JDBC als Datenquellentyp an. |
| syncMode | Geben Sie an, wie Ihr Index aktualisiert werden Amazon Kendra soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Sie können wählen zwischen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| secretArn | Der Amazon-Ressourcenname (ARN) eines Secrets-Manager-Secrets, das den Benutzernamen und das Passwort enthält, die für die Verbindung mit Ihrer Datenbank erforderlich sind. Das Geheimnis muss eine JSON-Struktur mit den folgenden Schlüsseln enthalten: {
"user name": "database user name",
"password": "password"
} |
| version | Die Version der Vorlage, die derzeit unterstützt wird. |
### MySQL JSON-Schema
```
{
"$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"
]
}
```
## Oracle-Datenbank-Vorlagenschema
Sie fügen eine JSON-Datei ein, die das Datenquellenschema als Teil des [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekts enthält. Geben Sie den Typ der Datenquelle als`JDBC`, den Datenbanktyp als`oracle`, ein Geheimnis für Ihre Authentifizierungsdaten und andere erforderliche Konfigurationen an. Geben Sie dann `TEMPLATE` an`Type`, wann Sie anrufen [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Sie können die in diesem Entwicklerhandbuch enthaltene Vorlage verwenden. Siehe [JSON-Schema der Oracle-Datenbank](#oracle-database-json).
In der folgenden Tabelle werden die Parameter des Oracle Database-JSON-Schemas beschrieben.
| Konfiguration | Description |
| --- | --- |
| connectionConfiguration | Konfigurationsinformationen für den Endpunkt für die Datenquelle. |
| repositoryEndpointMetadata | Erforderliche Konfigurationsinformationen für die Verbindung mit Ihrer Datenquelle.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. Beispielsweise die Konfiguration bestimmter Inhaltstypen und Feldzuordnungen. Geben Sie den Typ der Datenquelle und den geheimen ARN an. |
| document | Eine Liste von Objekten, die die Attribute oder Feldnamen Ihres Datenbankinhalts Amazon Kendra Indexfeldnamen zuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). |
| additionalProperties | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. Wird verwendet, um bestimmte Inhalte in Ihrer Datenbankdatenquelle ein- oder auszuschließen. |
| primaryKey | Geben Sie den Primärschlüssel für die Datenbanktabelle an. Dadurch wird eine Tabelle in Ihrer Datenbank identifiziert. |
| titleColumn | Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein. |
| bodyColumn | Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein. |
| sqlQuery | Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen müssen weniger als 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht. |
| timestampColumn | Geben Sie den Namen der Spalte ein, die Zeitstempel enthält. Amazon Kendra verwendet Zeitstempelinformationen, um Änderungen an Ihrem Inhalt zu erkennen und nur geänderte Inhalte zu synchronisieren. |
| timestampFormat | Geben Sie den Namen der Spalte ein, die Zeitstempelformate enthält, die verwendet werden sollen, um Inhaltsänderungen zu erkennen und Ihre Inhalte erneut zu synchronisieren. |
| timezone | Geben Sie den Namen der Spalte ein, die Zeitzonen für den Inhalt enthält, der durchsucht werden soll. |
| changeDetectingColumns | Geben Sie die Namen der Spalten ein, anhand derer Inhaltsänderungen erkannt Amazon Kendra werden sollen. Amazon Kendra indexiert den Inhalt neu, wenn sich eine dieser Spalten ändert |
| allowedUsersColumns | Geben Sie den Namen der Spalte ein, die den Benutzer IDs enthält, dem der Zugriff auf den Inhalt gewährt werden soll. |
| allowedGroupsColumn | Geben Sie den Namen der Spalte ein, die den Benutzer enthält IDs , dem der Zugriff auf Inhalte gewährt werden soll. |
| Quelle URIColumn | Geben Sie den Namen der Spalte ein, die die URLs zu indizierende Quelle enthält. |
| isSslEnabled | Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen müssen weniger als 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht. |
| type | Der Typ der Datenquelle. Geben Sie JDBC als Datenquellentyp an. |
| syncMode | Geben Sie an, wie Ihr Index aktualisiert werden Amazon Kendra soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Sie können wählen zwischen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| secretArn | Der Amazon-Ressourcenname (ARN) eines Secrets-Manager-Secrets, das den Benutzernamen und das Passwort enthält, die für die Verbindung mit Ihrer Datenbank erforderlich sind. Das Geheimnis muss eine JSON-Struktur mit den folgenden Schlüsseln enthalten: {
"user name": "database user name",
"password": "password"
} |
| version | Die Version der Vorlage, die derzeit unterstützt wird. |
### JSON-Schema der Oracle-Datenbank
```
{
"$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"
]
}
```
## PostgreSQL-Vorlagenschema
Sie fügen eine JSON-Datei ein, die das Datenquellenschema als Teil des [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekts enthält. Geben Sie den Typ der Datenquelle als`JDBC`, den Datenbanktyp als`postgresql`, ein Geheimnis für Ihre Authentifizierungsdaten und andere erforderliche Konfigurationen an. Geben Sie dann `TEMPLATE` an`Type`, wann Sie anrufen [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Sie können die in diesem Entwicklerhandbuch enthaltene Vorlage verwenden. Siehe [PostgreSQL JSON-Schema](#postgresql-json).
In der folgenden Tabelle werden die Parameter des PostgreSQL-JSON-Schemas beschrieben.
| Konfiguration | Description |
| --- | --- |
| connectionConfiguration | Konfigurationsinformationen für den Endpunkt für die Datenquelle. |
| repositoryEndpointMetadata | Erforderliche Konfigurationsinformationen für die Verbindung mit Ihrer Datenquelle.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. Beispielsweise die Konfiguration bestimmter Inhaltstypen und Feldzuordnungen. Geben Sie den Typ der Datenquelle und den geheimen ARN an. |
| document | Eine Liste von Objekten, die die Attribute oder Feldnamen Ihres Datenbankinhalts Amazon Kendra Indexfeldnamen zuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). |
| additionalProperties | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. Wird verwendet, um bestimmte Inhalte in Ihrer Datenbankdatenquelle ein- oder auszuschließen. |
| primaryKey | Geben Sie den Primärschlüssel für die Datenbanktabelle an. Dadurch wird eine Tabelle in Ihrer Datenbank identifiziert. |
| titleColumn | Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein. |
| bodyColumn | Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein. |
| sqlQuery | Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen müssen weniger als 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht. |
| timestampColumn | Geben Sie den Namen der Spalte ein, die Zeitstempel enthält. Amazon Kendra verwendet Zeitstempelinformationen, um Änderungen an Ihrem Inhalt zu erkennen und nur geänderte Inhalte zu synchronisieren. |
| timestampFormat | Geben Sie den Namen der Spalte ein, die Zeitstempelformate enthält, die verwendet werden sollen, um Inhaltsänderungen zu erkennen und Ihre Inhalte erneut zu synchronisieren. |
| timezone | Geben Sie den Namen der Spalte ein, die Zeitzonen für den Inhalt enthält, der durchsucht werden soll. |
| changeDetectingColumns | Geben Sie die Namen der Spalten ein, anhand derer Inhaltsänderungen erkannt Amazon Kendra werden sollen. Amazon Kendra indexiert den Inhalt neu, wenn sich eine dieser Spalten ändert |
| allowedUsersColumns | Geben Sie den Namen der Spalte ein, die den Benutzer IDs enthält, dem der Zugriff auf den Inhalt gewährt werden soll. |
| allowedGroupsColumn | Geben Sie den Namen der Spalte ein, die den Benutzer enthält IDs , dem der Zugriff auf Inhalte gewährt werden soll. |
| Quelle URIColumn | Geben Sie den Namen der Spalte ein, die die URLs zu indizierende Quelle enthält. |
| isSslEnabled | Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen müssen weniger als 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht. |
| type | Der Typ der Datenquelle. Geben Sie JDBC als Datenquellentyp an. |
| syncMode | Geben Sie an, wie Ihr Index aktualisiert werden Amazon Kendra soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Sie können wählen zwischen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| secretArn | Der Amazon-Ressourcenname (ARN) eines Secrets-Manager-Secrets, das den Benutzernamen und das Passwort enthält, die für die Verbindung mit Ihrer Datenbank erforderlich sind. Das Geheimnis muss eine JSON-Struktur mit den folgenden Schlüsseln enthalten: {
"user name": "database user name",
"password": "password"
} |
| version | Die Version der Vorlage, die derzeit unterstützt wird. |
### PostgreSQL JSON-Schema
```
{
"$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"
]
}
```
## Salesforce-Vorlagenschema
Sie fügen eine JSON-Datei ein, die das Datenquellenschema als Teil des [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekts enthält. Sie geben die Salesforce-Host-URL als Teil der Verbindungskonfiguration oder der Repository-Endpunktdetails an. Geben Sie außerdem den Typ der Datenquelle als `SALESFORCEV2` ein Geheimnis für Ihre Authentifizierungsdaten und andere erforderliche Konfigurationen an. Geben Sie dann `TEMPLATE` an`Type`, wann Sie anrufen [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Sie können die in diesem Entwicklerhandbuch enthaltene Vorlage verwenden. Siehe [Salesforce-JSON-Schema](#salesforce-json).
In der folgenden Tabelle werden die Parameter des Salesforce-JSON-Schemas beschrieben.
| Konfiguration | Description |
| --- | --- |
| connectionConfiguration | Konfigurationsinformationen für den Endpunkt für die Datenquelle. |
| repositoryEndpointMetadata | Die Endpunktinformationen für die Datenquelle. |
| hostUrl | Die URL der Salesforce-Instanz, die indexiert werden soll. |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. Beispielsweise die Konfiguration bestimmter Inhaltstypen und Feldzuordnungen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Objekten, die die Attribute oder Feldnamen Ihrer Salesforce-Entitäten Amazon Kendra Indexfeldnamen zuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). |
| secretARN | Der Amazon-Ressourcenname (ARN) eines AWS Secrets Manager Geheimnisses, das die Schlüssel-Wert-Paare enthält, die für die Verbindung mit Ihrem Salesforce erforderlich sind. Das Geheimnis muss eine JSON-Struktur mit den folgenden Schlüsseln enthalten: {
"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 | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Sammlung von Zeichenfolgen, die angeben, welche Entitäten gefiltert werden sollen. |
| Einschlussmuster [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Mustern für reguläre Ausdrücke, um bestimmte Dateien in Ihre Salesforce-Datenquelle aufzunehmen. Dateien, die den Mustern entsprechen, werden in den Index eingeschlossen. Dateien, die nicht den Mustern entsprechen, werden aus dem Index ausgeschlossen. Wenn eine Datei sowohl einem Ein- als auch einem Ausschlussmuster entspricht, hat das Ausschlussmuster Vorrang und die Datei wird nicht in den Index eingeschlossen. |
| Ausschlussmuster [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Mustern mit regulären Ausdrücken zum Ausschließen bestimmter Dateien in Ihrer Salesforce-Datenquelle. Dateien, die dem Muster entsprechen, werden aus dem Index ausgeschlossen. Dateien, die den Mustern nicht entsprechen, werden in den Index eingeschlossen. Wenn eine Datei sowohl einem Aus- als auch einem Einschlussmuster entspricht, hat das Ausschlussmuster Vorrang und die Datei wird nicht in den Index eingeschlossen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | trueum diese Arten von Dateien in Ihrem Salesforce-Konto zu crawlen. |
| type | Der Typ der Datenquelle. Geben Sie SALESFORCEV2 als Datenquellentyp an. |
| enableIdentityCrawler | trueum den Identity Crawler zu verwenden Amazon Kendra, um identity/principal Informationen über Benutzer und Gruppen mit Zugriff auf bestimmte Dokumente zu synchronisieren. Wenn Identity Crawler ausgeschaltet ist, können alle Dokumente öffentlich durchsucht werden. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen hochzuladen. |
| syncMode | Geben Sie an, wie Ihr Index aktualisiert werden Amazon Kendra soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Sie können wählen zwischen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| version | Die Version dieser Vorlage, die derzeit unterstützt wird. |
### Salesforce-JSON-Schema
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties":
{
"connectionConfiguration": {
"type": "object",
"properties":
{
"repositoryEndpointMetadata":
{
"type": "object",
"properties":
{
"hostUrl":
{
"type": "string",
"pattern": "https:.*"
}
},
"required":
[
"hostUrl"
]
}
},
"required":
[
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties":
{
"account":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE",
"LONG"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"contact":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"campaign":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE",
"LONG"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"case":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"product":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"lead":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE",
"LONG"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"contract":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"partner":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"profile":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"idea":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE",
"LONG"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"pricebook":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"task":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"solution":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"attachment":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE",
"LONG"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"user":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"document":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE",
"LONG"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"knowledgeArticles":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"group":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"opportunity":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE",
"LONG"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"chatter":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"customEntity":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
}
}
},
"additionalProperties": {
"type": "object",
"properties":
{
"accountFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"contactFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"caseFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"campaignFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"contractFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"groupFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"leadFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"productFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"opportunityFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"partnerFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"pricebookFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"ideaFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"profileFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"taskFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"solutionFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"userFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"chatterFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"documentFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"knowledgeArticleFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"customEntities":{
"type": "array",
"items":
{
"type": "string"
}
},
"isCrawlAccount": {
"type": "boolean"
},
"isCrawlContact": {
"type": "boolean"
},
"isCrawlCase": {
"type": "boolean"
},
"isCrawlCampaign": {
"type": "boolean"
},
"isCrawlProduct": {
"type": "boolean"
},
"isCrawlLead": {
"type": "boolean"
},
"isCrawlContract": {
"type": "boolean"
},
"isCrawlPartner": {
"type": "boolean"
},
"isCrawlProfile": {
"type": "boolean"
},
"isCrawlIdea": {
"type": "boolean"
},
"isCrawlPricebook": {
"type": "boolean"
},
"isCrawlDocument": {
"type": "boolean"
},
"crawlSharedDocument": {
"type": "boolean"
},
"isCrawlGroup": {
"type": "boolean"
},
"isCrawlOpportunity": {
"type": "boolean"
},
"isCrawlChatter": {
"type": "boolean"
},
"isCrawlUser": {
"type": "boolean"
},
"isCrawlSolution":{
"type": "boolean"
},
"isCrawlTask":{
"type": "boolean"
},
"isCrawlAccountAttachments": {
"type": "boolean"
},
"isCrawlContactAttachments": {
"type": "boolean"
},
"isCrawlCaseAttachments": {
"type": "boolean"
},
"isCrawlCampaignAttachments": {
"type": "boolean"
},
"isCrawlLeadAttachments": {
"type": "boolean"
},
"isCrawlContractAttachments": {
"type": "boolean"
},
"isCrawlGroupAttachments": {
"type": "boolean"
},
"isCrawlOpportunityAttachments": {
"type": "boolean"
},
"isCrawlChatterAttachments": {
"type": "boolean"
},
"isCrawlSolutionAttachments":{
"type": "boolean"
},
"isCrawlTaskAttachments":{
"type": "boolean"
},
"isCrawlCustomEntityAttachments":{
"type": "boolean"
},
"isCrawlKnowledgeArticles": {
"type": "object",
"properties":
{
"isCrawlDraft": {
"type": "boolean"
},
"isCrawlPublish": {
"type": "boolean"
},
"isCrawlArchived": {
"type": "boolean"
}
}
},
"inclusionDocumentFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionDocumentFileTypePatterns": {
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionDocumentFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionDocumentFileNamePatterns": {
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionAccountFileTypePatterns": {
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionAccountFileTypePatterns": {
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionAccountFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionAccountFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionCampaignFileTypePatterns": {
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionCampaignFileTypePatterns": {
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionCampaignFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionCampaignFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionCaseFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionCaseFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionCaseFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionCaseFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionContactFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionContactFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionContactFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionContactFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionContractFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionContractFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionContractFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionContractFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionLeadFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionLeadFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionLeadFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionLeadFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionOpportunityFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionOpportunityFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionOpportunityFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionOpportunityFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionSolutionFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionSolutionFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionSolutionFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionSolutionFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionTaskFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionTaskFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionTaskFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionTaskFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionGroupFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionGroupFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionGroupFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionGroupFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionChatterFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionChatterFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionChatterFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionChatterFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionCustomEntityFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionCustomEntityFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionCustomEntityFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionCustomEntityFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
}
},
"required":
[]
},
"enableIdentityCrawler": {
"type": "boolean"
},
"type": {
"type": "string",
"pattern": "SALESFORCEV2"
},
"syncMode": {
"type": "string",
"enum": [
"FULL_CRAWL",
"FORCED_FULL_CRAWL",
"CHANGE_LOG"
]
},
"secretArn": {
"type": "string",
"minLength": 20,
"maxLength": 2048
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"syncMode",
"additionalProperties",
"secretArn",
"type"
]
}
```
## ServiceNow Vorlagenschema
Sie fügen eine JSON-Datei ein, die das Datenquellenschema als Teil des [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekts enthält. Sie geben die ServiceNow Host-URL, den Authentifizierungstyp und die Instanzversion als Teil der Verbindungskonfiguration oder der Repository-Endpunktdetails an. Geben Sie außerdem den Typ der Datenquelle als`SERVICENOWV2`, ein Geheimnis für Ihre Authentifizierungsdaten und andere erforderliche Konfigurationen an. Geben Sie dann `TEMPLATE` an`Type`, wann Sie anrufen [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Sie können die in diesem Entwicklerhandbuch enthaltene Vorlage verwenden. Siehe [ServiceNow JSON-Schema](#servicenow-json).
In der folgenden Tabelle werden die Parameter des ServiceNow JSON-Schemas beschrieben.
| Konfiguration | Description |
| --- | --- |
| connectionConfiguration | Konfigurationsinformationen für den Endpunkt für die Datenquelle. |
| repositoryEndpointMetadata | Die Endpunktinformationen für die Datenquelle. |
| hostUrl | Die ServiceNow Host-URL. Beispiel, your-domain.service-now.com. |
| authType | Der verwendete Authentifizierungstyp, ob basicAuth oder OAuth2. |
| servicenowInstanceVersion | Die ServiceNow Version, die Sie verwenden. Sie können zwischenTokyo, SandiegoRome, und wählenOthers. |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. Beispielsweise die Konfiguration bestimmter Inhaltstypen und Feldzuordnungen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Objekten, die die Attribute oder Feldnamen Ihrer ServiceNow Wissensartikel, Anlagen, Servicekataloge und Vorfälle den Amazon Kendra Indexfeldnamen zuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). Die Feldnamen der ServiceNow Datenquellen müssen in Ihren ServiceNow benutzerdefinierten Metadaten vorhanden sein. |
| zusätzliche Eigenschaften | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. |
| maxFileSizeInMegaBytes | Geben Sie die Dateigrößenbeschränkung an MBs , die Amazon Kendra crawlt. Amazon Kendra crawlt nur die Dateien innerhalb der von Ihnen definierten Größenbeschränkung. Die Standarddateigröße ist 50 MB. Die maximale Dateigröße sollte größer als 0 MB und kleiner oder gleich 50 MB sein. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Mustern für reguläre Ausdrücke, die bestimmte Dateien in Ihre ServiceNow Datenquelle aufnehmen und and/or ausschließen sollen. Dateien, die den Mustern entsprechen, werden in den Index eingeschlossen. Dateien, die nicht den Mustern entsprechen, werden aus dem Index ausgeschlossen. Wenn eine Datei sowohl einem Ein- als auch einem Ausschlussmuster entspricht, hat das Ausschlussmuster Vorrang und die Datei wird nicht in den Index eingeschlossen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | trueum ServiceNow Wissensartikel, Servicekataloge, Vorfälle und Anlagen zu crawlen. |
| type | Der Typ der Datenquelle. Geben Sie SERVICENOWV2 als Datenquellentyp an. |
| enableIdentityCrawler | trueum den Identity Crawler zu verwenden Amazon Kendra, um identity/principal Informationen über Benutzer und Gruppen mit Zugriff auf bestimmte Dokumente zu synchronisieren. Wenn Identity Crawler ausgeschaltet ist, können alle Dokumente öffentlich durchsucht werden. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen hochzuladen. |
| syncMode | Geben Sie an, wie Ihr Index aktualisiert werden Amazon Kendra soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Sie können wählen zwischen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| secretARN | Der Amazon-Ressourcenname (ARN) eines AWS Secrets Manager Geheimnisses, das die Schlüssel-Wert-Paare enthält, die für die Verbindung mit Ihrem erforderlich sind. ServiceNow Das Geheimnis muss eine JSON-Struktur mit den folgenden Schlüsseln enthalten: {
"username": "user name",
"password": "password"
} Wenn Sie die OAuth2 Authentifizierung verwenden, muss Ihr Geheimnis eine JSON-Struktur mit den folgenden Schlüsseln enthalten: {
"username": "user name",
"password": "password",
"clientId": "client id",
"clientSecret": "client secret"
} |
| version | Die Version der Vorlage, die derzeit unterstützt wird. |
### ServiceNow JSON-Schema
```
{
"$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"
]
}
```
## Slack-Vorlagenschema
Du fügst eine JSON-Datei ein, die das Datenquellenschema als Teil des [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekts enthält. Sie geben die Host-URL als Teil der Verbindungskonfiguration oder der Repository-Endpunktdetails an. Geben Sie außerdem den Typ der Datenquelle`SLACK`, ein Geheimnis für Ihre Authentifizierungsdaten und andere erforderliche Konfigurationen an. Geben Sie dann `TEMPLATE` an`Type`, wann Sie anrufen [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Sie können die in diesem Entwicklerhandbuch enthaltene Vorlage verwenden. Siehe [JSON-Schema von Slack](#slack-json).
In der folgenden Tabelle werden die Parameter des JSON-Schemas von Slack beschrieben.
| Konfiguration | Description |
| --- | --- |
| connectionConfiguration | Konfigurationsinformationen für den Endpunkt für die Datenquelle. |
| repositoryEndpointMetadata | Die Endpunktinformationen für die Datenquelle. |
| teamId | Die Slack-Team-ID, die du von der URL deiner Slack-Hauptseite kopiert hast. |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. Beispielsweise die Konfiguration bestimmter Inhaltstypen und Feldzuordnungen. |
| Alle | Eine Liste von Objekten, die die Attribute oder Feldnamen deiner Slack Inhalte Amazon Kendra Indexfeldnamen zuordnen. |
| additionalProperties | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. |
| Einschlussmuster | Eine Liste mit Mustern für reguläre Ausdrücke, um bestimmte Inhalte in Ihrer Slack-Datenquelle einzuschließen. Elemente, die den Mustern entsprechen, werden in den Index eingeschlossen. Inhalte, die nicht den Mustern entsprechen, werden aus dem Index ausgeschlossen. Wenn Inhalte sowohl einem Ein- als auch einem Ausschlussmuster entsprechen, hat das Ausschlussmuster Vorrang und die Inhalte werden nicht in den Index eingeschlossen. |
| Ausschlussmuster | Eine Liste mit Mustern für reguläre Ausdrücke, um bestimmte Inhalte in Ihrer Slack-Datenquelle auszuschließen. Inhalte, die den Mustern entsprechen, werden aus dem Index ausgeschlossen. Inhalte, die nicht mit den Mustern übereinstimmen, werden in den Index aufgenommen. Wenn Inhalte sowohl einem Ein- als auch einem Ausschlussmuster entsprechen, hat das Ausschlussmuster Vorrang und die Inhalte werden nicht in den Index eingeschlossen. |
| crawlBotMessages | trueum Bot-Nachrichten zu crawlen. |
| Archivierte ausschließen | trueum das Crawlen archivierter Nachrichten auszuschließen. |
| Art der Konversation | Die Art der Konversation, die Sie indizieren möchtenPUBLIC\$1CHANNEL, obPRIVATE\$1CHANNEL, GROUP\$1MESSAGE und. DIRECT\$1MESSAGE |
| ChannelFilter | Der Channel-Typ, den Sie indexieren möchten, ob private\$1channel oder public\$1channel. |
| Seit dem Datum | Sie können den Parameter sinceDate so konfigurieren, dass der Slack-Konnektor Inhalte auf der Basis eines bestimmten Werts für sinceDate crawlt. |
| Schau zurück | Sie können einen lookBack Parameter so konfigurieren, dass der Slack Connector aktualisierte oder gelöschte Inhalte bis zu einer bestimmten Anzahl von Stunden vor Ihrer letzten Connector-Synchronisierung crawlt. |
| syncMode | Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Sie können wählen zwischen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) |
| type | Der Typ der Datenquelle. Geben Sie SLACK als Datenquellentyp an. |
| enableIdentityCrawler | trueum den Identity Crawler zu verwenden Amazon Kendra, um identity/principal Informationen über Benutzer und Gruppen mit Zugriff auf bestimmte Dokumente zu synchronisieren. Wenn Identity Crawler ausgeschaltet ist, können alle Dokumente öffentlich durchsucht werden. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen hochzuladen. |
| secretArn | Der Amazon-Ressourcenname (ARN) eines AWS Secrets Manager Geheimnisses, das die Schlüssel-Wert-Paare enthält, die für die Verbindung mit Ihrem erforderlich sind. Slack Das Geheimnis muss eine JSON-Struktur mit den folgenden Schlüsseln enthalten: {
"slackToken": "token"
} |
| version | Die Version dieser Vorlage, die derzeit unterstützt wird. |
### JSON-Schema von Slack
```
{
"$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"
]
}
```
## Zendesk-Vorlagenschema
Sie fügen eine JSON-Datei hinzu, die das Datenquellenschema als Teil des [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekts enthält. Sie geben die Host-URL als Teil der Verbindungskonfiguration oder der Repository-Endpunktdetails an. Geben Sie außerdem den Typ der Datenquelle`ZENDESK`, ein Geheimnis für Ihre Authentifizierungsdaten und andere erforderliche Konfigurationen an. Geben Sie dann `TEMPLATE` an`Type`, wann Sie anrufen [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Sie können die in diesem Entwicklerhandbuch enthaltene Vorlage verwenden. Siehe [Zendesk-JSON-Schema](#zendesk-json).
In der folgenden Tabelle werden die Parameter des Zendesk-JSON-Schemas beschrieben.
| Konfiguration | Description |
| --- | --- |
| connectionConfiguration | Konfigurationsinformationen für den Endpunkt für die Datenquelle. |
| repositoryEndpointMetadata | Die Endpunktinformationen für die Datenquelle. |
| Host-URL | Die Zendesk-Host-URL. Beispiel, https://yoursubdomain.zendesk.com. |
| repositoryConfigurations | Konfigurationsinformationen für den Inhalt der Datenquelle. Beispielsweise die Konfiguration bestimmter Inhaltstypen und Feldzuordnungen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Eine Liste von Objekten, die Attribute oder Feldnamen von Zendesk-Tickets den Indexfeldnamen von Amazon Kendra zuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). |
| secretARN | Der Amazon-Ressourcenname (ARN) eines AWS Secrets Manager Geheimnisses, das die Schlüssel-Wert-Paare enthält, die für die Verbindung mit Ihrem Zendesk erforderlich sind. Das Geheimnis muss eine JSON-Struktur mit den folgenden Schlüsseln enthalten: Host-URL, Client-ID, Client-Geheimnis, Benutzername und Passwort. |
| additionalProperties | Zusätzliche Konfigurationsoptionen für die Inhalte in Ihrer Datenquelle. |
| organizationNameFilter | Sie können sich dafür entscheiden, Tickets zu indexieren, die innerhalb einer bestimmten Organisation existieren. |
| Seit Datum | Sie können einen sinceDate Parameter so konfigurieren, dass der Zendesk-Connector Inhalte auf der Grundlage eines bestimmten Inhalts crawlt. sinceDate |
| Einschlussmuster | Eine Liste von Mustern für reguläre Ausdrücke, um bestimmte Dateien in Ihre Zendesk-Datenquelle aufzunehmen. Dateien, die den Mustern entsprechen, werden in den Index eingeschlossen. Dateien, die nicht den Mustern entsprechen, werden aus dem Index ausgeschlossen. Wenn eine Datei sowohl einem Ein- als auch einem Ausschlussmuster entspricht, hat das Ausschlussmuster Vorrang und die Datei wird nicht in den Index eingeschlossen. |
| Ausschlussmuster | Eine Liste mit Mustern für reguläre Ausdrücke, mit denen Sie bestimmte Dateien in Ihrer Zendesk-Datenquelle ausschließen können. Dateien, die dem Muster entsprechen, werden aus dem Index ausgeschlossen. Dateien, die den Mustern nicht entsprechen, werden in den Index eingeschlossen. Wenn eine Datei sowohl einem Aus- als auch einem Einschlussmuster entspricht, hat das Ausschlussmuster Vorrang und die Datei wird nicht in den Index eingeschlossen. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/ds-schemas.html) | Geben Sie "true" ein, um diese Arten von Inhalten zu crawlen. |
| type | Geben Sie ZENDESK als Datenquellentyp an. |
| useChangeLog | Geben Sie "true" ein, um anhand des Zendesk-Änderungsprotokolls zu ermitteln, welche Dokumente im Index aktualisiert werden müssen. Je nach Größe des Änderungsprotokolls ist es möglicherweise schneller, die Dokumente in Zendesk zu scannen. Wenn Sie Ihre Zendesk-Datenquelle zum ersten Mal mit Ihrem Index synchronisieren, werden alle Dokumente gescannt. |
### Zendesk-JSON-Schema
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"hostUrl": {
"type": "string",
"pattern": "https:.*"
}
},
"required": [
"hostUrl"
]
}
},
"required": [
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"ticket": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "LONG", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "dd-MM-yyyy HH:mm:ss"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
},
"ticketComment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "LONG", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "dd-MM-yyyy HH:mm:ss"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
},
"ticketCommentAttachment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "LONG", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "dd-MM-yyyy HH:mm:ss"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
},
"article": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "LONG", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "dd-MM-yyyy HH:mm:ss"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
},
"communityPostComment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "LONG", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "dd-MM-yyyy HH:mm:ss"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
},
"articleComment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "LONG", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "dd-MM-yyyy HH:mm:ss"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
},
"articleAttachment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "LONG", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "dd-MM-yyyy HH:mm:ss"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
},
"communityTopic": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "LONG", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "dd-MM-yyyy HH:mm:ss"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
}
}
},
"secretArn": {
"type": "string",
"minLength": 20,
"maxLength": 2048
},
"additionalProperties": {
"type": "object",
"properties": {
"organizationNameFilter": {
"type": "array"
},
"sinceDate": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}:[0-9]{2}$"
},
"inclusionPatterns": {
"type": "array"
},
"exclusionPatterns": {
"type": "array"
},
"isCrawTicket": {
"type": "string"
},
"isCrawTicketComment": {
"type": "string"
},
"isCrawTicketCommentAttachment": {
"type": "string"
},
"isCrawlArticle": {
"type": "string"
},
"isCrawlArticleAttachment": {
"type": "string"
},
"isCrawlArticleComment": {
"type": "string"
},
"isCrawlCommunityTopic": {
"type": "string"
},
"isCrawlCommunityPost": {
"type": "string"
},
"isCrawlCommunityPostComment": {
"type": "string"
}
}
},
"type": {
"type": "string",
"pattern": "ZENDESK"
},
"useChangeLog": {
"type": "string",
"enum": ["true", "false"]
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"additionalProperties": false,
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"additionalProperties",
"useChangeLog",
"secretArn",
"type"
]
}
```
# Adobe Experience Manager
**Anmerkung**
Der Adobe Experience Manager Connector wird für Bestandskunden bis zum 31. Mai 2026 weiterhin vollständig unterstützt. Dieser Konnektor ist zwar nicht mehr für neue Benutzer verfügbar, aktuelle Benutzer können ihn jedoch weiterhin ohne Unterbrechung verwenden. Wir entwickeln unser Konnektor-Portfolio kontinuierlich weiter, um besser skalierbare und anpassbare Lösungen anbieten zu können. Für future Integrationen empfehlen wir, sich mit dem Amazon Kendra Custom Connector Framework [1] vertraut zu machen, das ein breiteres Spektrum von Unternehmensanwendungsfällen mit verbesserter Flexibilität unterstützt.
Adobe Experience Managerist ein Content-Management-System, das für die Erstellung von Inhalten für Websites oder mobile Apps verwendet wird. Sie können Amazon Kendra es verwenden, um eine Verbindung zu Ihren Seiten Adobe Experience Manager und Inhaltsressourcen herzustellen und diese zu indizieren.
Amazon Kendraunterstützt Adobe Experience Manager (AEM) als Cloud Service-Autoreninstanz und als Adobe Experience Manager On-Premise-Instanz zum Verfassen und Veröffentlichen.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) oder die API eine Verbindung zu Ihrer Adobe Experience Manager Datenquelle herstellen. [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Adobe Experience Manager-Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-aem)
+ [
## Voraussetzungen
](#prerequisites-aem)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-aem)
## Unterstützte Features
Adobe Experience ManagerDer Datenquellen-Connector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ OAuth 2.0 und Standardauthentifizierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Adobe Experience Manager Datenquelle Amazon Kendra zum Indizieren verwenden können, müssen Sie diese Änderungen in Ihren AWS Konten Adobe Experience Manager und Konten vornehmen.
**Stellen Sie in Adobe Experience Manager Folgendes sicher:**
+ Zugriff auf ein Konto mit Administratorrechten oder auf einen Admin-Benutzer.
+ Sie haben Ihre Adobe Experience Manager-Host-URL kopiert.
**Anmerkung**
(On-Premise/Server) Amazon Kendra überprüft, ob die in AWS Secrets Manager der Datei enthaltenen Endpunktinformationen mit den Endpunktinformationen übereinstimmen, die in den Konfigurationsdetails Ihrer Datenquelle angegeben sind. Dies trägt zum Schutz vor dem [Problem des verwirrten Stellvertreters](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html) bei, bei dem es sich um ein Sicherheitsproblem handelt, bei dem ein Benutzer nicht berechtigt ist, eine Aktion auszuführen, sondern ihn Amazon Kendra als Proxy verwendet, um auf das konfigurierte Geheimnis zuzugreifen und die Aktion auszuführen. Wenn Sie Ihre Endpunktinformationen später ändern, müssen Sie ein neues Geheimnis erstellen, um diese Informationen zu synchronisieren.
+ Haben Sie sich Ihre grundlegenden Authentifizierungsdaten mit Admin-Benutzername und Passwort notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ **Optional**: Konfigurierte OAuth 2.0-Anmeldeinformationen in Adobe Experience Manager (AEM) als Cloud-Service oder AEM On-Premise. Wenn Sie AEM On-Premise verwenden, umfassen die Anmeldeinformationen die Client-ID, den geheimen Client-Schlüssel und den privaten Schlüssel. Wenn Sie AEM als Cloud-Dienst verwenden, umfassen die Anmeldeinformationen die Client-ID, den geheimen Client-Schlüssel, den privaten Schlüssel, die Organisations-ID, die technische Konto-ID und den Adobe Identity Management System (IMS-) Host. [Weitere Informationen zum Generieren dieser Anmeldeinformationen für AEM as a Cloud Service finden Sie Adobe Experience Manager in der Dokumentation.](https://experienceleague.adobe.com/docs/experience-manager-learn/getting-started-with-aem-headless/authentication/service-credentials.html) Für AEM On-Premise bietet die Adobe Granite OAuth 2.0-Serverimplementierung (com.adobe.granite.oauth.server) die Unterstützung für OAuth 2.0-Serverfunktionen in AEM.
+ Aktiviert, dass jedes Dokument in Adobe Experience Manager und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Sie haben Ihre Adobe Experience Manager-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Adobe Experience Manager-Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Amazon KendraUm eine Verbindung mit Ihrer Adobe Experience Manager Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Adobe Experience Manager Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie noch keine Konfiguration Adobe Experience Manager für vorgenommen habenAmazon Kendra, finden Sie weitere Informationen unter[Voraussetzungen](#prerequisites-aem).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen Adobe Experience Manager**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite „**Datenquelle hinzufügen**“ die Option „**Adobe Experience Manager-Connector**“ und anschließend „**Konnektor hinzufügen**“. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Adobe Experience Manager-Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Quelle** — Wählen Sie entweder **AEM On-Premise** oder **AEM as** a Cloud Service.
Geben Sie Ihre Host-URL ein. Adobe Experience Manager Wenn Sie beispielsweise AEM On-Premise verwenden, geben Sie den Hostnamen und den Port an: *https://hostname:port*. Wenn Sie AEM als Cloud-Service verwenden, können Sie auch die Autoren-URL verwenden: *https://author-xxxxxx-xxxxxxx.adobeaemcloud.com*.
1. **Speicherort des SSL-Zertifikats** — Geben Sie den Pfad zu dem in einem Amazon S3 Bucket gespeicherten SSL-Zertifikat ein. Sie verwenden dies, um über eine sichere SSL-Verbindung eine Verbindung zu AEM On-Premise herzustellen.
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **Authentifizierung** — Wählen Sie **Standardauthentifizierung** oder **OAuth 2.0-Authentifizierung**. Wählen Sie dann ein vorhandenes AWS Secrets Manager Geheimnis aus oder erstellen Sie ein neues Geheimnis, um Ihre Adobe Experience Manager Anmeldeinformationen zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
Wenn Sie sich für die **Standardauthentifizierung** entschieden haben, geben Sie einen Namen für das Geheimnis, den Adobe Experience Manager Site-Benutzernamen und das Passwort ein. Der Benutzer muss über Administratorrechte verfügen oder ein Admin-Benutzer sein.
Wenn Sie sich für die **OAuth 2.0-Authentifizierung** entschieden haben und AEM On-Premise verwenden, geben Sie einen Namen für das Geheimnis, die Client-ID, den geheimen Client-Schlüssel und den privaten Schlüssel ein. Wenn Sie AEM als Cloud-Dienst verwenden, geben Sie einen Namen für das Geheimnis, die Client-ID, den geheimen Client-Schlüssel, den privaten Schlüssel, die Organisations-ID, die technische Konto-ID und den Adobe Identity Management System (IMS-) Host ein.
Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) der Suchergebnisse zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. **Synchronisierungsbereich** — Legen Sie Grenzwerte für das Crawlen bestimmter Inhaltstypen, Seitenkomponenten und Stammpfade fest und filtern Sie Inhalte mithilfe von Regex-Ausdrucksmustern.
1. **Inhaltstypen** — Wählen Sie aus, ob nur Seiten oder Assets oder beides gecrawlt werden sollen.
1. (Optional) **Zusätzliche Konfiguration** — Konfigurieren Sie die folgenden Einstellungen:
+ **Seitenkomponenten** — Die spezifischen Namen der Seitenkomponenten. Die Seitenkomponente ist eine erweiterbare Seitenkomponente, die für die Zusammenarbeit mit dem Adobe Experience Manager Vorlageneditor entwickelt wurde und die Zusammenstellung von Seiten header/footer - und Strukturkomponenten mit dem Vorlageneditor ermöglicht.
+ **Variationen von Inhaltsfragmenten** — Die spezifischen Namen der Varianten von Inhaltsfragmenten. Mithilfe von Inhaltsfragmenten können Sie seitenunabhängige Inhalte in Adobe Experience Manager entwerfen, erstellen, pflegen und veröffentlichen. Sie ermöglichen es Ihnen, Inhalte für die Verwendung in locations/over mehreren Kanälen vorzubereiten.
+ **Stammpfade** — Die Stammpfade zu bestimmten Inhalten.
+ **Regex-Muster** — Die regulären Ausdrucksmuster zum Ein- oder Ausschließen bestimmter Seiten und Elemente.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. **Zeitzonen-ID** — Wenn Sie AEM On-Premise verwenden und sich die Zeitzone Ihres Servers von der Zeitzone des Amazon Kendra AEM-Connectors oder -Indexes unterscheidet, können Sie die Serverzeitzone so angeben, dass sie mit dem AEM-Connector oder Index übereinstimmt. Die Standardzeitzone für AEM On-Premise ist die Zeitzone des AEM-Connectors oder -Indexes. Amazon Kendra Die Standardzeitzone für AEM as a Cloud Service ist Greenwich Mean Time.
1. **Zeitplan für Synchronisierungsläufe**, **Häufigkeit** — Wählen Sie aus, wie oft Ihre Datenquelleninhalte synchronisiert und Ihr Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den Amazon Kendra generierten Standard-Datenquellenfeldern aus, die Sie Ihrem Index zuordnen möchten. Um benutzerdefinierte Datenquellenfelder hinzuzufügen, erstellen Sie einen Indexfeldnamen für die Zuordnung und den Felddatentyp.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen Adobe Experience Manager**
Sie müssen mithilfe der [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API einen JSON-Wert des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-aem-schema) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `AEM` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **AEM-Host-URL** — Geben Sie die Adobe Experience Manager Host-URL an. Wenn Sie beispielsweise AEM On-Premise verwenden, geben Sie den Hostnamen und den Port an: *https://hostname:port*. Wenn Sie AEM als Cloud-Service verwenden, können Sie auch die Autoren-URL verwenden: *https://author-xxxxxx-xxxxxxx.adobeaemcloud.com*.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Authentifizierungstyp** — Geben Sie an, welchen Authentifizierungstyp Sie verwenden möchten, entweder `Basic` oder`OAuth2`.
+ **AEM-Typ** — Geben Sie an, welchen Typ Adobe Experience Manager Sie verwenden, entweder oder. `CLOUD` `ON_PREMISE`
+ **Geheimer Amazon-Ressourcenname (ARN)** — Wenn Sie die Standardauthentifizierung für AEM On-Premise oder Cloud verwenden möchten, geben Sie ein Geheimnis an, in dem Ihre Authentifizierungsdaten mit Ihrem Benutzernamen und Passwort gespeichert werden. Sie geben den Amazon-Ressourcennamen (ARN) eines AWS Secrets Manager Geheimnisses an. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"aemUrl": "Adobe Experience Manager On-Premise host URL",
"username": "user name with admin permissions",
"password": "password with admin permissions"
}
```
Wenn Sie die OAuth 2.0-Authentifizierung für AEM On-Premise verwenden möchten, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"aemUrl": "Adobe Experience Manager host URL",
"clientId": "client ID",
"clientSecret": "client secret",
"privateKey": "private key"
}
```
Wenn Sie die OAuth 2.0-Authentifizierung für AEM as a Cloud Service verwenden möchten, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"clientId": "client ID",
"clientSecret": "client secret",
"privateKey": "private key",
"orgId": "organization ID",
"technicalAccountId": "technical account ID",
"imsHost": "Adobe Identity Management System (IMS) host"
}
```
+ **IAMRolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen Öffentlichkeit APIs für den Adobe Experience Manager-Connector und zuzuweisen. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für Adobe Experience Manager-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Zeitzonen-ID** — Wenn Sie AEM On-Premise verwenden und sich die Zeitzone Ihres Servers von der Zeitzone des Amazon Kendra AEM-Connectors oder -Indexes unterscheidet, können Sie die Serverzeitzone so angeben, dass sie mit dem AEM-Connector oder Index übereinstimmt.
Die Standardzeitzone für AEM On-Premise ist die Zeitzone des AEM-Connectors oder -Indexes. Amazon Kendra Die Standardzeitzone für AEM as a Cloud Service ist Greenwich Mean Time.
Informationen zu den unterstützten Zeitzonen IDs finden Sie unter [Adobe Experience ManagerJSON-Schema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#aem-json).
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob bestimmte Seiten und Inhalte ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) der Suchergebnisse zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Adobe Experience Manager-Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [Adobe Experience ManagerVorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-aem-schema).
------
# Alfresco
**Anmerkung**
Alfresco Connector wird für Bestandskunden bis zum 31. Mai 2026 weiterhin vollständig unterstützt. Dieser Konnektor ist zwar nicht mehr für neue Benutzer verfügbar, aktuelle Benutzer können ihn jedoch weiterhin ohne Unterbrechung verwenden. Wir entwickeln unser Konnektor-Portfolio kontinuierlich weiter, um besser skalierbare und anpassbare Lösungen anbieten zu können. Für future Integrationen empfehlen wir, das Amazon Kendra Custom Connector Framework [1] zu erkunden, das ein breiteres Spektrum von Unternehmensanwendungsfällen mit verbesserter Flexibilität unterstützt.
Alfrescoist ein Content-Management-Service, der Kunden dabei unterstützt, ihre Inhalte zu speichern und zu verwalten. Sie können Amazon Kendra es verwenden, um Ihre Alfresco Dokumentbibliothek, Ihr Wiki und Ihren Blog zu indizieren.
Amazon Kendraunterstützt Alfresco On-Premise und Alfresco Cloud (Platform as a Service).
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) oder die [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer Alfresco Datenquelle herstellen.
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Alfresco-Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-alfresco)
+ [
## Voraussetzungen
](#prerequisites-alfresco)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-alfresco)
+ [
## Weitere Informationen
](#alfresco-learn-more)
## Unterstützte Features
Amazon KendraAlfrescoDer Datenquellen-Connector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ OAuth 2.0 und Standardauthentifizierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Alfresco-Datenquelle Amazon Kendra zur Indexierung verwenden können, nehmen Sie diese Änderungen in Ihrem Alfresco und vor. AWS-Konten
**Stellen Sie in Alfresco Folgendes sicher:**
+ Sie haben Ihre Alfresco-Repository-URL und die URL Ihrer Webanwendung kopiert. Wenn Sie nur eine bestimmte Alfresco-Site indexieren möchten, kopieren Sie auch die Site-ID.
+ Notieren Sie sich Ihre Alfresco Authentifizierungsdaten, die einen Benutzernamen und ein Passwort mit mindestens Leseberechtigungen beinhalten. Wenn Sie die OAuth 2.0-Authentifizierung verwenden möchten, sollten Sie den Benutzer der Alfresco Administratorgruppe hinzufügen.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ **Optional**: Die Anmeldeinformationen für OAuth Version 2.0 wurden in Alfresco konfiguriert. Zu den Anmeldeinformationen gehören die Client-ID, das Client-Secret und die Token-URL. Weitere Informationen zur Konfiguration von Clients für Alfresco On-Premises finden Sie in der [Alfresco-Dokumentation](https://docs.alfresco.com/identity-service/latest/tutorial/sso/saml/). Wenn Sie Alfresco Cloud (PaaS) verwenden, müssen Sie sich für die 2.0-Authentifizierung an den [Hyland-Support](https://community.hyland.com/) wenden. Alfresco OAuth
+ Vergewissert, dass jedes Dokument in Alfresco und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen pro Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Ihre Alfresco-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon ab**, Anmeldeinformationen und geheime Daten für mehrere Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Alfresco-Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Alfresco-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Alfresco-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie Alfresco für noch nicht konfiguriert haben, finden Sie weitere Informationen unter. Amazon Kendra [Voraussetzungen](#prerequisites-alfresco)
------
#### [ Console ]
**Um eine Verbindung herzustellen Amazon Kendra Alfresco**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Alfresco Connector und dann Connector** **hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie **Alfresco Connector** mit dem Tag „V2.0".
1. Geben Sie auf der Seite **„Datenquellendetails angeben**“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **AlfrescoTyp** — Wählen Sie aus, ob Sie Alfresco On-Premises/Server oder Alfresco Cloud (Platform as a Service) verwenden möchten.
1. **Alfresco-Repository-URL — Geben Sie Ihre Alfresco-Repository-URL ein**. Wenn Sie beispielsweise Alfresco Cloud (PaaS) verwenden, könnte die Repository-URL *https://company.alfrescocloud.com* lauten. Wenn Sie stattdessen Alfresco On-Premises verwenden, könnte die Repository-URL *https://company-alfresco-instance.company-domain.suffix:port* sein.
1. **Alfresco-Benutzeranwendung. URL** — Geben Sie die URL Ihrer Alfresco Benutzeroberfläche ein. Sie können die Repository-URL von Ihrem Alfresco-Administrator erhalten. Die URL der Benutzeroberfläche könnte beispielsweise *https://example.com* sein.
1. **Speicherort des SSL-Zertifikats** — Geben Sie den Pfad zu dem in einem Bucket gespeicherten SSL-Zertifikat einAmazon S3. Sie verwenden dies, um über eine sichere SSL-Verbindung eine Verbindung zu Alfresco On-Premises herzustellen.
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **Authentifizierung** — Wählen Sie **Standardauthentifizierung** oder **OAuth 2.0-Authentifizierung**. Wählen Sie dann ein vorhandenes Secrets Manager-Secret aus oder erstellen Sie ein neues Secret, um Ihre Alfresco-Anmeldeinformationen zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
Wenn Sie die **Standardauthentifizierung** gewählt haben, geben Sie einen Namen für das Geheimnis, den Alfresco Benutzernamen und das Passwort ein.
Wenn Sie sich für die **OAuth 2.0-Authentifizierung** entschieden haben, geben Sie einen Namen für das Geheimnis, die Client-ID, den geheimen Client-Schlüssel und die Token-URL ein.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. **Synchronisierungsbereich** — Legen Sie Grenzwerte für das Crawlen bestimmter Inhalte fest und filtern Sie Inhalte mithilfe von Regex-Ausdrucksmustern.
1.
1. **Inhalt** — Wählen Sie aus, ob Inhalte, die mit „Aspekten“ gekennzeichnet sindAlfresco, Inhalte innerhalb einer bestimmten Alfresco Website oder Inhalte auf all Ihren Websites gecrawlt werden sollen. Alfresco
1. (Optional) **Zusätzliche Konfiguration** — Legen Sie die folgenden Einstellungen fest:
+ **Kommentare einbeziehen** — Wählen Sie aus, ob Kommentare in die Alfresco Dokumentbibliothek und den Blog aufgenommen werden sollen.
+ **Regex-Muster** — Reguläre Ausdrucksmuster zum Ein- oder Ausschließen bestimmter Dateien.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Frequenz** aus, wie oft der Inhalt Ihrer Datenquelle synchronisiert und der Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den Amazon Kendra generierten Standard-Datenquellenfeldern aus, die Sie Ihrem Index zuordnen möchten.
1. Um benutzerdefinierte Datenquellenfelder hinzuzufügen, erstellen Sie einen Indexfeldnamen für die Zuordnung und den Felddatentyp.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen Alfresco**
Sie müssen mithilfe der [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API ein JSON des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-alfresco-schema) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `ALFRESCO` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **AlfrescoSite-ID** — Geben Sie die Alfresco-Site-ID an.
+ **AlfrescoRepository-URL** — Geben Sie die Repository-URL an. Alfresco Sie können die Repository-URL von Ihrem Alfresco-Administrator erhalten. Wenn Sie beispielsweise Alfresco Cloud (PaaS) verwenden, könnte die Repository-URL *https://company.alfrescocloud.com* lauten. Wenn Sie stattdessen Alfresco On-Premises verwenden, könnte die Repository-URL *https://company-alfresco-instance.company-domain.suffix:port* sein.
+ **AlfrescoURL der Webanwendung** — Geben Sie die URL der Alfresco Benutzeroberfläche an. Sie können die Repository-URL von Ihrem Alfresco-Administrator erhalten. Die URL der Benutzeroberfläche könnte beispielsweise *https://example.com* sein.
+ **Authentifizierungstyp** — Geben Sie an, welchen Authentifizierungstyp Sie verwenden möchten, ob oder`OAuth2`. `Basic`
+ **AlfrescoTyp** — Geben Sie an, welchen Typ Alfresco Sie verwenden, ob `PAAS` (Cloud/Platform as a Service) oder `ON_PREM` (On-Premise).
+ **Geheimer Amazon-Ressourcenname (ARN)** — Wenn Sie die Standardauthentifizierung verwenden möchten, geben Sie ein Geheimnis an, in dem Ihre Authentifizierungsdaten mit Ihrem Benutzernamen und Passwort gespeichert werden. Sie geben den Amazon-Ressourcennamen (ARN) eines AWS Secrets Manager Geheimnisses an. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"username": "user name",
"password": "password"
}
```
Wenn Sie die OAuth 2.0-Authentifizierung verwenden möchten, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"clientId": "client ID",
"clientSecret": "client secret",
"tokenUrl": "token URL"
}
```
+ **IAMrole** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Secret zu geben und die erforderliche Öffentlichkeit APIs für den Alfresco-Connector und aufzurufen. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für Alfresco-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inhaltstyp** — Der Inhaltstyp, den Sie crawlen möchten, unabhängig davon, ob es sich um Inhalte handelt, die mit „Aspekten“ gekennzeichnet sindAlfresco, Inhalte innerhalb einer bestimmten Alfresco Website oder Inhalte auf all Ihren Websites. Alfresco Sie können auch bestimmte „Aspekte“ -Inhalte auflisten.
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob bestimmte Dateien ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Alfresco-Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen zu können. Amazon Kendra Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [AlfrescoVorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-alfresco-schema).
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer Alfresco-Datenquelle finden Sie unter:
+ [Suchen Sie intelligent nach Inhalten mit AlfrescoAmazon Kendra](https://aws.amazon.com/blogs/machine-learning/intelligently-search-alfresco-content-using-amazon-kendra/)
# Aurora(MySQL)
**Anmerkung**
Der Aurora(MySQL)-Konnektor wird für Bestandskunden bis zum 31. Mai 2026 weiterhin vollständig unterstützt. Dieser Konnektor ist zwar nicht mehr für neue Benutzer verfügbar, aktuelle Benutzer können ihn jedoch weiterhin ohne Unterbrechung verwenden. Wir entwickeln unser Konnektor-Portfolio kontinuierlich weiter, um besser skalierbare und anpassbare Lösungen anbieten zu können. Für future Integrationen empfehlen wir, sich mit dem Amazon Kendra Custom Connector Framework [1] vertraut zu machen, das ein breiteres Spektrum von Unternehmensanwendungsfällen mit verbesserter Flexibilität unterstützt.
Auroraist ein relationales Datenbankmanagementsystem (RDBMS), das für die Cloud entwickelt wurde. Wenn Sie ein Aurora Benutzer sind, können Sie es verwenden, um Ihre Aurora(MySQL) Datenquelle Amazon Kendra zu indizieren. Der Amazon Kendra Aurora(MySQL) Datenquellenconnector unterstützt Aurora MySQL 3 und Aurora Serverless MySQL 8.0.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer Aurora(MySQL) Datenquelle herstellen.
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Aurora(MySQL) Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-aurora-mysql)
+ [
## Voraussetzungen
](#prerequisites-aurora-mysql)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-aurora-mysql)
+ [
## Hinweise
](#aurora-mysql-notes)
## Unterstützte Features
+ Feldzuordnungen
+ Filterung des Benutzerkontextes
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Aurora(MySQL) Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren Konten Aurora(MySQL) und AWS Konten vor.
**Stellen Sie in Aurora(MySQL) Folgendes sicher:**
+ Notieren Sie sich Ihren Datenbankbenutzernamen und Ihr Passwort.
**Wichtig**
Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Die URL, der Port und die Instanz Ihres Datenbank-Hosts wurden kopiert. Sie finden diese Informationen auf der Amazon RDS Konsole.
+ Vergewissert, dass jedes Dokument in Aurora(MySQL) und zwischen anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen pro Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Wir haben Ihre Aurora(MySQL) Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Aurora(MySQL) Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Aurora(MySQL) Datenquelle herzustellen, müssen Sie Details zu Ihren Aurora(MySQL) Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben, Amazon Kendra finden Sie Aurora(MySQL) weitere Informationen unter[Voraussetzungen](#prerequisites-aurora-mysql).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen Aurora(MySQL)**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Aurora(MySQL)Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Aurora(MySQL)Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. Geben Sie unter **Quelle** die folgenden Informationen ein:
1. **Host** – Geben Sie die URL des Datenbankhosts ein, z. B.: `http://instance URL.region.rds.amazonaws.com`.
1. **Port** – Geben Sie den Datenbank-Port ein, z. B.: `5432`.
1. **Instanz** — Geben Sie die Datenbank-Instance ein.
1. Geben Sie im Feld **Authentifizierung** die folgenden Informationen ein:
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Aurora(MySQL) Authentifizierungsdaten zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra- Aurora(MySQL) -' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Für **Datenbankbenutzername** und **Passwort** — Geben Sie die Werte der Authentifizierungsdaten ein, die Sie aus Ihrer Datenbank kopiert haben.
1. Wählen Sie **Speichern**.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Wählen Sie unter **Synchronisierungsbereich** aus den folgenden Optionen aus:
+ **SQL-Abfrage** – Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen müssen weniger als 32 KB groß sein. SQL-Abfragen müssen weniger als 32 KB groß sein und dürfen keine Semikolons (;) enthalten. Amazon Kendradurchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Primärschlüsselspalte** – Geben Sie den Primärschlüssel für die Datenbanktabelle an. Dadurch wird eine Tabelle in Ihrer Datenbank identifiziert.
+ **Titelspalte** – Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein.
+ **Hauptspalte** — Geben Sie den Namen der Hauptspalte des Dokuments in Ihrer Datenbanktabelle an.
1. Wählen Sie **unter Zusätzliche Konfiguration — *optional*** aus den folgenden Optionen, um bestimmte Inhalte zu synchronisieren, anstatt alle Dateien zu synchronisieren:
+ **Spalten zur Erkennung von Änderungen** — Geben Sie die Namen der Spalten ein, anhand derer Inhaltsänderungen erkannt Amazon Kendra werden sollen. Amazon Kendraindexiert den Inhalt neu, wenn sich eine dieser Spalten ändert.
+ ** IDsSpalte „Benutzer“** — Geben Sie den Namen der Spalte ein, die den Benutzer enthält, dem der Zugriff auf IDs den Inhalt gewährt werden soll.
+ **Gruppenspalte** – Geben Sie den Namen der Spalte ein, die Gruppen enthält, denen Zugriff auf Inhalte gewährt werden soll.
+ ** URLsQuellspalte** — Geben Sie den Namen der Spalte ein, die die URLs zu indizierende Quelle enthält.
+ **Spalte mit Zeitstempeln** — Geben Sie den Namen der Spalte ein, die Zeitstempel enthält. Amazon Kendraverwendet Zeitstempelinformationen, um Änderungen an Ihren Inhalten zu erkennen und nur geänderte Inhalte zu synchronisieren.
+ **Zeitzonenspalte** – Geben Sie den Namen der Spalte ein, die Zeitzonen für den Inhalt enthält, der durchsucht werden soll.
+ **Zeitstempelformat** – Geben Sie den Namen der Spalte ein, die Zeitstempelformate enthält, die verwendet werden sollen, um Inhaltsänderungen zu erkennen und Ihre Inhalte erneut zu synchronisieren.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Im **Synchronisierungslaufplan** für **Frequenz** — Wie oft Amazon Kendra wird mit Ihrer Datenquelle synchronisiert?
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den generierten Standarddatenquellenfeldern — **Dokument IDs**, **Dokumenttitel** und **Quelle URLs** — aus, die Sie dem Index zuordnen möchten. Amazon Kendra
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen Aurora(MySQL)**
Mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API müssen Sie Folgendes angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `JDBC` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Datenbanktyp** — Sie müssen den Datenbanktyp als `mySql` angeben.
+ **SQL-Abfrage** — Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen an. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem Aurora(MySQL) Konto erstellt haben. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"user name": "database user name",
"password": "password"
}
```
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (falls zutreffend) wiederzuverwenden.
+ **IAMRolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen Öffentlichkeit APIs für den Aurora(MySQL) Connector und zu erteilen. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für Aurora(MySQL) Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Sie können mithilfe von Benutzern, Gruppen IDs, Quellen, Zeitstempeln und Zeitzonen angeben URLs, ob bestimmte Inhalte eingeschlossen werden sollen.
+ **Benutzerkontextfilterung und Zugriffskontrolle** — Amazon Kendra durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Aurora(MySQL) Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter[Aurora (MySQL) Vorlagenschema](ds-schemas.md#ds-aurora-mysql-schema).
------
## Hinweise
+ Gelöschte Datenbankzeilen werden nicht nachverfolgt, wenn nach Amazon Kendra aktualisierten Inhalten gesucht wird.
+ Die Größe von Feldnamen und Werten in einer Zeile Ihrer Datenbank darf 400 KB nicht überschreiten.
+ Wenn Ihre Datenbankdatenquelle eine große Datenmenge enthält und Sie nicht möchtenAmazon Kendra, dass Ihr gesamter Datenbankinhalt nach der ersten Synchronisierung indexiert wird, können Sie wählen, ob nur neue, geänderte oder gelöschte Dokumente synchronisiert werden sollen.
+ Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Es hat sich bewährt, das Hinzufügen von Tabellen mit sensiblen Daten oder personenbezogenen Daten (PII) zu vermeiden.
# Aurora(PostgreSQL)
**Anmerkung**
Der Aurora(PostgreSQL)-Konnektor wird für Bestandskunden bis zum 31. Mai 2026 weiterhin vollständig unterstützt. Dieser Konnektor ist zwar nicht mehr für neue Benutzer verfügbar, aktuelle Benutzer können ihn jedoch weiterhin ohne Unterbrechung verwenden. Wir entwickeln unser Konnektor-Portfolio kontinuierlich weiter, um besser skalierbare und anpassbare Lösungen anbieten zu können. Für future Integrationen empfehlen wir, das Amazon Kendra Custom Connector Framework [1] zu erkunden, das ein breiteres Spektrum von Unternehmensanwendungsfällen mit verbesserter Flexibilität unterstützt.
Auroraist ein relationales Datenbankmanagementsystem (RDBMS), das für die Cloud entwickelt wurde. Wenn Sie ein Aurora Benutzer sind, können Sie es verwenden, um Ihre Aurora(PostgreSQL) Datenquelle Amazon Kendra zu indizieren. Der Amazon Kendra Aurora(PostgreSQL) Datenquellenconnector unterstützt Aurora PostgreSQL 1.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die API eine Verbindung zu Ihrer Aurora(PostgreSQL) Datenquelle herstellen. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Aurora(PostgreSQL) Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-aurora-postgresql)
+ [
## Voraussetzungen
](#prerequisites-aurora-postgresql)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-aurora-postgresql)
+ [
## Hinweise
](#aurora-postgresql-notes)
## Unterstützte Features
+ Feldzuordnungen
+ Filterung des Benutzerkontextes
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Aurora(PostgreSQL) Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren Konten Aurora(PostgreSQL) und AWS Konten vor.
**Stellen Sie in Aurora(PostgreSQL) Folgendes sicher:**
+ Notieren Sie sich Ihren Datenbankbenutzernamen und Ihr Passwort.
**Wichtig**
Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Die URL, der Port und die Instanz Ihres Datenbank-Hosts wurden kopiert.
+ Vergewissert, dass jedes Dokument in Aurora(PostgreSQL) und zwischen anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen pro Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Wir haben Ihre Aurora(PostgreSQL) Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Aurora(PostgreSQL) Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Aurora(PostgreSQL) Datenquelle herzustellen, müssen Sie Details zu Ihren Aurora(PostgreSQL) Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben, Amazon Kendra sehen Sie Aurora(PostgreSQL) nach[Voraussetzungen](#prerequisites-aurora-postgresql).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen Aurora(PostgreSQL)**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Aurora(PostgreSQL)Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Aurora(PostgreSQL)Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. Geben Sie unter **Quelle** die folgenden Informationen ein:
1. **Host** – Geben Sie die URL des Datenbankhosts ein, z. B.: `http://instance URL.region.rds.amazonaws.com`.
1. **Port** – Geben Sie den Datenbank-Port ein, z. B.: `5432`.
1. **Instance** – Geben Sie die Datenbank-Instance ein, z. B.: `postgres`.
1. **Speicherort für SSL-Zertifikate aktivieren** — Geben Sie hier den Amazon S3 Pfad zu Ihrer SSL-Zertifikatsdatei ein.
1. Geben Sie im Feld **Authentifizierung** die folgenden Informationen ein:
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Aurora(PostgreSQL) Authentifizierungsdaten zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra- Aurora(PostgreSQL) -' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Für **Datenbankbenutzername** und **Passwort** — Geben Sie die Werte der Authentifizierungsdaten ein, die Sie aus Ihrer Datenbank kopiert haben.
1. Wählen Sie **Speichern**.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Wählen Sie unter **Synchronisierungsbereich** aus den folgenden Optionen aus:
+ **SQL-Abfrage** – Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen müssen weniger als 32 KB groß sein. SQL-Abfragen müssen weniger als 32 KB groß sein und dürfen keine Semikolons (;) enthalten. Amazon Kendradurchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Primärschlüsselspalte** – Geben Sie den Primärschlüssel für die Datenbanktabelle an. Dadurch wird eine Tabelle in Ihrer Datenbank identifiziert.
+ **Titelspalte** – Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein.
+ **Hauptspalte** — Geben Sie den Namen der Hauptspalte des Dokuments in Ihrer Datenbanktabelle ein.
1. Wählen Sie **unter Zusätzliche Konfiguration — *optional*** aus den folgenden Optionen, um bestimmte Inhalte zu synchronisieren, anstatt alle Dateien zu synchronisieren:
+ **Spalten zur Erkennung von Änderungen** — Geben Sie die Namen der Spalten ein, anhand derer Inhaltsänderungen erkannt Amazon Kendra werden sollen. Amazon Kendraindexiert den Inhalt neu, wenn sich eine dieser Spalten ändert.
+ ** IDsSpalte Benutzer** — Geben Sie den Namen der Spalte ein, die den Benutzer enthält, dem der Zugriff auf IDs den Inhalt gewährt werden soll.
+ **Gruppenspalte** – Geben Sie den Namen der Spalte ein, die Gruppen enthält, denen Zugriff auf Inhalte gewährt werden soll.
+ ** URLsQuellspalte** — Geben Sie den Namen der Spalte ein, die die URLs zu indizierende Quelle enthält.
+ **Spalte mit Zeitstempeln** — Geben Sie den Namen der Spalte ein, die Zeitstempel enthält. Amazon Kendraverwendet Zeitstempelinformationen, um Änderungen an Ihren Inhalten zu erkennen und nur geänderte Inhalte zu synchronisieren.
+ **Zeitzonenspalte** – Geben Sie den Namen der Spalte ein, die Zeitzonen für den Inhalt enthält, der durchsucht werden soll.
+ **Zeitstempelformat** – Geben Sie den Namen der Spalte ein, die Zeitstempelformate enthält, die verwendet werden sollen, um Inhaltsänderungen zu erkennen und Ihre Inhalte erneut zu synchronisieren.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie alle Inhalte neu und ersetzen vorhandene Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Im **Synchronisierungslaufplan** für **Frequenz** — Wie oft Amazon Kendra wird mit Ihrer Datenquelle synchronisiert?
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den generierten Standarddatenquellenfeldern — **Dokument IDs**, **Dokumenttitel** und **Quelle URLs** — aus, die Sie dem Index zuordnen möchten. Amazon Kendra
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen Aurora(PostgreSQL)**
Mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API müssen Sie Folgendes angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `JDBC` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Datenbanktyp** — Sie müssen den Datenbanktyp als `postgresql` angeben.
+ **SQL-Abfrage** — Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen an. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem Aurora(PostgreSQL) Konto erstellt haben. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"user name": "database user name",
"password": "password"
}
```
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (falls zutreffend) wiederzuverwenden.
+ **IAMRolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen Öffentlichkeit APIs für den Aurora(PostgreSQL) Connector und zu erteilen. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für Aurora(PostgreSQL) Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Sie können mithilfe von Benutzern, Gruppen IDs, Quellen, Zeitstempeln und Zeitzonen angeben URLs, ob bestimmte Inhalte eingeschlossen werden sollen.
+ **Benutzerkontextfilterung und Zugriffskontrolle** — Amazon Kendra durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Aurora(PostgreSQL) Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter[Aurora (PostgreSQL) -Vorlagenschema](ds-schemas.md#ds-aurora-postgresql-schema).
------
## Hinweise
+ Gelöschte Datenbankzeilen werden nicht nachverfolgt, wenn nach Amazon Kendra aktualisierten Inhalten gesucht wird.
+ Die Größe von Feldnamen und Werten in einer Zeile Ihrer Datenbank darf 400 KB nicht überschreiten.
+ Wenn Ihre Datenbankdatenquelle eine große Datenmenge enthält und Sie nicht Ihren gesamten Datenbankinhalt nach der ersten Synchronisierung indizieren möchtenAmazon Kendra, können Sie wählen, ob nur neue, geänderte oder gelöschte Dokumente synchronisiert werden sollen.
+ Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Es hat sich bewährt, das Hinzufügen von Tabellen mit sensiblen Daten oder personenbezogenen Daten (PII) zu vermeiden.
# Amazon FSx(Fenster)
Amazon FSx(Windows) ist ein vollständig verwaltetes, Cloud-basiertes Dateiserversystem, das gemeinsam genutzte Speicherfunktionen bietet. Wenn Sie ein Amazon FSx (Windows-) Benutzer sind, können Sie Amazon Kendra damit Ihre Amazon FSx (Windows-) Datenquelle indizieren.
**Anmerkung**
Amazon Kendraunterstützt jetzt einen aktualisierten Amazon FSx (Windows-) Connector.
Die Konsole wurde automatisch für Sie aktualisiert. Alle neuen Connectors, die Sie auf der Konsole erstellen, verwenden die aktualisierte Architektur. Wenn Sie die API verwenden, müssen Sie jetzt das [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekt anstelle des `FSxConfiguration` Objekts verwenden, um Ihren Connector zu konfigurieren.
Konnektoren, die mit der älteren Konsolen- und API-Architektur konfiguriert wurden, funktionieren weiterhin wie konfiguriert. Sie können sie jedoch nicht bearbeiten oder aktualisieren. Wenn Sie Ihre Connectorkonfiguration bearbeiten oder aktualisieren möchten, müssen Sie einen neuen Connector erstellen.
Wir empfehlen, Ihren Connector-Workflow auf die aktualisierte Version zu migrieren. Die Support für Konnektoren, die mit der älteren Architektur konfiguriert wurden, soll bis Juni 2024 eingestellt werden.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) oder die [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer Amazon FSx (Windows-) Datenquelle herstellen.
Informationen zur Problembehandlung Ihres Amazon Kendra Amazon FSx (Windows-) Datenquellen-Connectors finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-fsx)
+ [
## Voraussetzungen
](#prerequisites-fsx)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-fsx)
+ [
## Weitere Informationen
](#fsx-learn-more)
## Unterstützte Features
Amazon KendraAmazon FSxDer (Windows-) Datenquellenconnector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Crawling der Benutzeridentität
+ Inklusions- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Amazon FSx (Windows-) Datenquelle Amazon Kendra zum Indizieren verwenden können, überprüfen Sie die Details Ihrer Amazon FSx (Windows) und. AWS-Konten
Stellen Sie **für Amazon FSx (Windows) sicher, dass Sie über Folgendes verfügen**:
+ Richten Sie Amazon FSx (Windows) mit Lese- und Mount-Rechten ein.
+ Notiert Ihre Dateisystem-ID. Sie finden Ihre Dateisystem-ID im Dateisystem-Dashboard in der Amazon FSx (Windows-) Konsole.
+ Sie haben eine virtuelle private Cloud konfiguriertAmazon VPC, in der sich Ihr Amazon FSx (Windows-) Dateisystem befindet.
+ Haben Ihre Amazon FSx (Windows-) Authentifizierungsdaten für ein Active Directory Benutzerkonto notiert. Dazu gehören Ihr Active Directory-Benutzername mit Ihrem DNS-Domänennamen (z. B. *user@corp.example.com*) und Ihrem Passwort.
**Anmerkung**
Verwenden Sie nur die erforderlichen Anmeldeinformationen, damit der Connector funktioniert. Verwenden Sie keine privilegierten Anmeldeinformationen wie den Domänenadministrator.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ Aktiviert, dass jedes Dokument in Amazon FSx (Windows) und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Ihre Amazon FSx (Windows-) Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir empfehlen **nicht**, dass Sie Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (falls zutreffend) wiederverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Amazon FSx (Windows-) Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Amazon FSx (Windows-) Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Amazon FSx (Windows-) Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie Amazon FSx (Windows) noch nicht konfiguriert habenAmazon Kendra, finden Sie weitere Informationen unter[Voraussetzungen](#prerequisites-fsx).
------
#### [ Console ]
**So stellen Sie eine Verbindung Amazon Kendra zu Ihrem Amazon FSx (Windows-) Dateisystem her**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Amazon FSx(Windows) -Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 (falls zutreffend) verwenden, wählen Sie den **Amazon FSx(Windows-) Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Amazon FSx(Windows) Dateisystem-ID** — Wählen Sie aus der Dropdownliste Ihre bestehende Dateisystem-ID aus, die von Amazon FSx (Windows) abgerufen wurde. Oder erstellen Sie ein [Amazon FSx(Windows-) Dateisystem](https://console.aws.amazon.com/fsx/). Sie finden Ihre Dateisystem-ID im Dateisystem-Dashboard in der Amazon FSx (Windows-) Konsole.
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **Authentifizierung** — Wählen Sie ein vorhandenes AWS Secrets Manager Geheimnis aus, oder erstellen Sie ein neues Geheimnis, um Ihre Dateisystem-Anmeldeinformationen zu speichern. Wenn Sie ein neues Secret erstellen möchten, wird das Fenster „AWS Secrets Manager-Secret“ geöffnet.
Geben Sie ein Geheimnis ein, in dem Ihre Authentifizierungsdaten mit Ihrem Benutzernamen und Passwort gespeichert werden. Der Benutzername muss Ihren DNS-Domainnamen enthalten. Zum Beispiel *user@corp.example.com*.
Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.
1. **Virtual Private Cloud (VPC)** — Sie müssen einen Standort auswählen, an Amazon VPC dem sich Ihr Amazon FSx (Windows) befindet. Sie schließen das VPC-Subnetz und die Sicherheitsgruppen ein. Siehe [Konfiguration eines](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html). Amazon VPC
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. **Synchronisierungsbereich, Regex-Muster — Fügen Sie Muster** für reguläre Ausdrücke hinzu, um bestimmte Dateien ein- oder auszuschließen.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. **Zeitplan für Synchronisierungsläufe** — Wählen Sie unter **Häufigkeit** aus, wie oft Ihre Datenquelleninhalte synchronisiert und Ihr Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den Amazon Kendra generierten Standardfeldern Ihrer Dateien aus, die Sie Ihrem Index zuordnen möchten. Um benutzerdefinierte Datenquellenfelder hinzuzufügen, erstellen Sie einen Indexfeldnamen für die Zuordnung und den Felddatentyp.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra zu Ihrem Amazon FSx (Windows-) Dateisystem herzustellen**
Sie müssen mithilfe der [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API eine JSON-Datei des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-fsx-schema) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `FSX` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Dateisystem-ID** — Die Kennung des Amazon FSx (Windows-) Dateisystems. Sie finden Ihre Dateisystem-ID im Dateisystem-Dashboard in der Amazon FSx (Windows-) Konsole.
+ **Dateisystemtyp** — Geben Sie den Typ des Dateisystems als `WINDOWS` an.
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
**Anmerkung**
Sie müssen einen Standort auswählenAmazon VPC, an dem sich Ihr Amazon FSx (Windows) befindet. Sie schließen das VPC-Subnetz und die Sicherheitsgruppen ein.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) der Suchergebnisse zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Amazon FSx (Windows-) Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"username": "user@corp.example.com",
"password": "password"
}
```
+ **IAMrole** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis zu gewähren und die erforderliche Öffentlichkeit APIs für den Amazon FSx (Windows-) Connector aufzurufen undAmazon Kendra. Weitere Informationen finden Sie unter [IAMRollen für Amazon FSx (Windows-) Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob bestimmte Dateien ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Zugriffskontrollliste (ACL)** — Geben Sie an, ob die ACL-Informationen für Ihre Dokumente gecrawlt werden sollen, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
**Anmerkung**
Um die Benutzerkontextfilterung für einen Benutzer zu testen, müssen Sie den DNS-Domänennamen als Teil des Benutzernamens angeben, wenn Sie die Abfrage ausgeben. Sie müssen über Administratorrechte für die Active Directory-Domäne verfügen. Sie können die Benutzerkontextfilterung auch anhand eines Gruppennamens testen.
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Amazon FSx (Windows-) Datenquellenfelder Ihren Amazon Kendra Indexfeldern zuzuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [Amazon FSx(Windows) -Vorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-fsx-windows-schema).
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer Amazon FSx (Windows-) Datenquelle finden Sie unter:
+ [Suchen Sie sicher nach unstrukturierten Daten auf Windows-Dateisystemen mit dem Amazon Kendra Connector für Amazon FSx (Windows) für Windows File Server](https://aws.amazon.com/blogs/machine-learning/securely-search-unstructured-data-on-windows-file-systems-with-amazon-kendra-connector-for-amazon-fsx-for-windows-file-server/).
# Amazon FSx(IM NetApp TAP)
Amazon FSx(NetApp ONTAP) ist ein vollständig verwaltetes, Cloud-basiertes Dateiserversystem, das gemeinsam genutzte Speicherfunktionen bietet. Wenn Sie ein Amazon FSx (NetApp ONTAP-) Benutzer sind, können Sie Amazon Kendra damit Ihre Amazon FSx (NetApp ONTAP-) Datenquelle indizieren.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) oder die API eine Verbindung zu Ihrer Amazon FSx (NetApp ONTAP-) Datenquelle herstellen. [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Amazon FSx (NetApp ONTAP-) Datenquellenconnector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-fsx-ontap)
+ [
## Voraussetzungen
](#prerequisites-fsx-ontap)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-fsx-ontap)
## Unterstützte Features
Amazon KendraAmazon FSxDer (NetApp ONTAP) -Datenquellen-Connector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Inklusions- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Amazon FSx (NetApp ONTAP-) Datenquelle Amazon Kendra zum Indizieren verwenden können, überprüfen Sie die Details Ihrer Amazon FSx (NetApp ONTAP) und. AWS-Konten
Stellen Sie **für Amazon FSx (NetApp ONTAP) sicher,** dass Sie über Folgendes verfügen:
+ Richten Sie Amazon FSx (NetApp ONTAP) mit Lese- und Montageberechtigungen ein.
+ Haben Sie Ihre Dateisystem-ID notiert. Sie finden Ihre Dateisystem-ID im Dateisystem-Dashboard in der Amazon FSx (NetApp ONTAP-) Konsole.
+ Notiert die SVM-ID (Storage Virtual Machine), die mit Ihrem Dateisystem verwendet wird. Sie finden Ihre SVM-ID, indem Sie das Dateisystem-Dashboard in der Amazon FSx (NetApp ONTAP-) Konsole aufrufen, Ihre Dateisystem-ID und dann virtuelle **Speichermaschinen** auswählen.
+ Sie haben eine virtuelle private Cloud konfiguriert, Amazon VPC in der sich Ihr Amazon FSx (NetApp ONTAP-) Dateisystem befindet.
+ Haben Ihre Amazon FSx (NetApp ONTAP-) Authentifizierungsdaten für ein Active Directory Benutzerkonto notiert. Dazu gehören Ihr Active Directory-Benutzername mit Ihrem DNS-Domainnamen (z. B. *user@corp.example.com*) und Ihrem Passwort. Wenn Sie das Network File System (NFS) -Protokoll für Ihr Amazon FSx (NetApp ONTAP) -Dateisystem verwenden, enthalten die Authentifizierungsdaten eine linke ID, eine rechte ID und einen vorinstallierten Schlüssel.
**Anmerkung**
Verwenden Sie nur die erforderlichen Anmeldeinformationen, damit der Connector funktioniert. Verwenden Sie keine privilegierten Anmeldeinformationen wie den Domänenadministrator.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ Aktiviert, dass jedes Dokument in Amazon FSx (NetApp ONTAP) und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Ihre Amazon FSx (NetApp ONTAP-) Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für mehrere Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Amazon FSx (NetApp ONTAP-) Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Amazon FSx (NetApp ONTAP-) Datenquelle herzustellen, müssen Sie die erforderlichen Angaben zu Ihrer Amazon FSx (NetApp ONTAP-) Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie Amazon FSx (NetApp ONTAP) für Amazon Kendra noch nicht konfiguriert haben, finden Sie weitere Informationen unter. [Voraussetzungen](#prerequisites-fsx-ontap)
------
#### [ Console ]
**So stellen Sie eine Verbindung Amazon Kendra zu Ihrem Amazon FSx (NetApp ONTAP-) Dateisystem her**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Amazon FSx(NetApp ONTAP) -Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 (falls zutreffend) verwenden, wählen Sie den **Konnektor Amazon FSx (NetApp ONTAP)** mit dem Tag „V2.0".
1. Geben Sie auf der Seite **„Datenquellendetails angeben**“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Quelle** — Geben Sie Ihre Dateisysteminformationen ein.
+ **Dateisystemprotokoll** — Wählen Sie das Protokoll Ihres Amazon FSx (NetApp ONTAP-) Dateisystems aus. Sie können entweder das CIFS-Protokoll (Common Internet File System) oder das NFS-Protokoll (Network File System) für Linux wählen.
+ **Amazon FSx(NetApp ONTAP) -Dateisystem-ID** — Wählen Sie aus der Drop-down-Liste Ihre bestehende Dateisystem-ID aus, die von (ONTAP) abgerufen wurde. Amazon FSx NetApp Oder erstellen Sie ein [Amazon FSx(ONTAP-) Dateisystem NetApp ](https://console.aws.amazon.com/fsx/). Sie finden Ihre Dateisystem-ID im Dateisystem-Dashboard in der Amazon FSx (NetApp ONTAP-) Konsole.
+ **SVM-ID** (Amazon FSx(NetApp ONTAPnur NetApp ONTAP) für) — Geben Sie die SVM-ID (Storage Virtual Machine) Ihrer (ONTAP) an. Amazon FSx NetApp NetApp ONTAP **Sie finden Ihre SVM-ID, indem Sie das Dateisystem-Dashboard in der Amazon FSx (NetApp ONTAP-) Konsole aufrufen, Ihre Dateisystem-ID auswählen und dann Virtuelle Speichermaschinen auswählen.**
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **Authentifizierung** — Wählen Sie ein vorhandenes AWS Secrets Manager Geheimnis aus, oder erstellen Sie ein neues Geheimnis, um Ihre Dateisystem-Anmeldeinformationen zu speichern. Wenn Sie ein neues Secret erstellen möchten, wird das Fenster „AWS Secrets Manager-Secret“ geöffnet.
Geben Sie ein Geheimnis ein, in dem Ihre Authentifizierungsdaten mit Ihrem Benutzernamen und Passwort gespeichert werden. Der Benutzername muss Ihren DNS-Domainnamen enthalten. Zum Beispiel *user@corp.example.com*.
Wenn Sie das NFS-Protokoll für Ihr Amazon FSx (NetApp ONTAP-) Dateisystem verwenden, geben Sie ein Geheimnis an, in dem Ihre Authentifizierungsdaten mit linker ID, rechter ID und vorinstalliertem Schlüssel gespeichert werden.
Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.
1. **Virtual Private Cloud (VPC)** — Sie müssen einen Standort auswählen, an Amazon VPC dem sich Ihr Amazon FSx (NetApp ONTAP) befindet. Sie schließen das VPC-Subnetz und die Sicherheitsgruppen ein. Siehe [Konfiguration eines](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html). Amazon VPC
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Synchronisierungseinstellungen konfigurieren** die folgenden Informationen ein:
1. **Synchronisierungsbereich, Regex-Muster — Fügen Sie Muster** für reguläre Ausdrücke hinzu, um bestimmte Dateien ein- oder auszuschließen.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie alle Inhalte neu und ersetzen vorhandene Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. **Zeitplan für Synchronisierungsläufe** — Wählen Sie unter **Häufigkeit** aus, wie oft Ihre Datenquelleninhalte synchronisiert und Ihr Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den Amazon Kendra generierten Standardfeldern Ihrer Dateien aus, die Sie Ihrem Index zuordnen möchten. Um benutzerdefinierte Datenquellenfelder hinzuzufügen, erstellen Sie einen Indexfeldnamen für die Zuordnung und den Felddatentyp.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra zu Ihrem Amazon FSx (NetApp ONTAP-) Dateisystem herzustellen**
Sie müssen mithilfe der [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API eine JSON-Datei des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-fsx-ontap-schema) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `FSXONTAP` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Dateisystem-ID** — Die Kennung des Amazon FSx (NetApp ONTAP-) Dateisystems. Sie finden Ihre Dateisystem-ID im Dateisystem-Dashboard in der Amazon FSx (NetApp ONTAP-) Konsole.
+ **SVM-ID — Die ID** der virtuellen Speichermaschine (SVM), die mit Ihrem Dateisystem verwendet wird. **Sie finden Ihre SVM-ID, indem Sie das Dateisystem-Dashboard in der Amazon FSx (NetApp ONTAP-) Konsole aufrufen, Ihre Dateisystem-ID und dann virtuelle Speichermaschinen auswählen.**
+ **Protokolltyp** — Geben Sie an, ob Sie das CIFS-Protokoll (Common Internet File System) oder das NFS-Protokoll (Network File System) für Linux verwenden.
+ **Dateisystemtyp** — Geben Sie entweder den Typ des Dateisystems an. `FSXONTAP`
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
**Anmerkung**
Sie müssen einen Standort auswählen, an Amazon VPC dem sich Ihr Amazon FSx (NetApp ONTAP) befindet. Sie schließen das VPC-Subnetz und die Sicherheitsgruppen ein.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Amazon FSx (NetApp ONTAP) -Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"username": "user@corp.example.com",
"password": "password"
}
```
Wenn Sie das NFS-Protokoll für Ihr Amazon FSx (NetApp ONTAP-) Dateisystem verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"leftId": "left ID",
"rightId": "right ID",
"preSharedKey": "pre-shared key"
}
```
+ **IAMrole** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Secret und für das Aufrufen der APIs für den Amazon FSx (NetApp ONTAP-) Connector erforderlichen öffentlichen Daten zu erteilen und. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für Amazon FSx (NetApp ONTAP-) Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob bestimmte Dateien ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Zugriffskontrollliste (ACL)** — Geben Sie an, ob die ACL-Informationen für Ihre Dokumente gecrawlt werden sollen, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
**Anmerkung**
Um die Benutzerkontextfilterung für einen Benutzer zu testen, müssen Sie den DNS-Domänennamen als Teil des Benutzernamens angeben, wenn Sie die Abfrage ausgeben. Sie müssen über Administratorrechte für die Active Directory-Domäne verfügen. Sie können die Benutzerkontextfilterung auch anhand eines Gruppennamens testen.
+ **Feldzuordnungen** — Wählen Sie, ob Sie Ihre Amazon FSx (NetApp ONTAP-) Datenquellenfelder Ihren Indexfeldern zuordnen möchten. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [Amazon FSx(NetApp ONTAP) -Vorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-fsx-ontap-schema).
------
# Amazon RDS/Aurora
Sie können Dokumente, die in einer Datenbank gespeichert sind, mithilfe einer Datenbankdatenquelle indizieren. Nachdem Sie Verbindungsinformationen für die Datenbank angegeben haben, Amazon Kendra verbindet und indexiert Dokumente.
Amazon Kendraunterstützt die folgenden Datenbanken:
+ Amazon Aurora MySQL
+ Amazon Aurora PostgreSQL
+ Amazon RDSfür MySQL
+ Amazon RDSfür PostgreSQL
**Anmerkung**
Serverlose Aurora-Datenbanken werden nicht unterstützt.
**Wichtig**
Dieser RDS/Aurora Amazon-Connector wird voraussichtlich bis Ende 2023 veraltet sein.
Amazon Kendraunterstützt jetzt neue Konnektoren für Datenbank-Datenquellen. Für eine bessere Benutzererfahrung empfehlen wir Ihnen, für Ihren Anwendungsfall aus den folgenden neuen Konnektoren zu wählen:
[Aurora(MySQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aurora-mysql.html)
[Aurora(PostgreSQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aurora-postgresql.html)
[Amazon RDS(MySQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-mysql.html)
[Amazon RDS(Microsoft SQL Server)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-ms-sql-server.html)
[Amazon RDS(Orakel)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-oracle.html)
[Amazon RDS(PostgreSQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-postgresql.html)
[IBM DB2](https://docs.aws.amazon.com/kendra/latest/dg/data-source-ibm-db2.html)
[Microsoft SQL Server](https://docs.aws.amazon.com/kendra/latest/dg/data-source-ms-sql-server.html)
[MySQL](https://docs.aws.amazon.com/kendra/latest/dg/data-source-mysql.html)
[Oracle-Datenbank](https://docs.aws.amazon.com/kendra/latest/dg/data-source-oracle-database.html)
[PostgreSQL](https://docs.aws.amazon.com/kendra/latest/dg/data-source-postgresql.html)
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die [DatabaseConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DatabaseConfiguration.html)API eine Verbindung zu Ihrer Datenbank-Datenquelle herstellen.
Informationen zur Problembehandlung Ihres Amazon Kendra Datenbank-Datenquellen-Connectors finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-database)
+ [
## Voraussetzungen
](#prerequisites-database)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-database)
## Unterstützte Features
Amazon KendraDer Datenbank-Datenquellen-Connector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Filterung des Benutzerkontextes
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Datenbankdatenquelle Amazon Kendra zum Indizieren verwenden können, müssen Sie diese Änderungen an Ihrer Datenbank und Ihren AWS Konten vornehmen.
**Stellen Sie sicher, dass Sie in Ihrer Datenbank Folgendes haben:**
+ Notieren Sie sich Ihre grundlegenden Authentifizierungsdaten mit Benutzername und Passwort für Ihre Datenbank.
+ Der Hostname, die Portnummer, die Hostadresse, der Name der Datenbank und der Name der Datentabelle, die die Dokumentdaten enthält, wurden kopiert. Für PostgreSQL muss die Datentabelle eine öffentliche Tabelle oder ein öffentliches Schema sein.
**Anmerkung**
Der Host und der Port geben anAmazon Kendra, wo der Datenbankserver im Internet zu finden ist. Der Datenbankname und der Tabellenname geben an, Amazon Kendra wo sich die Dokumentdaten auf dem Datenbankserver befinden.
+ Die Namen der Spalten in der Datentabelle, die die Dokumentdaten enthalten, wurden kopiert. Sie müssen die Dokument-ID, den Hauptteil des Dokuments, Spalten, um festzustellen, ob sich ein Dokument geändert hat (z. B. die Spalte mit der letzten Aktualisierung), und optionale Spalten in der Datentabelle angeben, die benutzerdefinierten Indexfeldern zugeordnet sind. Sie können auch jeden der [Amazon Kendrareservierten Feldnamen](https://docs.aws.amazon.com/kendra/latest/dg/hiw-document-attributes.html#index-reserved-fields) einer Tabellenspalte zuordnen.
+ Die Typinformationen der Datenbank-Engine wurden kopiert, z. B. ob Sie sie Amazon RDS für MySQL oder einen anderen Typ verwenden.
+ Aktiviert, dass jedes Dokument in der Datenbank und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, eindeutig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen pro Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Ihre Anmeldeinformationen für die Datenbankauthentifizierung AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Datenbankdatenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Datenbankdatenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Datenbankdatenquelle angeben, damit auf Ihre Daten zugegriffen werden Amazon Kendra kann. Wenn Sie die Datenbank für noch nicht konfiguriert habenAmazon Kendra, finden Sie weitere Informationen unter[Voraussetzungen](#prerequisites-database).
------
#### [ Console ]
**So stellen Sie eine Verbindung Amazon Kendra zu einer Datenbank her**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Datenbank-Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie einen **Datenbankconnector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Endpunkt** — Ein DNS-Hostname, eine IPv4 Adresse oder eine IPv6 Adresse.
1. **Port** — Eine Portnummer.
1. **Datenbank** — Datenbankname.
1. **Tabellenname** —Tabellenname.
1. Wählen Sie für **Authentifizierungstyp** zwischen Existiert **und** **Neu**, um Ihre Anmeldeinformationen für die Datenbankauthentifizierung zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-database' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Für **Benutzername** und **Passwort** — Geben Sie die Authentifizierungsdaten aus Ihrem Datenbankkonto ein.
1. Wählen Sie Authentifizierung **speichern** aus.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
**Anmerkung**
Sie müssen ein privates Subnetz verwenden. Wenn sich Ihre RDS-Instance in einem öffentlichen Subnetz in Ihrer VPC befindet, können Sie ein privates Subnetz erstellen, das ausgehenden Zugriff auf ein NAT-Gateway im öffentlichen Subnetz hat. Die in der VPC-Konfiguration bereitgestellten Subnetze müssen sich entweder in USA West (Oregon), USA Ost (Nord-Virginia) oder EU (Irland) befinden.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Synchronisierungseinstellungen konfigurieren** die folgenden Informationen ein:
1. Wählen Sie je nach Anwendungsfall zwischen **Aurora MySQL** ****, MySQL****, Aurora **PostgreSQL und PostgreSQL**.
1. **SQL-Bezeichner in doppelte Anführungszeichen einschließen — Wählen Sie diese Option, um SQL-Bezeichner in doppelte Anführungszeichen** zu setzen. Zum Beispiel „ColumnName“.
1. **ACL-Spalte** und **Spalten mit Änderungserkennung** — Konfigurieren Sie die Spalten, die für die Änderungserkennung Amazon Kendra verwendet werden (z. B. die Spalte mit der letzten Aktualisierung), und Ihre Zugriffskontrollliste.
1. Wählen Sie im **Synchronisierungslaufplan** für **Frequenz** aus, wie oft mit Ihrer Datenquelle synchronisiert Amazon Kendra werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Amazon KendraStandard-Feldzuordnungen** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten. Sie müssen die **Datenbankspaltenwerte** für und hinzufügen `document_id` `document_body`
1. **Benutzerdefinierte Feldzuordnungen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann Datenquelle **hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra zu einer Datenbank herzustellen**
Sie müssen die folgende [DatabaseConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DatabaseConfiguration.html)API angeben:
+ **ColumnConfiguration**— Informationen darüber, wo der Index die Dokumentinformationen aus der Datenbank abrufen soll. Weitere Details finden Sie unter [ColumnConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ColumnConfiguration.html). Sie müssen die Felder `DocumentDataColumnName` (Hauptteil des Dokuments oder Haupttext) und `DocumentIdColumnName` und `ChangeDetectingColumn` (z. B. letzte aktualisierte Spalte) angeben. Die dem `DocumentIdColumnName` Feld zugeordnete Spalte muss eine Ganzzahlspalte sein. Das folgende Beispiel zeigt eine einfache Spaltenkonfiguration für eine Datenbankdatenquelle:
```
"ColumnConfiguration": {
"ChangeDetectingColumns": [
"LastUpdateDate",
"LastUpdateTime"
],
"DocumentDataColumnName": "TextColumn",
"DocumentIdColumnName": "IdentifierColumn",
"DocoumentTitleColumnName": "TitleColumn",
"FieldMappings": [
{
"DataSourceFieldName": "AbstractColumn",
"IndexFieldName": "Abstract"
}
]
}
```
+ **ConnectionConfiguration**— Konfigurationsinformationen, die für die Verbindung mit einer Datenbank erforderlich sind. Weitere Details finden Sie unter [ConnectionConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConnectionConfiguration.html).
+ **DatabaseEngineType**— Der Typ der Datenbank-Engine, die die Datenbank ausführt. Das `DatabaseHost` Feld für `ConnectionConfiguration` muss der Instanzendpunkt Amazon Relational Database Service (Amazon RDS) für die Datenbank sein. Verwenden Sie nicht den Cluster-Endpunkt.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Datenbankkonto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"username": "user name",
"password": "password"
}
```
Das folgende Beispiel zeigt eine Datenbankkonfiguration, einschließlich des geheimen ARN.
```
"DatabaseConfiguration": {
"ConnectionConfiguration": {
"DatabaseHost": "host.subdomain.domain.tld",
"DatabaseName": "DocumentDatabase",
"DatabasePort": 3306,
"SecretArn": "arn:aws:secretmanager:region:account ID:secret/secret name",
"TableName": "DocumentTable"
}
}
```
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ **IAMRolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für den Aufruf der erforderlichen Öffentlichkeit APIs für den Datenbank-Connector und zu erteilen. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für Datenbankdatenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie dies `VpcConfiguration` als Teil der Datenquellenkonfiguration an. Siehe [Konfiguration Amazon Kendra für die Verwendung einer VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
**Anmerkung**
Sie dürfen nur ein privates Subnetz verwenden. Wenn sich Ihre RDS-Instance in einem öffentlichen Subnetz in Ihrer VPC befindet, können Sie ein privates Subnetz erstellen, das ausgehenden Zugriff auf ein NAT-Gateway im öffentlichen Subnetz hat. Die in der VPC-Konfiguration bereitgestellten Subnetze müssen sich entweder in USA West (Oregon), USA Ost (Nord-Virginia) oder EU (Irland) befinden.
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Datenbank-Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
+ **Benutzerkontextfilterung und Zugriffskontrolle** Amazon Kendra — durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
------
# Amazon RDS(Microsoft SQL Server)
**Anmerkung**
Amazon RDSDer Connector (Microsoft SQL Server) wird für Bestandskunden bis zum 31. Mai 2026 weiterhin vollständig unterstützt. Dieser Konnektor ist zwar nicht mehr für neue Benutzer verfügbar, aktuelle Benutzer können ihn jedoch weiterhin ohne Unterbrechung verwenden. Wir entwickeln unser Konnektor-Portfolio kontinuierlich weiter, um besser skalierbare und anpassbare Lösungen anbieten zu können. Für future Integrationen empfehlen wir, sich mit dem Amazon Kendra Custom Connector Framework [1] vertraut zu machen, das ein breiteres Spektrum von Unternehmensanwendungsfällen mit verbesserter Flexibilität unterstützt.
SQL Server ist ein von Microsoft entwickeltes Datenbankverwaltungssystem. Amazon RDSfor SQL Server macht es einfach, SQL Server-Bereitstellungen in der Cloud einzurichten, zu betreiben und zu skalieren. Wenn Sie ein Amazon RDS (Microsoft SQL Server) -Benutzer sind, können Amazon Kendra Sie Ihre Amazon RDS (Microsoft SQL Server) -Datenquelle indizieren. Der Amazon Kendra JDBC-Datenquellenconnector unterstützt Microsoft SQL Server 2019.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer Datenquelle Amazon RDS (Microsoft SQL Server) herstellen.
Informationen zur Problembehandlung Ihres Datenquellenconnectors Amazon Kendra Amazon RDS (Microsoft SQL Server) finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-rds-ms-sql-server)
+ [
## Voraussetzungen
](#prerequisites-rds-ms-sql-server)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-rds-ms-sql-server)
+ [
## Hinweise
](#rds-ms-sql-server-notes)
## Unterstützte Features
+ Feldzuordnungen
+ Filterung des Benutzerkontextes
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Amazon RDS (Microsoft SQL Server) Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren Amazon RDS (Microsoft SQL Server) und AWS Konten vor.
**Stellen Sie in Amazon RDS (Microsoft SQL Server) sicher, dass Sie über Folgendes verfügen:**
+ Haben Sie Ihren Datenbankbenutzernamen und Ihr Passwort notiert.
**Wichtig**
Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Die URL, der Port und die Instanz Ihres Datenbank-Hosts wurden kopiert.
+ Geprüft, ob jedes Dokument in Amazon RDS (Microsoft SQL Server) und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Ihre Amazon RDS (Microsoft SQL Server-) Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir empfehlen **nicht**, dass Sie Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (falls zutreffend) wiederverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Amazon RDS (Microsoft SQL Server-) Datenquelle mit verbindenAmazon Kendra. Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Amazon RDS (Microsoft SQL Server-) Datenquelle herzustellen, müssen Sie Details zu Ihren Amazon RDS (Microsoft SQL Server-) Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Wenn Sie Amazon RDS (Microsoft SQL Server) noch nicht konfiguriert haben, Amazon Kendra siehe[Voraussetzungen](#prerequisites-rds-ms-sql-server).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen mit Amazon RDS (Microsoft SQL Server)**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Amazon RDS(Microsoft SQL Server) Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Connector Amazon RDS (Microsoft SQL Server)** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. Geben Sie unter **Quelle** die folgenden Informationen ein:
1. **Host** — Geben Sie den Datenbank-Hostnamen ein.
1. **Port** — Geben Sie den Datenbankport ein.
1. **Instanz** — Geben Sie die Datenbankinstanz ein.
1. **Speicherort des SSL-Zertifikats aktivieren** — Geben Sie hier den Amazon S3 Pfad zu Ihrer SSL-Zertifikatsdatei ein.
1. Geben Sie im Feld **Authentifizierung** die folgenden Informationen ein:
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Amazon RDS (Microsoft SQL Server-) Authentifizierungsanmeldeinformationen zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra- Amazon RDS (Microsoft SQL Server) -' wird Ihrem geheimen Namen automatisch hinzugefügt.
1. Geben Sie für **Datenbankbenutzername** und **Passwort** die Werte der Authentifizierungsdaten ein, die Sie aus Ihrer Datenbank kopiert haben.
1. Wählen Sie **Speichern**.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Wählen Sie unter **Synchronisierungsbereich** aus den folgenden Optionen aus:
+ **SQL-Abfrage** – Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
**Anmerkung**
Wenn ein Tabellenname Sonderzeichen (nicht alphanumerisch) enthält, müssen Sie den Tabellennamen in eckige Klammern setzen. Beispiel: *select \$1 from [my-database-table]*
+ **Primärschlüsselspalte** – Geben Sie den Primärschlüssel für die Datenbanktabelle an. Dadurch wird eine Tabelle in Ihrer Datenbank identifiziert.
+ **Titelspalte** – Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein.
+ **Hauptspalte** — Geben Sie den Namen der Hauptspalte des Dokuments in Ihrer Datenbanktabelle an.
1. Wählen Sie **unter Zusätzliche Konfiguration — *optional*** aus den folgenden Optionen, um bestimmte Inhalte zu synchronisieren, anstatt alle Dateien zu synchronisieren:
+ **Spalten zur Erkennung von Änderungen** — Geben Sie die Namen der Spalten ein, anhand derer Inhaltsänderungen erkannt Amazon Kendra werden sollen. Amazon Kendraindexiert den Inhalt neu, wenn sich eine dieser Spalten ändert.
+ ** IDsBenutzerspalte** — Geben Sie den Namen der Spalte ein, die den Benutzer enthält, dem der Zugriff auf IDs den Inhalt gewährt werden soll.
+ **Gruppenspalte** – Geben Sie den Namen der Spalte ein, die Gruppen enthält, denen Zugriff auf Inhalte gewährt werden soll.
+ ** URLsQuellspalte** — Geben Sie den Namen der Spalte ein, die die URLs zu indizierende Quelle enthält.
+ **Spalte mit Zeitstempeln** — Geben Sie den Namen der Spalte ein, die Zeitstempel enthält. Amazon Kendraverwendet Zeitstempelinformationen, um Änderungen an Ihren Inhalten zu erkennen und nur geänderte Inhalte zu synchronisieren.
+ **Zeitzonenspalte** – Geben Sie den Namen der Spalte ein, die Zeitzonen für den Inhalt enthält, der durchsucht werden soll.
+ **Zeitstempelformat** – Geben Sie den Namen der Spalte ein, die Zeitstempelformate enthält, die verwendet werden sollen, um Inhaltsänderungen zu erkennen und Ihre Inhalte erneut zu synchronisieren.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Im **Synchronisierungslaufplan** für **Frequenz** — Wie oft Amazon Kendra wird mit Ihrer Datenquelle synchronisiert?
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den generierten Standarddatenquellenfeldern — **Dokument IDs**, **Dokumenttitel** und **Quelle URLs** — aus, die Sie dem Index zuordnen möchten. Amazon Kendra
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen mit Amazon RDS (Microsoft SQL Server)**
Mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API müssen Sie Folgendes angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `JDBC` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Datenbanktyp** — Sie müssen den Datenbanktyp als `sqlserver` angeben.
+ **SQL-Abfrage** — Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen an. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
**Anmerkung**
Wenn ein Tabellenname Sonderzeichen (nicht alphanumerisch) enthält, müssen Sie den Tabellennamen in eckige Klammern setzen. Beispiel: *select \$1 from [my-database-table]*
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem Konto Amazon RDS (Microsoft SQL Server) erstellt haben. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"user name": "database user name",
"password": "password"
}
```
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (falls zutreffend) wiederzuverwenden.
+ **IAMrole** — Geben Sie an, `RoleArn` wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis zu gewähren und die erforderliche Öffentlichkeit APIs für den Connector Amazon RDS (Microsoft SQL Server) aufzurufen undAmazon Kendra. Weitere Informationen finden Sie unter [IAMRollen für Amazon RDS (Microsoft SQL Server-) Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Sie können mithilfe von Benutzern, Gruppen IDs, Quellen, Zeitstempeln und Zeitzonen angeben URLs, ob bestimmte Inhalte eingeschlossen werden sollen.
+ **Benutzerkontextfilterung und Zugriffskontrolle** — Amazon Kendra durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Datenquellenfelder Amazon RDS (Microsoft SQL Server) Ihren Amazon Kendra Indexfeldern zuzuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter[Amazon RDS (Microsoft SQL Server) -Vorlagenschema](ds-schemas.md#ds-rds-ms-sql-server-schema).
------
## Hinweise
+ Gelöschte Datenbankzeilen werden nicht nachverfolgt, wenn nach Amazon Kendra aktualisiertem Inhalt gesucht wird.
+ Die Größe von Feldnamen und Werten in einer Zeile Ihrer Datenbank darf 400 KB nicht überschreiten.
+ Wenn Ihre Datenbankdatenquelle eine große Datenmenge enthält und Sie nicht möchtenAmazon Kendra, dass Ihr gesamter Datenbankinhalt nach der ersten Synchronisierung indexiert wird, können Sie wählen, ob nur neue, geänderte oder gelöschte Dokumente synchronisiert werden sollen.
+ Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Es hat sich bewährt, das Hinzufügen von Tabellen mit sensiblen Daten oder personenbezogenen Daten (PII) zu vermeiden.
# Amazon RDS(MySQL)
**Anmerkung**
Der Amazon RDS(MySQL)-Konnektor wird für Bestandskunden bis zum 31. Mai 2026 weiterhin vollständig unterstützt. Dieser Konnektor ist zwar nicht mehr für neue Benutzer verfügbar, aktuelle Benutzer können ihn jedoch weiterhin ohne Unterbrechung verwenden. Wir entwickeln unser Konnektor-Portfolio kontinuierlich weiter, um besser skalierbare und anpassbare Lösungen anbieten zu können. Für future Integrationen empfehlen wir, sich mit dem Amazon Kendra Custom Connector Framework [1] vertraut zu machen, das ein breiteres Spektrum von Unternehmensanwendungsfällen mit verbesserter Flexibilität unterstützt.
Amazon RDS(Amazon Relational Database Service) ist ein Webservice, der die Einrichtung, den Betrieb und die Skalierung einer relationalen Datenbank in der AWS Cloud erleichtert. Wenn Sie ein Amazon RDS Benutzer sind, können Sie ihn verwenden, um Ihre Amazon Kendra Amazon RDS(MySQL) Datenquelle zu indizieren. Der Amazon Kendra Datenquellen-Connector unterstützt Amazon RDS MySql 5.6, 5.7 und 8.0.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer Amazon RDS(MySQL) Datenquelle herstellen.
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Amazon RDS(MySQL) Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-rds-mysql)
+ [
## Voraussetzungen
](#prerequisites-rds-mysql)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-rds-mysql)
+ [
## Hinweise
](#rds-mysql-notes)
## Unterstützte Features
+ Feldzuordnungen
+ Filterung des Benutzerkontextes
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Amazon RDS(MySQL) Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren Konten Amazon RDS(MySQL) und AWS Konten vor.
**Stellen Sie in Amazon RDS(MySQL) Folgendes sicher:**
+ Notieren Sie sich Ihren Datenbankbenutzernamen und Ihr Passwort.
**Wichtig**
Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Die URL, der Port und die Instanz Ihres Datenbank-Hosts wurden kopiert. Sie finden diese Informationen auf der Amazon RDS Konsole.
+ Vergewissert, dass jedes Dokument in Amazon RDS(MySQL) und zwischen anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Wir haben Ihre Amazon RDS(MySQL) Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Amazon RDS(MySQL) Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Amazon RDS(MySQL) Datenquelle herzustellen, müssen Sie Details zu Ihren Amazon RDS(MySQL) Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben, Amazon Kendra finden Sie Amazon RDS(MySQL) weitere Informationen unter[Voraussetzungen](#prerequisites-rds-mysql).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen Amazon RDS(MySQL)**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Amazon RDS(MySQL)Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Amazon RDS(MySQL)Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. Geben Sie unter **Quelle** die folgenden Informationen ein:
1. **Host** – Geben Sie die URL des Datenbankhosts ein, z. B.: `http://instance URL.region.rds.amazonaws.com`.
1. **Port** – Geben Sie den Datenbank-Port ein, z. B.: `5432`.
1. **Instance** – Geben Sie die Datenbank-Instance ein, z. B.: `postgres`.
1. **Speicherort für SSL-Zertifikate aktivieren** — Geben Sie hier den Amazon S3 Pfad zu Ihrer SSL-Zertifikatsdatei ein.
1. Geben Sie im Feld **Authentifizierung** die folgenden Informationen ein:
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Amazon RDS(MySQL) Authentifizierungsdaten zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra- Amazon RDS(MySQL) -' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Für **Datenbankbenutzername** und **Passwort** — Geben Sie die Werte der Authentifizierungsdaten ein, die Sie aus Ihrer Datenbank kopiert haben.
1. Wählen Sie **Speichern**.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Wählen Sie unter **Synchronisierungsbereich** aus den folgenden Optionen aus:
+ **SQL-Abfrage** – Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen müssen weniger als 32 KB groß sein. SQL-Abfragen müssen weniger als 32 KB groß sein und dürfen keine Semikolons (;) enthalten. Amazon Kendradurchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Primärschlüsselspalte** – Geben Sie den Primärschlüssel für die Datenbanktabelle an. Dadurch wird eine Tabelle in Ihrer Datenbank identifiziert.
+ **Titelspalte** – Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein.
+ **Hauptspalte** — Geben Sie den Namen der Hauptspalte des Dokuments in Ihrer Datenbanktabelle an.
1. Wählen Sie **unter Zusätzliche Konfiguration — *optional*** aus den folgenden Optionen, um bestimmte Inhalte zu synchronisieren, anstatt alle Dateien zu synchronisieren:
+ **Spalten zur Erkennung von Änderungen** — Geben Sie die Namen der Spalten ein, anhand derer Inhaltsänderungen erkannt Amazon Kendra werden sollen. Amazon Kendraindexiert den Inhalt neu, wenn sich eine dieser Spalten ändert.
+ ** IDsSpalte „Benutzer“** — Geben Sie den Namen der Spalte ein, die den Benutzer enthält, dem der Zugriff auf IDs den Inhalt gewährt werden soll.
+ **Gruppenspalte** – Geben Sie den Namen der Spalte ein, die Gruppen enthält, denen Zugriff auf Inhalte gewährt werden soll.
+ ** URLsQuellspalte** — Geben Sie den Namen der Spalte ein, die die URLs zu indizierende Quelle enthält.
+ **Spalte mit Zeitstempeln** — Geben Sie den Namen der Spalte ein, die Zeitstempel enthält. Amazon Kendraverwendet Zeitstempelinformationen, um Änderungen an Ihren Inhalten zu erkennen und nur geänderte Inhalte zu synchronisieren.
+ **Zeitzonenspalte** – Geben Sie den Namen der Spalte ein, die Zeitzonen für den Inhalt enthält, der durchsucht werden soll.
+ **Zeitstempelformat** – Geben Sie den Namen der Spalte ein, die Zeitstempelformate enthält, die verwendet werden sollen, um Inhaltsänderungen zu erkennen und Ihre Inhalte erneut zu synchronisieren.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Im **Synchronisierungslaufplan** für **Frequenz** — Wie oft Amazon Kendra wird mit Ihrer Datenquelle synchronisiert?
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den generierten Standarddatenquellenfeldern — **Dokument IDs**, **Dokumenttitel** und **Quelle URLs** — aus, die Sie dem Index zuordnen möchten. Amazon Kendra
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen Amazon RDS(MySQL)**
Mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API müssen Sie Folgendes angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `JDBC` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Datenbanktyp** — Sie müssen den Datenbanktyp als `mySql` angeben.
+ **SQL-Abfrage** — Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen an. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem Amazon RDS(MySQL) Konto erstellt haben. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"user name": "database user name",
"password": "password"
}
```
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (falls zutreffend) wiederzuverwenden.
+ **IAMRolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen Öffentlichkeit APIs für den Amazon RDS(MySQL) Connector und zu erteilen. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für Amazon RDS(MySQL) Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Sie können mithilfe von Benutzern, Gruppen IDs, Quellen, Zeitstempeln und Zeitzonen angeben URLs, ob bestimmte Inhalte eingeschlossen werden sollen.
+ **Feldzuordnungen — Ordnen** Sie Ihre Amazon RDS(MySQL) Datenquellenfelder Ihren Indexfeldern zu. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
+ **Benutzerkontextfilterung und Zugriffskontrolle** Amazon Kendra — durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter[Amazon RDS (MySQL) Vorlagenschema](ds-schemas.md#ds-rds-mysql-schema).
------
## Hinweise
+ Gelöschte Datenbankzeilen werden nicht nachverfolgt, wenn nach Amazon Kendra aktualisiertem Inhalt gesucht wird.
+ Die Größe von Feldnamen und Werten in einer Zeile Ihrer Datenbank darf 400 KB nicht überschreiten.
+ Wenn Ihre Datenbankdatenquelle eine große Datenmenge enthält und Sie nicht möchtenAmazon Kendra, dass Ihr gesamter Datenbankinhalt nach der ersten Synchronisierung indexiert wird, können Sie wählen, ob nur neue, geänderte oder gelöschte Dokumente synchronisiert werden sollen.
+ Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Es hat sich bewährt, das Hinzufügen von Tabellen mit sensiblen Daten oder personenbezogenen Daten (PII) zu vermeiden.
# Amazon RDS(Oracle)
**Anmerkung**
Der Amazon RDS(Oracle)-Konnektor wird für Bestandskunden bis zum 31. Mai 2026 weiterhin vollständig unterstützt. Dieser Konnektor ist zwar nicht mehr für neue Benutzer verfügbar, aktuelle Benutzer können ihn jedoch weiterhin ohne Unterbrechung verwenden. Wir entwickeln unser Konnektor-Portfolio kontinuierlich weiter, um besser skalierbare und anpassbare Lösungen anbieten zu können. Für future Integrationen empfehlen wir, sich mit dem Amazon Kendra Custom Connector Framework [1] vertraut zu machen, das ein breiteres Spektrum von Unternehmensanwendungsfällen mit verbesserter Flexibilität unterstützt.
Amazon RDS(Amazon Relational Database Service) ist ein Webservice, der die Einrichtung, den Betrieb und die Skalierung einer relationalen Datenbank in der AWS Cloud erleichtert. Wenn Sie ein Amazon RDS(Oracle) Benutzer sind, können Sie ihn verwenden, um Ihre Amazon Kendra Amazon RDS(Oracle) Datenquelle zu indizieren. Der Amazon Kendra Amazon RDS(Oracle) Datenquellen-Connector unterstützt Amazon RDS Oracle Database 21c, Oracle Database 19c, Oracle Database 12c.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die API eine Verbindung zu Ihrer Amazon RDS(Oracle) Datenquelle herstellen. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Amazon RDS(Oracle) Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-rds-oracle)
+ [
## Voraussetzungen
](#prerequisites-rds-oracle)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-rds-oracle)
+ [
## Hinweise
](#rds-oracle-notes)
## Unterstützte Features
+ Feldzuordnungen
+ Filterung des Benutzerkontextes
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Amazon RDS(Oracle) Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren Konten Amazon RDS(Oracle) und AWS Konten vor.
**Stellen Sie in Amazon RDS(Oracle) Folgendes sicher:**
+ Notieren Sie sich Ihren Datenbankbenutzernamen und Ihr Passwort.
**Wichtig**
Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Die URL, der Port und die Instanz Ihres Datenbank-Hosts wurden kopiert.
+ Vergewissert, dass jedes Dokument in Amazon RDS(Oracle) und zwischen anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Wir haben Ihre Amazon RDS(Oracle) Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Amazon RDS(Oracle) Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Amazon RDS(Oracle) Datenquelle herzustellen, müssen Sie Details zu Ihren Amazon RDS(Oracle) Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben, Amazon Kendra finden Sie Amazon RDS(Oracle) weitere Informationen unter[Voraussetzungen](#prerequisites-rds-oracle).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen Amazon RDS(Oracle)**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Amazon RDS(Oracle)Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Amazon RDS(Oracle)Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. Geben Sie unter **Quelle** die folgenden Informationen ein:
1. **Host** — Geben Sie den Datenbank-Hostnamen ein.
1. **Port** — Geben Sie den Datenbankport ein.
1. **Instanz** — Geben Sie die Datenbankinstanz ein.
1. **Speicherort für SSL-Zertifikate aktivieren** — Geben Sie hier den Amazon S3 Pfad zu Ihrer SSL-Zertifikatsdatei ein.
1. Geben Sie im Feld **Authentifizierung** die folgenden Informationen ein:
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Amazon RDS(Oracle) Authentifizierungsdaten zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra- Amazon RDS(Oracle) -' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Für **Datenbankbenutzername** und **Passwort** — Geben Sie die Werte der Authentifizierungsdaten ein, die Sie aus Ihrer Datenbank kopiert haben.
1. Wählen Sie **Speichern**.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Wählen Sie unter **Synchronisierungsbereich** aus den folgenden Optionen aus:
+ **SQL-Abfrage** – Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Primärschlüsselspalte** – Geben Sie den Primärschlüssel für die Datenbanktabelle an. Dadurch wird eine Tabelle in Ihrer Datenbank identifiziert.
+ **Titelspalte** – Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein.
+ **Hauptspalte** — Geben Sie den Namen der Textspalte des Dokuments in Ihrer Datenbanktabelle ein.
1. Wählen Sie **unter Zusätzliche Konfiguration — *optional*** aus den folgenden Optionen, um bestimmte Inhalte zu synchronisieren, anstatt alle Dateien zu synchronisieren:
+ **Spalten zur Erkennung von Änderungen** — Geben Sie die Namen der Spalten ein, anhand derer Inhaltsänderungen erkannt Amazon Kendra werden sollen. Amazon Kendraindexiert den Inhalt neu, wenn sich eine dieser Spalten ändert.
+ ** IDsSpalte Benutzer** — Geben Sie den Namen der Spalte ein, die den Benutzer enthält, dem der Zugriff auf IDs den Inhalt gewährt werden soll.
+ **Gruppenspalte** – Geben Sie den Namen der Spalte ein, die Gruppen enthält, denen Zugriff auf Inhalte gewährt werden soll.
+ ** URLsQuellspalte** — Geben Sie den Namen der Spalte ein, die die URLs zu indizierende Quelle enthält.
+ **Spalte mit Zeitstempeln** — Geben Sie den Namen der Spalte ein, die Zeitstempel enthält. Amazon Kendraverwendet Zeitstempelinformationen, um Änderungen an Ihren Inhalten zu erkennen und nur geänderte Inhalte zu synchronisieren.
+ **Zeitzonenspalte** – Geben Sie den Namen der Spalte ein, die Zeitzonen für den Inhalt enthält, der durchsucht werden soll.
+ **Zeitstempelformat** – Geben Sie den Namen der Spalte ein, die Zeitstempelformate enthält, die verwendet werden sollen, um Inhaltsänderungen zu erkennen und Ihre Inhalte erneut zu synchronisieren.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Im **Synchronisierungslaufplan** für **Frequenz** — Wie oft Amazon Kendra wird mit Ihrer Datenquelle synchronisiert?
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den generierten Standarddatenquellenfeldern — **Dokument IDs**, **Dokumenttitel** und **Quelle URLs** — aus, die Sie dem Index zuordnen möchten. Amazon Kendra
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen Amazon RDS(Oracle)**
Mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API müssen Sie Folgendes angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `JDBC` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Datenbanktyp** — Sie müssen den Datenbanktyp als `oracle` angeben.
+ **SQL-Abfrage** — Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen an. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem Amazon RDS(Oracle) Konto erstellt haben. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"user name": "database user name",
"password": "password"
}
```
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (falls zutreffend) wiederzuverwenden.
+ **IAMRolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen Öffentlichkeit APIs für den Amazon RDS(Oracle) Connector und zu erteilen. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für Amazon RDS(Oracle) Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Sie können mithilfe von Benutzern, Gruppen IDs, Quellen, Zeitstempeln und Zeitzonen angeben URLs, ob bestimmte Inhalte eingeschlossen werden sollen.
+ **Benutzerkontextfilterung und Zugriffskontrolle** — Amazon Kendra durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Amazon RDS(Oracle) Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter[Amazon RDS (Oracle) Vorlagenschema](ds-schemas.md#ds-rds-oracle-schema).
------
## Hinweise
+ Gelöschte Datenbankzeilen werden nicht nachverfolgt, wenn nach Amazon Kendra aktualisiertem Inhalt gesucht wird.
+ Die Größe von Feldnamen und Werten in einer Zeile Ihrer Datenbank darf 400 KB nicht überschreiten.
+ Wenn Ihre Datenbankdatenquelle eine große Datenmenge enthält und Sie nicht möchtenAmazon Kendra, dass Ihr gesamter Datenbankinhalt nach der ersten Synchronisierung indexiert wird, können Sie wählen, ob nur neue, geänderte oder gelöschte Dokumente synchronisiert werden sollen.
+ Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Es hat sich bewährt, das Hinzufügen von Tabellen mit sensiblen Daten oder personenbezogenen Daten (PII) zu vermeiden.
# Amazon RDS(PostgreSQL)
**Anmerkung**
Der Amazon RDS(PostgreSQL)-Konnektor wird für Bestandskunden bis zum 31. Mai 2026 weiterhin vollständig unterstützt. Dieser Konnektor ist zwar nicht mehr für neue Benutzer verfügbar, aktuelle Benutzer können ihn jedoch weiterhin ohne Unterbrechung verwenden. Wir entwickeln unser Konnektor-Portfolio kontinuierlich weiter, um besser skalierbare und anpassbare Lösungen anbieten zu können. Für future Integrationen empfehlen wir, sich mit dem Amazon Kendra Custom Connector Framework [1] vertraut zu machen, das ein breiteres Spektrum von Unternehmensanwendungsfällen mit verbesserter Flexibilität unterstützt.
Amazon RDSist ein Webservice, der es einfacher macht, eine relationale Datenbank in der Cloud einzurichten, zu betreiben und zu skalieren. AWS Wenn Sie ein Amazon RDS Benutzer sind, können Sie Amazon Kendra damit Ihre Amazon RDS(PostgreSQL) Datenquelle indizieren. Der Amazon Kendra Amazon RDS(PostgreSQL) Datenquellenconnector unterstützt PostgreSQL 9.6.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die API eine Verbindung zu Ihrer Amazon RDS(PostgreSQL) Datenquelle herstellen. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Amazon RDS(PostgreSQL) Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-rds-postgresql)
+ [
## Voraussetzungen
](#prerequisites-rds-postgresql)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-rds-postgresql)
+ [
## Hinweise
](#rds-postgresql-notes)
## Unterstützte Features
+ Feldzuordnungen
+ Filterung des Benutzerkontextes
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Amazon RDS(PostgreSQL) Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren Konten Amazon RDS(PostgreSQL) und AWS Konten vor.
**Stellen Sie in Amazon RDS(PostgreSQL) Folgendes sicher:**
+ Notieren Sie sich Ihren Datenbankbenutzernamen und Ihr Passwort.
**Wichtig**
Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Die URL, der Port und die Instanz Ihres Datenbank-Hosts wurden kopiert. Sie finden diese Informationen auf der Amazon RDS Konsole.
+ Vergewissert, dass jedes Dokument in Amazon RDS(PostgreSQL) und zwischen anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Wir haben Ihre Amazon RDS(PostgreSQL) Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Amazon RDS(PostgreSQL) Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Amazon RDS(PostgreSQL) Datenquelle herzustellen, müssen Sie Details zu Ihren Amazon RDS(PostgreSQL) Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben, Amazon Kendra finden Sie Amazon RDS(PostgreSQL) weitere Informationen unter[Voraussetzungen](#prerequisites-rds-postgresql).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen Amazon RDS(PostgreSQL)**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Amazon RDS(PostgreSQL)Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Amazon RDS(PostgreSQL)Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. Geben Sie unter **Quelle** die folgenden Informationen ein:
1. **Host** – Geben Sie die URL des Datenbankhosts ein, z. B.: `http://instance URL.region.rds.amazonaws.com`.
1. **Port** – Geben Sie den Datenbank-Port ein, z. B.: `5432`.
1. **Instance** – Geben Sie die Datenbank-Instance ein, z. B.: `postgres`.
1. **Speicherort für SSL-Zertifikate aktivieren** — Geben Sie hier den Amazon S3 Pfad zu Ihrer SSL-Zertifikatsdatei ein.
1. Geben Sie im Feld **Authentifizierung** die folgenden Informationen ein:
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Amazon RDS(PostgreSQL) Authentifizierungsdaten zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra- Amazon RDS(PostgreSQL) -' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Für **Datenbankbenutzername** und **Passwort** — Geben Sie die Werte der Authentifizierungsdaten ein, die Sie aus Ihrer Datenbank kopiert haben.
1. Wählen Sie **Speichern**.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Wählen Sie unter **Synchronisierungsbereich** aus den folgenden Optionen aus:
+ **SQL-Abfrage** – Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen müssen weniger als 32 KB groß sein. SQL-Abfragen müssen weniger als 32 KB groß sein und dürfen keine Semikolons (;) enthalten. Amazon Kendradurchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Primärschlüsselspalte** – Geben Sie den Primärschlüssel für die Datenbanktabelle an. Dadurch wird eine Tabelle in Ihrer Datenbank identifiziert.
+ **Titelspalte** – Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein.
+ **Hauptspalte** — Geben Sie den Namen der Hauptspalte des Dokuments in Ihrer Datenbanktabelle an.
1. Wählen Sie **unter Zusätzliche Konfiguration — *optional*** aus den folgenden Optionen, um bestimmte Inhalte zu synchronisieren, anstatt alle Dateien zu synchronisieren:
+ **Spalten zur Erkennung von Änderungen** — Geben Sie die Namen der Spalten ein, anhand derer Inhaltsänderungen erkannt Amazon Kendra werden sollen. Amazon Kendraindexiert den Inhalt neu, wenn sich eine dieser Spalten ändert.
+ ** IDsSpalte „Benutzer“** — Geben Sie den Namen der Spalte ein, die den Benutzer enthält, dem der Zugriff auf IDs den Inhalt gewährt werden soll.
+ **Gruppenspalte** – Geben Sie den Namen der Spalte ein, die Gruppen enthält, denen Zugriff auf Inhalte gewährt werden soll.
+ ** URLsQuellspalte** — Geben Sie den Namen der Spalte ein, die die URLs zu indizierende Quelle enthält.
+ **Spalte mit Zeitstempeln** — Geben Sie den Namen der Spalte ein, die Zeitstempel enthält. Amazon Kendraverwendet Zeitstempelinformationen, um Änderungen an Ihren Inhalten zu erkennen und nur geänderte Inhalte zu synchronisieren.
+ **Zeitzonenspalte** – Geben Sie den Namen der Spalte ein, die Zeitzonen für den Inhalt enthält, der durchsucht werden soll.
+ **Zeitstempelformat** – Geben Sie den Namen der Spalte ein, die Zeitstempelformate enthält, die verwendet werden sollen, um Inhaltsänderungen zu erkennen und Ihre Inhalte erneut zu synchronisieren.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Im **Synchronisierungslaufplan** für **Frequenz** — Wie oft Amazon Kendra wird mit Ihrer Datenquelle synchronisiert?
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den generierten Standarddatenquellenfeldern — **Dokument IDs**, **Dokumenttitel** und **Quelle URLs** — aus, die Sie dem Index zuordnen möchten. Amazon Kendra
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen Amazon RDS(PostgreSQL)**
Mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API müssen Sie Folgendes angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `JDBC` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Datenbanktyp** — Sie müssen den Datenbanktyp als `postgresql` angeben.
+ **SQL-Abfrage** — Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen an. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem Amazon RDS(PostgreSQL) Konto erstellt haben. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"user name": "database user name",
"password": "password"
}
```
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ **IAMRolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen Öffentlichkeit APIs für den Amazon RDS(PostgreSQL) Connector und zu erteilen. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für Amazon RDS(PostgreSQL) Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Sie können mithilfe von Benutzern, Gruppen IDs, Quellen, Zeitstempeln und Zeitzonen angeben URLs, ob bestimmte Inhalte eingeschlossen werden sollen.
+ **Benutzerkontextfilterung und Zugriffskontrolle** — Amazon Kendra durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Amazon RDS(PostgreSQL) Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter[Amazon RDS (PostgreSQL) -Vorlagenschema](ds-schemas.md#ds-rds-postgresql-schema).
------
## Hinweise
+ Gelöschte Datenbankzeilen werden nicht nachverfolgt, wenn nach Amazon Kendra aktualisiertem Inhalt gesucht wird.
+ Die Größe von Feldnamen und Werten in einer Zeile Ihrer Datenbank darf 400 KB nicht überschreiten.
+ Wenn Ihre Datenbankdatenquelle eine große Datenmenge enthält und Sie nicht möchtenAmazon Kendra, dass Ihr gesamter Datenbankinhalt nach der ersten Synchronisierung indexiert wird, können Sie wählen, ob nur neue, geänderte oder gelöschte Dokumente synchronisiert werden sollen.
+ Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Es hat sich bewährt, das Hinzufügen von Tabellen mit sensiblen Daten oder personenbezogenen Daten (PII) zu vermeiden.
# Amazon S3
Amazon S3 ist ein Objektspeicherdienst, der Daten als Objekte in Buckets speichert. Sie können es verwenden Amazon Kendra , um Ihr Amazon S3 Bucket-Repository mit Dokumenten zu indizieren.
**Warnung**
Amazon Kendra verwendet keine Bucket-Richtlinie, die einem Amazon Kendra Principal die Erlaubnis erteilt, mit einem S3-Bucket zu interagieren. Stattdessen verwendet es IAM Rollen. Stellen Sie sicher, dass dies Amazon Kendra nicht als vertrauenswürdiges Mitglied in Ihrer Bucket-Richtlinie enthalten ist, um Datensicherheitsprobleme zu vermeiden, die durch die versehentliche Vergabe von Berechtigungen an beliebige Prinzipale entstehen. Sie können jedoch eine Bucket-Richtlinie hinzufügen, um einen Amazon S3 Bucket für verschiedene Konten zu verwenden. Weitere Informationen finden Sie unter [Richtlinien zur Amazon S3 kontenübergreifenden Verwendung](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds-s3-cross-accounts) (auf der Registerkarte IAM S3-Rollen unter **IAM Rollen für Datenquellen**). Informationen zu IAM Rollen für S3-Datenquellen finden Sie unter [IAM Rollen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds-s3).
**Anmerkung**
Amazon Kendra unterstützt jetzt einen aktualisierten Amazon S3 Connector.
Die Konsole wurde automatisch für Sie aktualisiert. Alle neuen Konnektoren, die Sie in der Konsole erstellen, verwenden die aktualisierte Architektur. Wenn Sie die API verwenden, müssen Sie jetzt das [https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekt anstelle des `S3DataSourceConfiguration` Objekts verwenden, um Ihren Connector zu konfigurieren.
Konnektoren, die mit der älteren Konsolen- und API-Architektur konfiguriert wurden, funktionieren weiterhin wie konfiguriert. Sie können sie jedoch nicht bearbeiten oder aktualisieren. Wenn Sie Ihre Connectorkonfiguration bearbeiten oder aktualisieren möchten, müssen Sie einen neuen Connector erstellen.
Wir empfehlen, Ihren Connector-Workflow auf die aktualisierte Version zu migrieren. Die Support für Konnektoren, die mit der älteren Architektur konfiguriert wurden, soll bis Juni 2024 eingestellt werden.
Sie können über die [Amazon Kendra Konsole](https://console.aws.amazon.com/kendra/) oder die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer Amazon S3 Datenquelle herstellen.
**Anmerkung**
Informationen zum Generieren eines Synchronisierungsstatusberichts für Ihre Amazon S3 Datenquelle finden Sie unter [Problembehandlung bei Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/troubleshooting-data-sources.html#troubleshooting-data-sources-sync-status-manifest).
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra S3-Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-s3)
+ [
## Voraussetzungen
](#prerequisites-s3)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-s3)
+ [
# Eine Amazon S3 Datenquelle erstellen
](create-ds-s3.md)
+ [
# Amazon S3 Metadaten des Dokuments
](s3-metadata.md)
+ [
# Zugriffskontrolle für Amazon S3 Datenquellen
](s3-acl.md)
+ [
# Verwendung Amazon VPC mit einer Amazon S3 Datenquelle
](s3-vpc-example-1.md)
## Unterstützte Features
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre S3-Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihrem S3 und AWS Ihren Konten vor.
**Stellen Sie in S3 sicher, dass Sie über Folgendes verfügen:**
+ Der Name Ihres Amazon S3 Buckets wurde kopiert.
**Anmerkung**
Ihr Bucket muss sich in derselben Region wie Ihr Amazon Kendra Index befinden und Ihr Index muss berechtigt sein, auf den Bucket zuzugreifen, der Ihre Dokumente enthält.
+ Aktiviert, dass jedes Dokument in S3 und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem AWS Konto sicher, dass Sie über Folgendes verfügen:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
Wenn Sie noch keine IAM Rolle haben, können Sie die Konsole verwenden, um eine neue IAM Rolle zu erstellen, wenn Sie Ihre S3-Datenquelle mit verbinden Amazon Kendra. Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer S3-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer S3-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Wenn Sie S3 noch nicht für konfiguriert haben Amazon Kendra, finden Sie weitere Informationen unter[Voraussetzungen](#prerequisites-s3).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen Amazon S3 **
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon Kendra Konsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **S3-Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **S3-Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden optionalen Informationen ein:
1. **IAM Rolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAM Rollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Für **Speicherort der Datenquelle** — Geben Sie den Pfad zu dem Amazon S3 Bucket an, in dem Ihre Daten gespeichert sind. Wählen Sie **Browse S3** aus, um Ihren S3-Bucket auszuwählen.
1. Für „**Maximale Dateigröße**“ — Geben Sie ein Limit in MB an, damit nur Dateien gecrawlt werden, die unter diesem Limit liegen. Die maximal zulässige Dateigröße Amazon Kendra beträgt 50 MB.
1. Bei (optional) **Metadaten-Dateien mit Präfix zum Speicherort des Ordners** — Geben Sie den Pfad zu dem Ordner an, in dem Ihre Metadaten fields/attributes und andere Dokumentmetadaten gespeichert sind. Wählen Sie **S3 durchsuchen** aus, um nach Ihrem Metadatenordner zu suchen.
1. Für (optional) **Speicherort der Konfigurationsdatei für die Zugriffskontrollliste** — Geben Sie den Pfad zu der Datei an, die eine JSON-Struktur Ihrer Benutzer und deren Zugriff auf Dokumente enthält. Wählen Sie **S3 durchsuchen** aus, um nach Ihrer ACL-Datei zu suchen.
1. (Optional) **Entschlüsselungsschlüssel auswählen** — Wählen Sie diese Option, um einen Entschlüsselungsschlüssel zu verwenden. Sie können wählen, ob Sie einen vorhandenen Schlüssel verwenden möchten. AWS KMS
1. Für (optional) **zusätzliche Konfiguration** — Fügen Sie Muster hinzu, um bestimmte Dateien ein- oder auszuschließen. Alle Pfade beziehen sich auf den S3-Bucket mit dem Speicherort der Datenquelle.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Frequenz** aus, wie oft der Inhalt Ihrer Datenquelle synchronisiert und der Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden optionalen Informationen ein:
1. **Standardfeldzuordnungen** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
1. **Feld hinzufügen** — Wählen Sie diese Option, um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen Amazon S3**
Sie müssen mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API einen JSON-Wert des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `S3` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **BucketName**— Der Name des Buckets, der die Dokumente enthält.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **IAM Rolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager geheimes Geheimnis und das Aufrufen der erforderlichen Öffentlichkeit APIs für den S3-Connector zu erteilen und Amazon Kendra. Weitere Informationen finden Sie unter [IAM Rollen für S3-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob bestimmte Dateinamen, Dateitypen und Dateipfade ein- oder ausgeschlossen werden sollen. Sie verwenden Glob-Muster (Muster, mit denen ein Platzhaltermuster zu einer Liste von Pfadnamen erweitert werden kann, die dem angegebenen Muster entsprechen). Beispiele finden Sie unter [Verwendung von Ausschluss- und Include-Filtern](https://docs.aws.amazon.com/cli/latest/reference/s3/#use-of-exclude-and-include-filters) in der AWS CLI-Befehlsreferenz.
+ **Konfiguration von Dokumentmetadaten und Zugriffskontrolle** — Fügen Sie Dokumentmetadaten und Zugriffskontrolldateien hinzu, die Informationen wie den Quell-URI, den Autor des Dokuments oder benutzerdefinierte Dokumentattribute/-felder sowie Ihre Benutzer und die Dokumente, auf die sie zugreifen können, enthalten. Jede Metadatendatei enthält Metadaten zu einem einzelnen Dokument.
+ **Feldzuordnungen** — Wählen Sie, ob Sie Ihre S3-Datenquellenfelder Ihren Indexfeldern zuordnen möchten. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [S3Vorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-s3-schema).
------
### Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer S3-Datenquelle finden Sie unter:
+ [Suchen Sie mit Amazon Kendra S3 Connector mit VPC-Unterstützung genau nach Antworten](https://aws.amazon.com/blogs/machine-learning/search-for-answers-accurately-using-amazon-kendra-s3-connector-with-vpc-support/)
# Eine Amazon S3 Datenquelle erstellen
Die folgenden Beispiele veranschaulichen das Erstellen einer Amazon S3 Datenquelle. In den Beispielen wird davon ausgegangen, dass Sie bereits einen Index und eine IAM Rolle mit der Berechtigung zum Lesen der Daten aus dem Index erstellt haben. Weitere Informationen zu der IAM Rolle finden Sie unter [IAM Zugriffsrollen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Weitere Informationen zum Erstellen eines Indexes finden Sie unter [Index erstellen](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html).
------
#### [ CLI ]
```
aws kendra create-data-source \
--index-id index ID \
--name example-data-source \
--type S3 \
--configuration '{"S3Configuration":{"BucketName":"bucket name"}}'
--role-arn 'arn:aws:iam::account id:role:/role name
```
------
#### [ Python ]
Der folgende Python-Codeausschnitt erstellt eine Amazon S3 Datenquelle. Das vollständige Beispiel finden Sie unter. [Erste Schritte (AWS SDK für Python (Boto3))](gs-python.md)
```
print("Create an Amazon S3 data source.")
# Provide a name for the data source
name = "getting-started-data-source"
# Provide an optional description for the data source
description = "Getting started data source."
# Provide the IAM role ARN required for data sources
role_arn = "arn:aws:iam::${accountID}:role/${roleName}"
# Provide the data soource connection information
s3_bucket_name = "S3-bucket-name"
type = "S3"
# Configure the data source
configuration = {"S3DataSourceConfiguration":
{
"BucketName": s3_bucket_name
}
}
data_source_response = kendra.create_data_source(
Configuration = configuration,
Name = name,
Description = description,
RoleArn = role_arn,
Type = type,
IndexId = index_id
)
```
------
Das Erstellen Ihrer Datenquelle kann einige Zeit in Anspruch nehmen. Sie können den Fortschritt mithilfe der [DescribeDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DescribeDataSource.html)API überwachen. Wenn der Status der Datenquelle lautet, ist `ACTIVE` die Datenquelle einsatzbereit.
Die folgenden Beispiele zeigen, wie der Status einer Datenquelle abgerufen werden kann.
------
#### [ CLI ]
```
aws kendra describe-data-source \
--index-id index ID \
--id data source ID
```
------
#### [ Python ]
Der folgende Python-Codeausschnitt enthält Informationen über eine S3-Datenquelle. Das vollständige Beispiel finden Sie unter. [Erste Schritte (AWS SDK für Python (Boto3))](gs-python.md)
```
print("Wait for Amazon Kendra to create the data source.")
while True:
data_source_description = kendra.describe_data_source(
Id = "data-source-id",
IndexId = "index-id"
)
status = data_source_description["Status"]
print(" Creating data source. Status: "+status)
time.sleep(60)
if status != "CREATING":
break
```
------
Diese Datenquelle hat keinen Zeitplan und wird daher nicht automatisch ausgeführt. Um die Datenquelle zu indizieren, rufen Sie auf, [StartDataSourceSyncJob](https://docs.aws.amazon.com/kendra/latest/APIReference/API_StartDataSourceSyncJob.html)um den Index mit der Datenquelle zu synchronisieren.
Die folgenden Beispiele veranschaulichen die Synchronisation einer Datenquelle.
------
#### [ CLI ]
```
aws kendra start-data-source-sync-job \
--index-id index ID \
--id data source ID
```
------
#### [ Python ]
Der folgende Python-Codeausschnitt synchronisiert eine Amazon S3 Datenquelle. Das vollständige Beispiel finden Sie unter. [Erste Schritte (AWS SDK für Python (Boto3))](gs-python.md)
```
print("Synchronize the data source.")
sync_response = kendra.start_data_source_sync_job(
Id = "data-source-id",
IndexId = "index-id"
)
```
------
# Amazon S3 Metadaten des Dokuments
Mithilfe einer Metadatendatei können Sie Metadaten, zusätzliche Informationen zu einem Dokument, zu Dokumenten in einem Amazon S3 Bucket hinzufügen. Jede Metadatendatei ist einem indizierten Dokument zugeordnet.
Ihre Metadatendateien müssen im selben -Bucket wie Ihre indexierten Dateien gespeichert werden. Sie können einen Speicherort innerhalb des Buckets für Ihre Metadatendateien angeben, indem Sie die Konsole oder das `S3Prefix` Feld des `DocumentsMetadataConfiguration` Parameters verwenden, wenn Sie eine Amazon S3 Datenquelle erstellen. Wenn Sie kein Amazon S3 -Präfix angeben, müssen Ihre Metadatendateien am selben Ort wie Ihre indexierten Dokumente gespeichert werden.
Wenn Sie ein Amazon S3 Präfix für Ihre Metadatendateien angeben, befinden sie sich in einer Verzeichnisstruktur parallel zu Ihren indizierten Dokumenten. Amazon Kendra sucht nur im angegebenen Verzeichnis nach Ihren Metadaten. Wenn die Metadaten nicht gelesen werden, überprüfen Sie, ob der Speicherort des Verzeichnisses mit dem Speicherort Ihrer Metadaten übereinstimmt.
Die folgenden Beispiele zeigen, wie der Speicherort des indexierten Dokuments dem Speicherort der Metadatendatei zugeordnet wird. Beachten Sie, dass der Amazon S3 Schlüssel des Dokuments an das Amazon S3 Präfix der Metadaten angehängt und dann mit einem Suffix versehen wird, `.metadata.json` um den Pfad der Metadatendatei zu bilden. Amazon S3 Der kombinierte Amazon S3 Schlüssel mit dem Amazon S3 Präfix und `.metadata.json` Suffix der Metadaten darf insgesamt nicht mehr als 1024 Zeichen lang sein. Es wird empfohlen, dass Sie Ihren Amazon S3 Schlüssel unter 1000 Zeichen halten, um zusätzliche Zeichen bei der Kombination Ihres Schlüssels mit dem Präfix und dem Suffix zu berücksichtigen.
```
Bucket name:
s3://bucketName
Document path:
documents
Metadata path:
none
File mapping
s3://bucketName/documents/file.txt ->
s3://bucketName/documents/file.txt.metadata.json
```
```
Bucket name:
s3://bucketName
Document path:
documents/legal
Metadata path:
metadata
File mapping
s3://bucketName/documents/legal/file.txt ->
s3://bucketName/metadata/documents/legal/file.txt.metadata.json
```
Die Metadaten Ihres Dokuments sind in einer JSON-Datei definiert. Die Datei muss eine UTF-8-Textdatei ohne BOM-Markierung sein. Der Dateiname der JSON-Datei muss `..metadata.json` sein. In diesem Beispiel ist „Dokument“ der Name des Dokuments, für das sich die Metadaten beziehen, und „Erweiterung“ ist die Dateierweiterung für das Dokument. Die Dokument-ID muss in `..metadata.json` eindeutig sein.
Der Inhalt der JSON-Datei folgt dieser Vorlage. Alle attributes/fields sind optional, sodass es nicht erforderlich ist, alle Attribute einzubeziehen. Sie müssen für jedes Attribut, das Sie einbeziehen möchten, einen Wert angeben. Der Wert darf nicht leer sein. Wenn Sie den nicht angeben`_source_uri`, verweisen die von Amazon Kendra in den Suchergebnissen zurückgegebenen Links auf den Amazon S3 Bucket, der das Dokument enthält. `DocumentId`ist dem Feld zugeordnet `s3_document_id` und ist der absolute Pfad zum Dokument in S3.
```
{
"DocumentId": "S3 document ID, the S3 path to doc",
"Attributes": {
"_category": "document category",
"_created_at": "ISO 8601 encoded string",
"_last_updated_at": "ISO 8601 encoded string",
"_source_uri": "document URI",
"_version": "file version",
"_view_count": number of times document has been viewed,
"custom attribute key": "custom attribute value",
additional custom attributes
},
"AccessControlList": [
{
"Name": "user name",
"Type": "GROUP | USER",
"Access": "ALLOW | DENY"
}
],
"Title": "document title",
"ContentType": "For example HTML | PDF. For supported content types, see [Types of documents](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html)."
}
```
Die Metadatenfelder `_created_at` und `_last_updated_at` sind nach ISO 8601 kodierte Datumsangaben. Beispiel: 2012-03-25T12:30:10\$101:00 ist das ISO-8601-Datums-/Uhrzeitformat für den 25. März 2012 um 12:30 Uhr (plus 10 Sekunden) in mitteleuropäischer Zeit (CET).
Sie können dem `Attributes` Feld über ein Dokument zusätzliche Informationen hinzufügen, die Sie zum Filtern von Abfragen oder zum Gruppieren von Abfrageantworten verwenden. Weitere Informationen finden Sie unter [Benutzerdefinierte Dokumentfelder erstellen](custom-attributes.md).
Sie können das `AccessControlList`-Feld verwenden, um die Antwort aus einer Abfrage zu filtern. Auf diese Weise haben nur bestimmte Benutzer und Gruppen Zugriff auf Dokumente. Weitere Informationen finden Sie unter [Filtern nach Benutzerkontext](user-context-filter.md).
# Zugriffskontrolle für Amazon S3 Datenquellen
Sie können den Zugriff auf Dokumente in einer Amazon S3 Datenquelle mithilfe einer Konfigurationsdatei steuern. Sie geben die Datei in der Konsole oder als `AccessControlListConfiguration` Parameter an, wenn Sie die [UpdateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateDataSource.html)API [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html)oder aufrufen.
Die Konfigurationsdatei enthält eine JSON-Struktur, die ein S3-Präfix identifiziert und die Zugriffseinstellungen für das Präfix auflistet. Das Präfix kann ein Pfad oder eine einzelne Datei sein. Wenn das Präfix ein Pfad ist, gelten die Zugriffseinstellungen für alle Dateien in diesem Pfad. In der JSON-Konfigurationsdatei gibt es eine maximale Anzahl von S3-Präfixen und eine standardmäßige maximale Dateigröße. Weitere Informationen finden Sie unter [Kontingente für Amazon Kendra](quotas.md).
Sie können in den Zugriffseinstellungen sowohl Benutzer als auch Gruppen angeben. Wenn Sie den Index abfragen, geben Sie Benutzer- und Gruppeninformationen an. Weitere Informationen finden Sie unter [Nach Benutzerattribut filtern](user-context-filter.md#context-filter-attribute).
Die JSON-Struktur für die Konfigurationsdatei muss das folgende Format aufweisen:
```
[
{
"keyPrefix": "s3://BUCKETNAME/prefix1/",
"aclEntries": [
{
"Name": "user1",
"Type": "USER",
"Access": "ALLOW"
},
{
"Name": "group1",
"Type": "GROUP",
"Access": "DENY"
}
]
},
{
"keyPrefix": "s3://prefix2",
"aclEntries": [
{
"Name": "user2",
"Type": "USER",
"Access": "ALLOW"
},
{
"Name": "user1",
"Type": "USER",
"Access": "DENY"
},
{
"Name": "group1",
"Type": "GROUP",
"Access": "DENY"
}
]
}
]
```
# Verwendung Amazon VPC mit einer Amazon S3 Datenquelle
Dieses Thema enthält ein step-by-step Beispiel, das zeigt, wie Sie mithilfe eines Amazon S3 S3-Connectors über Amazon VPC eine Verbindung zu einem Amazon S3 S3-Bucket herstellen. Das Beispiel geht davon aus, dass Sie mit einem vorhandenen S3-Bucket beginnen. Wir empfehlen, dass Sie nur einige Dokumente in Ihren S3-Bucket hochladen, um das Beispiel zu testen.
Sie können über eine Verbindung Amazon Kendra zu Ihrem Amazon S3 Bucket eine Verbindung herstellen Amazon VPC. Dazu müssen Sie bei der Erstellung Ihres Amazon S3 Datenquellenconnectors das Amazon VPC Subnetz und die Amazon VPC Sicherheitsgruppen angeben.
**Wichtig**
Damit ein Amazon Kendra Amazon S3 Connector auf Ihren Amazon S3 Bucket zugreifen kann, stellen Sie sicher, dass Sie Ihrer Virtual Private Cloud (VPC) einen Amazon S3 Endpunkt zugewiesen haben.
Amazon Kendra Um Dokumente aus Ihrem Amazon S3 Bucket zu synchronisieren Amazon VPC, müssen Sie die folgenden Schritte ausführen:
+ Richten Sie einen Amazon S3 Endpunkt für ein Amazon VPC. Weitere Informationen zum Einrichten eines Amazon S3 Endpunkts finden Sie Amazon S3 im *AWS PrivateLink Handbuch* unter [Gateway-Endpunkte für](https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-s3.html).
+ (Optional) Sie haben Ihre Amazon S3 Bucket-Richtlinien überprüft, um sicherzustellen, dass der Amazon S3 Bucket von der Virtual Private Cloud (VPC) aus zugänglich ist, der Sie zugewiesen Amazon Kendra haben. Weitere Informationen finden Sie unter [Steuern des Zugriffs von VPC-Endpunkten mit Bucket-Richtlinien](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies-vpc-endpoint.html) im *Amazon S3 S3-Benutzerhandbuch*
**Topics**
+ [
## Schritt 1: Konfigurieren Sie ein Amazon VPC
](#s3-configure-vpc)
+ [
## (Optional) Schritt 2: Amazon S3 Bucket-Richtlinie konfigurieren
](#s3-configure-bucket-policy)
+ [
## Schritt 3: Erstellen Sie einen Amazon S3 Testdatenquellen-Connector
](#s3-connect-vpc)
## Schritt 1: Konfigurieren Sie ein Amazon VPC
Erstellen Sie ein VPC-Netzwerk mit einem privaten Subnetz mit einem Amazon S3 Gateway-Endpunkt und einer Sicherheitsgruppe für Amazon Kendra die spätere Verwendung.
**So konfigurieren Sie eine VPC mit einem privaten Subnetz, einem S3-Endpunkt und einer Sicherheitsgruppe**
1. Melden Sie sich bei an AWS-Managementkonsole und öffnen Sie die Amazon VPC Konsole unter. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/)
1. **Erstellen Sie eine VPC mit einem privaten Subnetz und einem S3-Endpunkt Amazon Kendra zur Verwendung von:**
Wählen Sie im Navigationsbereich **Ihre** und VPCs dann **Create VPC** aus.
1. Wählen Sie unter **Zu erstellende Ressourcen** die Option **VPC und mehr** aus.
1. Aktivieren Sie für **Namenstag** die **Option Automatisch generieren und geben Sie** dann ein. **kendra-s3-example**
1. Behalten Sie für den ** IPv6 CIDR-BlockIPv4 /**die Standardwerte bei.
1. Wählen Sie für **Anzahl der Availability Zones (AZs)** **die Zahl 1.**
1. Wählen Sie **Anpassen AZs** und wählen Sie dann eine Availability Zone aus der Liste **Erste Availability Zone** aus.
Amazon Kendra unterstützt nur eine bestimmte Gruppe von Availability Zones.
1. Wählen Sie für **Anzahl der öffentlichen Subnetze** die **Zahl 0** aus.
1. Wählen Sie für **Anzahl der privaten Subnetze** die **Zahl 1 aus.**
1. Wählen Sie für **NAT gateways** (NAT-Gateways) **None** (Keine) aus.
1. **Wählen Amazon S3 Sie für **VPC-Endpoints** Gateway.** .
1. Belassen Sie die übrigen Werte auf ihren Standardeinstellungen.
1. Wählen Sie **Create VPC** (VPC erstellen).
Warten Sie, bis der Workflow „**VPC erstellen**“ abgeschlossen ist. **Wählen Sie dann **View VPC aus, um die VPC** zu überprüfen, die Sie gerade erstellt haben.**
Sie haben jetzt ein VPC-Netzwerk mit einem privaten Subnetz erstellt, das keinen Zugriff auf das öffentliche Internet hat.
1. **Kopieren Sie Ihre VPC-Endpunkt-ID Ihres Amazon S3 S3-Endpunkts:**
1. Wählen Sie im Navigationsbereich **Endpunkte** aus.
1. Suchen Sie in der Liste **Endpoints** den Amazon S3 S3-Endpunkt`kendra-s3-example-vpce-s3`, den Sie gerade zusammen mit Ihrer VPC erstellt haben.
1. Notieren Sie sich die **VPC-Endpunkt-ID.**
Sie haben jetzt einen Amazon S3 S3-Gateway-Endpunkt erstellt, um über ein Subnetz auf Ihren Amazon S3 S3-Bucket zuzugreifen.
1. **Erstellen Sie eine **Sicherheitsgruppe** Amazon Kendra zur Verwendung von:**
1. Wählen Sie im Navigationsbereich **Sicherheitsgruppen** und anschließend **Sicherheitsgruppe erstellen** aus.
1. Geben Sie für **Security group name** (Name der Sicherheitsgruppe) **s3-data-source-security-group** ein.
1. Wählen Sie Ihre VPC aus der **Amazon VPC**Liste aus.
1. Behalten Sie die **Standardregeln für eingehenden** **und ausgehenden Datenverkehr** bei.
1. Wählen Sie **Sicherheitsgruppe erstellen** aus.
Sie haben jetzt eine VPC-Sicherheitsgruppe erstellt.
Sie weisen das Subnetz und die Sicherheitsgruppe, die Sie während der Connector-Konfiguration erstellt haben, Ihrem Amazon Kendra Amazon S3 S3-Datenquellen-Connector zu.
## (Optional) Schritt 2: Amazon S3 Bucket-Richtlinie konfigurieren
In diesem optionalen Schritt erfahren Sie, wie Sie eine Amazon S3 S3-Bucket-Richtlinie so konfigurieren, dass Ihr Amazon S3 S3-Bucket nur von der VPC aus zugänglich ist, der Sie ihn zuweisen Amazon Kendra.
Amazon Kendra verwendet IAM-Rollen für den Zugriff auf Ihren Amazon S3 S3-Bucket und erfordert nicht, dass Sie eine Amazon S3 S3-Bucket-Richtlinie konfigurieren. Möglicherweise finden Sie es jedoch nützlich, eine Bucket-Richtlinie zu erstellen, wenn Sie einen Amazon S3 Connector mithilfe eines Amazon S3 S3-Buckets konfigurieren möchten, für den bereits Richtlinien bestehen, die den Zugriff aus dem öffentlichen Internet darauf einschränken.
**Um Ihre Amazon S3 Bucket-Richtlinie zu konfigurieren**
1. Öffnen Sie die Amazon S3 S3-Konsole unter[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Wählen Sie im Navigationsbereich **Buckets** aus.
1. Wählen Sie den Namen des Amazon S3 S3-Buckets, mit dem Sie synchronisieren möchten Amazon Kendra.
1. Wählen Sie den Tab **Berechtigungen**, scrollen Sie nach unten zu **Bucket-Richtlinie** und klicken Sie dann auf **Bearbeiten**.
1. Fügen Sie Ihre Bucket-Richtlinie hinzu oder ändern Sie sie, sodass der Zugriff nur von dem VPC-Endpunkt aus möglich ist, den Sie erstellt haben.
Hier finden Sie ein Beispiel für eine Bucket-Richtlinie. Ersetzen Sie *`bucket-name`* und *`vpce-id`* durch Ihren Amazon S3 S3-Bucket-Namen und die Amazon S3 S3-Endpunkt-ID, die Sie sich zuvor notiert haben.
1. Wählen Sie **Änderungen speichern** aus.
Ihr S3-Bucket ist jetzt nur von der spezifischen VPC aus zugänglich, die Sie erstellt haben.
## Schritt 3: Erstellen Sie einen Amazon S3 Testdatenquellen-Connector
Um Ihre Amazon VPC Konfiguration zu testen, erstellen Sie einen Amazon S3 Connector. Konfigurieren Sie es dann mit der VPC, die Sie erstellt haben, indem Sie die unter beschriebenen Schritte ausführen. [Amazon S3](https://docs.aws.amazon.com/kendra/latest/dg/data-source-s3.html)
Wählen Sie für Amazon VPC Konfigurationswerte die Werte aus, die Sie in diesem Beispiel erstellt haben:
+ **Amazon VPC(VPC)** — `kendra-s3-example-vpc`
+ **Subnetze** — `kendra-s3-example-subnet-private1-[availability zone]`
+ **Sicherheitsgruppen** — `s3-data-source-security-group`
Warten Sie, bis Ihr Connector mit der Erstellung fertig ist. Nachdem der Amazon S3 Connector erstellt wurde, wählen Sie **Jetzt synchronisieren**, um eine Synchronisierung zu starten.
Je nachdem, wie viele Dokumente sich in Ihrem Amazon S3 Bucket befinden, kann es mehrere Minuten bis mehrere Stunden dauern, bis die Synchronisierung abgeschlossen ist. Um das Beispiel zu testen, empfehlen wir Ihnen, nur einige Dokumente in Ihren S3-Bucket hochzuladen. Wenn Ihre Konfiguration korrekt ist, sollte irgendwann der **Synchronisierungsstatus** **Abgeschlossen angezeigt werden**.
Wenn Sie auf Fehler stoßen, finden Sie weitere Informationen [unter Amazon VPC Verbindungsprobleme](https://docs.aws.amazon.com/kendra/latest/dg/vpc-connector-troubleshoot.html).
# Amazon Kendra Webcrawler
Sie können den Amazon Kendra Web Crawler verwenden, um Webseiten zu crawlen und zu indizieren.
Sie können nur öffentlich zugängliche Websites oder interne Unternehmenswebsites crawlen, die das sichere Kommunikationsprotokoll Hypertext Transfer Protocol Secure (HTTPS) verwenden. Wenn Sie beim Crawling einer Website einen Fehler erhalten, kann es sein, dass die Website für das Crawling gesperrt ist. Um interne Websites zu crawlen, können Sie einen Webproxy einrichten. Der Webproxy muss öffentlich zugänglich sein. Sie können auch eine Authentifizierung verwenden, um auf Websites zuzugreifen und diese zu crawlen.
*Bei der Auswahl der zu indizierenden Websites müssen Sie die [Amazon Acceptable Use Policy](https://aws.amazon.com/aup/) (Richtlinie zur zulässigen Nutzung) und alle anderen Amazon-Bedingungen einhalten. Denken Sie daran, dass Sie Amazon Kendra Web Crawler nur verwenden dürfen, um Ihre eigenen Webseiten oder Webseiten zu indizieren, für deren Indexierung Sie autorisiert sind. Informationen dazu, wie Sie verhindern können, dass Amazon Kendra Web Crawler Ihre Website (s) indexiert, finden Sie unter. [Konfiguration der `robots.txt` Datei für Amazon Kendra Web Crawler](stop-web-crawler.md)*
**Anmerkung**
**Der Missbrauch von Amazon Kendra Web Crawler zum aggressiven Crawlen von Websites oder Webseiten, die Ihnen nicht gehören, wird nicht als akzeptable Nutzung angesehen.**
Amazon Kendra hat zwei Versionen des Connectors. web crawler Zu den unterstützten Funktionen jeder Version gehören:
**Amazon Kendra Web Crawler-Konnektor v1.0//API [https://docs.aws.amazon.com/kendra/latest/dg/API_WebCrawlerConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_WebCrawlerConfiguration.html)**
+ Webproxy
+ Einschluss- und Ausschlussfilter
**Amazon Kendra Webcrawler-Konnektor v2.0/API [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)**
+ Feldzuordnungen
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Webproxy
+ Basic-, NTLM/Kerberos-, SAML- und Formularauthentifizierung für Ihre Websites
+ Virtual Private Cloud (VPC)
**Wichtig**
Die Erstellung von Web Crawler v2.0-Connectoren wird von nicht unterstützt. CloudFormation Verwenden Sie den Web Crawler v1.0-Connector, wenn Sie Unterstützung benötigen. CloudFormation
Informationen zur Problembehandlung Ihres Amazon Kendra Webcrawler-Datenquellen-Connectors finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
# Amazon Kendra Web Crawler-Konnektor v1.0
](data-source-v1-web-crawler.md)
+ [
# Amazon Kendra Web Crawler-Konnektor v2.0
](data-source-v2-web-crawler.md)
+ [
# Konfiguration der `robots.txt` Datei für Amazon Kendra Web Crawler
](stop-web-crawler.md)
# Amazon Kendra Web Crawler-Konnektor v1.0
Sie können Amazon Kendra Web Crawler verwenden, um Webseiten zu crawlen und zu indizieren.
Sie können nur öffentlich zugängliche Websites und Websites crawlen, die das sichere Kommunikationsprotokoll Hypertext Transfer Protocol Secure (HTTPS) verwenden. Wenn Sie beim Crawling einer Website einen Fehler erhalten, kann es sein, dass die Website für das Crawling gesperrt ist. Um interne Websites zu crawlen, können Sie einen Webproxy einrichten. Der Webproxy muss öffentlich zugänglich sein.
*Bei der Auswahl der zu indizierenden Websites müssen Sie die [Amazon Acceptable Use Policy](https://aws.amazon.com/aup/) (Richtlinie zur zulässigen Nutzung) und alle anderen Amazon-Bedingungen einhalten. Denken Sie daran, dass Sie Amazon Kendra Web Crawler nur verwenden dürfen, um Ihre eigenen Webseiten oder Webseiten zu indizieren, für deren Indexierung Sie autorisiert sind. Informationen dazu, wie Sie verhindern können, dass Amazon Kendra Web Crawler Ihre Website (s) indexiert, finden Sie unter. [Konfiguration der `robots.txt` Datei für Amazon Kendra Web Crawler](stop-web-crawler.md)*
**Anmerkung**
**Der Missbrauch von Amazon Kendra Web Crawler zum aggressiven Crawlen von Websites oder Webseiten, die Ihnen nicht gehören, wird nicht als akzeptable Nutzung angesehen.**
Informationen zur Problembehandlung Ihres Amazon Kendra Webcrawler-Datenquellen-Connectors finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-v1-web-crawler)
+ [
## Voraussetzungen
](#prerequisites-v1-web-crawler)
+ [
## Anweisungen zur Verbindung
](#data-source-v1-procedure-web-crawler)
+ [
## Weitere Informationen
](#web-crawler-learn-more)
## Unterstützte Features
+ Webproxy
+ Einschluss- und Ausschlussfilter
## Voraussetzungen
Bevor Sie Ihre Websites Amazon Kendra indexieren können, sollten Sie die Details Ihrer Websites und AWS Konten überprüfen.
**Stellen Sie für Ihre Websites sicher, dass Sie über Folgendes verfügen:**
+ Sie haben den Startwert oder die Sitemap URLs der Websites kopiert, die Sie indexieren möchten.
+ **Für Websites, die eine Standardauthentifizierung erfordern**: Notiert den Benutzernamen und das Passwort und kopiert den Hostnamen der Website und die Portnummer.
+ **Optional:** Der Hostname der Website und die Portnummer wurden kopiert, wenn Sie einen Webproxy verwenden möchten, um eine Verbindung zu internen Websites herzustellen, die Sie crawlen möchten. Der Web-Proxy muss öffentlich zugänglich sein. Amazon Kendra unterstützt die Verbindung zu Web-Proxyservern, die über eine Standardauthentifizierung verfügen, oder Sie können eine Verbindung ohne Authentifizierung herstellen.
+ Vergewissert, dass jedes Webseitendokument, das Sie indexieren möchten, einzigartig ist und auch für andere Datenquellen gilt, die Sie für denselben Index verwenden möchten. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem AWS Konto sicher, dass Sie über Folgendes verfügen:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Für Websites, die eine Authentifizierung erfordern, oder wenn Sie einen Webproxy mit Authentifizierung verwenden, haben Sie Ihre Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre web crawler Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Amazon Kendra Um eine Verbindung mit Ihrer web crawler Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer web crawler Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben, Amazon Kendra finden Sie web crawler weitere Informationen unter[Voraussetzungen](#prerequisites-v1-web-crawler).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen web crawler**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon Kendra Konsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Webcrawler-Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Webcrawler-Connector** mit dem Tag „V2.0".
1. Geben Sie auf der Seite **„Datenquellendetails angeben**“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Wählen Sie für **Quelle** je nach Anwendungsfall zwischen **Quell URLs - und Quell-Sitemaps** und geben Sie die Werte für jede Sitemaps ein.**
Sie können bis zu 10 Quell URLs - und drei Sitemaps hinzufügen.
**Anmerkung**
Wenn du eine Sitemap crawlen möchtest, überprüfe, ob die Basis- oder Stamm-URL mit der auf deiner Sitemap-Seite URLs angegebenen URL übereinstimmt. Wenn Ihre Sitemap-URL beispielsweise lautet *https://example.com/sitemap-page.html*, sollte die auf dieser Sitemap-Seite URLs aufgeführte Seite auch die Basis-URL "https://example.com/" verwenden.
1. (Optional) Geben Sie für **einen Web-Proxy** die folgenden Informationen ein:
1. **Hostname** — Der Hostname, für den ein Webproxy erforderlich ist.
1. **Portnummer** — Der vom Host-URL-Transportprotokoll verwendete Port. Die Portnummer sollte ein numerischer Wert zwischen 0 und 65535 sein.
1. Für **Web-Proxy-Anmeldeinformationen** — Wenn Ihre Web-Proxyverbindung eine Authentifizierung erfordert, wählen Sie ein vorhandenes Geheimnis oder erstellen Sie ein neues Geheimnis, um Ihre Authentifizierungsinformationen zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix AmazonKendra-WebCrawler- '' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Für **Benutzername** und **Passwort** — Geben Sie diese grundlegenden Authentifizierungsdaten für Ihre Websites ein.
1. Wählen Sie **Speichern**.
1. (Optional) **Hosts mit Authentifizierung** — Wählen Sie diese Option, um weitere Hosts mit Authentifizierung hinzuzufügen.
1. **IAM Rolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAM Rollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. **Crawlbereich** — Wählen Sie die Art der Webseiten aus, die Sie crawlen möchten.
1. **Crawl-Tiefe** — Wählen Sie aus der Seed-URL die Anzahl der Ebenen aus, die gecrawlt werden sollen. Amazon Kendra
1. In den **erweiterten Crawling-Einstellungen** und der Option **Zusätzliche Konfiguration werden** die folgenden Informationen eingegeben:
1. **Maximale Dateigröße** — Die maximale Webseite- oder Anhangsgröße, die gecrawlt werden soll. Mindestens 0,000001 MB (1 Byte). Maximal 50 MB.
1. **Maximale Anzahl an Links pro Seite** — Die maximale Anzahl von Links, die pro Seite gecrawlt wurden. Links werden in der Reihenfolge ihres Erscheinens gecrawlt. Mindestens 1. link/page. Maximum 1000 links/page
1. **Maximale Drosselung** — Die maximale Anzahl von URLs gecrawlten Daten pro Hostname pro Minute. Mindestens 1. URLs/host name/minute. Maximum 300 URLs/host name/minute
1. **Regex-Muster — Fügen Sie Muster** mit regulären Ausdrücken hinzu, um bestimmte Muster ein- oder auszuschließen. URLs Sie können bis zu 100 Muster hinzufügen.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Häufigkeit** aus, wie oft die Synchronisierung mit Amazon Kendra Ihrer Datenquelle erfolgen soll.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen web crawler**
Mithilfe der [WebCrawlerConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_WebCrawlerConfiguration.html)API müssen Sie Folgendes angeben:
+ **URLs**— Geben Sie den Startpunkt oder den Startpunkt URLs der Websites oder die Sitemap URLs der Websites an, mit [https://docs.aws.amazon.com/kendra/latest/dg/API_SeedUrlConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_SeedUrlConfiguration.html)denen Sie crawlen möchten, und. [https://docs.aws.amazon.com/kendra/latest/dg/API_SiteMapsConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_SiteMapsConfiguration.html)
**Anmerkung**
Wenn Sie eine Sitemap crawlen möchten, überprüfen Sie, ob die Basis- oder Stamm-URL mit der URL auf Ihrer URLs Sitemap-Seite übereinstimmt. Wenn Ihre Sitemap-URL beispielsweise lautet *https://example.com/sitemap-page.html*, sollte die auf dieser Sitemap-Seite URLs aufgeführte Seite auch die Basis-URL "https://example.com/" verwenden.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Wenn für eine Website eine Standardauthentifizierung erforderlich ist, geben Sie den Hostnamen, die Portnummer und ein Geheimnis an, in dem Ihre grundlegenden Authentifizierungsdaten mit Ihrem Benutzernamen und Passwort gespeichert werden. Sie geben den geheimen ARN mithilfe der [https://docs.aws.amazon.com/kendra/latest/dg/API_AuthenticationConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_AuthenticationConfiguration.html)API an. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"username": "user name",
"password": "password"
}
```
Sie können Webproxy-Anmeldeinformationen auch mithilfe eines AWS Secrets Manager Geheimnisses angeben. Sie verwenden die [https://docs.aws.amazon.com/kendra/latest/dg/API_ProxyConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_ProxyConfiguration.html)API, um den Hostnamen und die Portnummer der Website sowie optional das Geheimnis anzugeben, in dem Ihre Web-Proxy-Anmeldeinformationen gespeichert werden.
+ **IAM role** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Secret und für das Aufrufen der erforderlichen öffentlichen Daten APIs für den Webcrawler-Connector und zuzuweisen. Amazon Kendra Weitere Informationen finden Sie unter [IAM Rollen für Webcrawler-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Crawlmodus** — Wählen Sie aus, ob nur Hostnamen von Websites oder Hostnamen mit Subdomänen oder auch andere Domains gecrawlt werden sollen, auf die die Webseiten verweisen.
+ Die „Tiefe“ oder die Anzahl der Ebenen von der Seed-Ebene bis zum Crawl. Beispielsweise hat die Seed-URL-Seite Tiefe 1 und alle Hyperlinks auf dieser Seite, die ebenfalls gecrawlt werden, haben Tiefe 2.
+ Die maximale Anzahl von Personen URLs auf einer einzelnen Webseite, die gecrawlt werden sollen.
+ Die maximale Größe einer Webseite, die gecrawlt werden soll, in MB.
+ Die maximale Anzahl von URLs Crawlern pro Website-Host pro Minute.
+ Der Web-Proxy-Host und die Portnummer für die Verbindung zu internen Websites und das Crawlen. Der Hostname von *https://a.example.com/page1.html*ist beispielsweise "a.example.com" und die Portnummer ist 443, der Standardport für HTTPS. Wenn Web-Proxy-Anmeldeinformationen erforderlich sind, um eine Verbindung zu einem Website-Host herzustellen, können Sie einen erstellen AWS Secrets Manager , der die Anmeldeinformationen speichert.
+ Die Authentifizierungsinformationen für den Zugriff auf und das Crawlen von Websites, für die eine Benutzerauthentifizierung erforderlich ist.
+ Mit dem Tool *Custom Document Enrichment* können Sie HTML-Metatags als Felder extrahieren. Weitere Informationen finden Sie unter [Anpassen der Metadaten von Dokumenten während des Erfassungsprozesses](https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html). Ein Beispiel für das Extrahieren von HTML-Metatags finden Sie unter [CDE-Beispiele](https://github.com/aws-samples/amazon-kendra-cde-examples).
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob bestimmte Filter ein- oder ausgeschlossen werden sollen. URLs
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer web crawler Datenquelle finden Sie unter:
+ [Stellen Sie sich die Wissensfindung mit dem Web Amazon Kendra Crawler neu vor](https://aws.amazon.com/blogs/machine-learning/reimagine-knowledge-discovery-using-amazon-kendras-web-crawler/)
# Amazon Kendra Web Crawler-Konnektor v2.0
Sie können Amazon Kendra Web Crawler verwenden, um Webseiten zu crawlen und zu indizieren.
Sie können nur öffentlich zugängliche Websites oder interne Unternehmenswebsites crawlen, die das sichere Kommunikationsprotokoll Hypertext Transfer Protocol Secure (HTTPS) verwenden. Wenn Sie beim Crawling einer Website einen Fehler erhalten, kann es sein, dass die Website für das Crawling gesperrt ist. Um interne Websites zu crawlen, können Sie einen Webproxy einrichten. Der Webproxy muss öffentlich zugänglich sein. Sie können auch eine Authentifizierung verwenden, um auf Websites zuzugreifen und diese zu crawlen.
Amazon Kendra Web Crawler v2.0 verwendet das Selenium-Webcrawler-Paket und einen Chromium-Treiber. Amazon Kendra aktualisiert automatisch die Version von Selenium und den Chromium-Treiber mithilfe von Continuous Integration (CI).
*Bei der Auswahl der zu indizierenden Websites müssen Sie die [Amazon Acceptable Use Policy](https://aws.amazon.com/aup/) (Richtlinie zur zulässigen Nutzung) und alle anderen Amazon-Bedingungen einhalten. Denken Sie daran, dass Sie Amazon Kendra Web Crawler nur verwenden dürfen, um Ihre eigenen Webseiten oder Webseiten zu indizieren, für deren Indexierung Sie autorisiert sind. Informationen dazu, wie Sie verhindern können, dass Amazon Kendra Web Crawler Ihre Website (s) indexiert, finden Sie unter. [Konfiguration der `robots.txt` Datei für Amazon Kendra Web Crawler](stop-web-crawler.md)* . Der Missbrauch von Amazon Kendra Web Crawler zum aggressiven Crawlen von Websites oder Webseiten, die Ihnen nicht gehören, wird **nicht** als akzeptable Nutzung angesehen.
Informationen zur Problembehandlung Ihres Amazon Kendra Webcrawler-Datenquellen-Connectors finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Anmerkung**
Web Crawler Connector v2.0 unterstützt das Crawlen von Website-Listen aus verschlüsselten Buckets *nicht*. AWS KMS Amazon S3 Er unterstützt nur serverseitige Verschlüsselung mit verwalteten Schlüsseln. Amazon S3
**Wichtig**
Die Erstellung von Web Crawler v2.0-Connectoren wird von nicht unterstützt. CloudFormation Verwenden Sie den Web Crawler v1.0-Connector, wenn Sie Unterstützung benötigen. CloudFormation
**Topics**
+ [
## Unterstützte Features
](#supported-features-v2-web-crawler)
+ [
## Voraussetzungen
](#prerequisites-v2-web-crawler)
+ [
## Anweisungen zur Verbindung
](#data-source-v2-procedure-web-crawler)
## Unterstützte Features
+ Feldzuordnungen
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Webproxy
+ Basic-, NTLM/Kerberos-, SAML- und Formularauthentifizierung für Ihre Websites
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Websites Amazon Kendra indexieren können, sollten Sie die Details Ihrer Websites und Konten überprüfen. AWS
**Stellen Sie für Ihre Websites sicher, dass Sie über Folgendes verfügen:**
+ Sie haben den Startwert oder die Sitemap URLs der Websites kopiert, die Sie indexieren möchten. Sie können das URLs in einer Textdatei speichern und in einen Amazon S3 Bucket hochladen. Jede URL in der Textdatei muss in einer separaten Zeile formatiert sein. Wenn Sie Ihre Sitemaps in einem Amazon S3 Bucket speichern möchten, stellen Sie sicher, dass Sie das Sitemap-XML kopiert und in einer XML-Datei gespeichert haben. Sie können auch mehrere Sitemap-XML-Dateien in einer ZIP-Datei zusammenfassen.
**Anmerkung**
(On-Premise/Server) Amazon Kendra überprüft, ob die in AWS Secrets Manager der Datei enthaltenen Endpunktinformationen mit den Endpunktinformationen übereinstimmen, die in den Konfigurationsdetails Ihrer Datenquelle angegeben sind. Dies trägt zum Schutz vor dem [Problem des verwirrten Stellvertreters](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html) bei, bei dem es sich um ein Sicherheitsproblem handelt, bei dem ein Benutzer nicht berechtigt ist, eine Aktion auszuführen, sondern ihn Amazon Kendra als Proxy verwendet, um auf das konfigurierte Geheimnis zuzugreifen und die Aktion auszuführen. Wenn Sie Ihre Endpunktinformationen später ändern, müssen Sie ein neues Geheimnis erstellen, um diese Informationen zu synchronisieren.
+ **Für Websites, die eine grundlegende, NTLM- oder Kerberos-Authentifizierung erfordern:**
+ Haben Sie Ihre Anmeldeinformationen für die Website-Authentifizierung, die einen Benutzernamen und ein Passwort enthalten, zur Kenntnis genommen.
**Anmerkung**
Amazon Kendra Web Crawler v2.0 unterstützt das NTLM-Authentifizierungsprotokoll, das Passwort-Hashing beinhaltet, und das Kerberos-Authentifizierungsprotokoll, das Passwortverschlüsselung beinhaltet.
+ **Für Websites, die eine SAML- oder Anmeldeformularauthentifizierung erfordern:**
+ Notieren Sie sich Ihre Anmeldeinformationen für die Website-Authentifizierung, die einen Benutzernamen und ein Passwort enthalten.
+ Die XPaths (XML Path Language) des Benutzernamenfeldes (und der Benutzernamenschaltfläche bei Verwendung von SAML), das Passwortfeld und die Schaltfläche wurden kopiert und die URL der Anmeldeseite kopiert. Sie können die Elemente mithilfe XPaths der Entwicklertools Ihres Webbrowsers finden. XPaths folgen normalerweise diesem Format:`//tagname[@Attribute='Value']`.
**Anmerkung**
Amazon Kendra Web Crawler v2.0 verwendet einen Headless-Chrome-Browser und die Informationen aus dem Formular, um den Zugriff mit einer 2.0-geschützten URL zu authentifizieren und zu autorisieren. OAuth
+ **Optional**: Der Hostname und die Portnummer des Web-Proxyservers wurden kopiert, wenn Sie einen Webproxy verwenden möchten, um eine Verbindung zu internen Websites herzustellen, die Sie crawlen möchten. Der Web-Proxy muss öffentlich zugänglich sein. Amazon Kendra unterstützt die Verbindung zu Web-Proxyservern, die über eine Standardauthentifizierung verfügen, oder Sie können eine Verbindung ohne Authentifizierung herstellen.
+ **Optional:** Sie haben die Subnetz-ID der Virtual Private Cloud (VPC) kopiert, wenn Sie eine VPC verwenden möchten, um eine Verbindung zu internen Websites herzustellen, die Sie crawlen möchten. Weitere Informationen finden Sie unter [Konfiguration eines Amazon VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
+ Es wurde überprüft, ob jedes Webseitendokument, das Sie indizieren möchten, einzigartig ist und dass es sich um ein und dasselbe Dokument aus anderen Datenquellen handelt, die Sie für denselben Index verwenden möchten. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem AWS Konto sicher, dass Sie über Folgendes verfügen:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den Amazon-Ressourcennamen der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Für Websites, die eine Authentifizierung erfordern, oder wenn Sie einen Webproxy mit Authentifizierung verwenden, haben Sie Ihre Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre web crawler Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Amazon Kendra Um eine Verbindung mit Ihrer web crawler Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer web crawler Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben, Amazon Kendra finden Sie web crawler weitere Informationen unter[Voraussetzungen](#prerequisites-v2-web-crawler).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen web crawler**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon Kendra Konsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Webcrawler-Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Webcrawler-Connector** mit dem Tag „V2.0".
1. Geben Sie auf der Seite **„Datenquellendetails angeben**“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Quelle** **— Wählen Sie entweder **Quelle URLs, Quell-Sitemaps****, Quelldatei**, ** URLsQuell-Sitemaps-Datei** aus.** Wenn Sie eine Textdatei verwenden möchten, die eine Liste mit bis zu 100 Seeds enthält, geben Sie den Pfad zu dem Amazon S3 Bucket an URLs, in dem Ihre Datei gespeichert ist. Wenn Sie sich für die Verwendung einer XML-Sitemap-Datei entscheiden, geben Sie den Pfad zu dem Amazon S3 Bucket an, in dem Ihre Datei gespeichert ist. Sie können auch mehrere Sitemap-XML-Dateien in einer ZIP-Datei zusammenfassen. Andernfalls können Sie manuell bis zu 10 Startpunkte oder Startpunkte URLs und bis zu drei Sitemaps eingeben URLs.
**Anmerkung**
Wenn du eine Sitemap crawlen möchtest, überprüfe, ob die Basis- oder Stamm-URL mit der auf deiner Sitemap-Seite URLs angegebenen URL übereinstimmt. Wenn Ihre Sitemap-URL beispielsweise lautet *https://example.com/sitemap-page.html*, sollte die auf dieser Sitemap-Seite URLs aufgeführte Seite auch die Basis-URL "https://example.com/" verwenden.
Wenn für Ihre Websites eine Authentifizierung für den Zugriff auf die Websites erforderlich ist, können Sie zwischen Basic-, NTLM/Kerberos-, SAML- oder Formularauthentifizierung wählen. Wählen Sie andernfalls die Option „Keine Authentifizierung“.
**Anmerkung**
Wenn Sie Ihre Datenquelle später bearbeiten möchten, um Ihren Startwert URLs mit Authentifizierung in Sitemaps umzuwandeln, müssen Sie eine neue Datenquelle erstellen. Amazon Kendra konfiguriert die Datenquelle mithilfe der URLs Seed-Endpunktinformationen im Secrets Manager Secret für die Authentifizierung und kann daher die Datenquelle nicht neu konfigurieren, wenn zu Sitemaps gewechselt wird.
1. **AWS Secrets Manager geheim** — Wenn Ihre Websites dieselbe Authentifizierung für den Zugriff auf die Websites benötigen, wählen Sie ein vorhandenes Geheimnis oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Website-Anmeldeinformationen zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
Wenn Sie sich für **Basic** - oder **NTML/Kerberos-Authentifizierung** entschieden haben, geben Sie einen Namen für das Geheimnis sowie den Benutzernamen und das Passwort ein. Das NTLM-Authentifizierungsprotokoll beinhaltet das Passwort-Hashing und das Kerberos-Authentifizierungsprotokoll umfasst die Passwortverschlüsselung.
Wenn Sie sich für **SAML** oder **Formularauthentifizierung** entschieden haben, geben Sie einen Namen für das Geheimnis sowie den Benutzernamen und das Passwort ein. Verwenden Sie XPath ihn für das Benutzernamenfeld (und XPath für die Benutzernamenschaltfläche, wenn Sie SAML verwenden). Wird XPaths für das Passwortfeld und die Schaltfläche sowie für die URL der Anmeldeseite verwendet. Sie können die XPaths (XML Path Language) von Elementen mithilfe der Entwicklertools Ihres Webbrowsers finden. XPaths folgen normalerweise diesem Format:`//tagname[@Attribute='Value']`.
1. (Optional) **Webproxy** — Geben Sie den Hostnamen und die Portnummer des Proxyservers ein, den Sie für die Verbindung zu internen Websites verwenden möchten. Der Hostname von *https://a.example.com/page1.html*ist beispielsweise "a.example.com" und die Portnummer ist 443, der Standardport für HTTPS. Wenn Web-Proxy-Anmeldeinformationen erforderlich sind, um eine Verbindung zu einem Website-Host herzustellen, können Sie einen erstellen AWS Secrets Manager , der die Anmeldeinformationen speichert.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **IAM Rolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAM Rollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. **Synchronisierungsbereich** — Legen Sie Grenzwerte für das Crawlen von Webseiten fest, einschließlich ihrer Domains, Dateigrößen und Links, und filtern URLs Sie mithilfe von Regex-Mustern.
1. (Optional) **Domainbereich crawlen** — Wählen Sie aus, ob nur Website-Domains, Domains mit Subdomänen oder auch andere Domains gecrawlt werden sollen, auf die die Webseiten verweisen. Standardmäßig werden Amazon Kendra nur die Domains der Websites gecrawlt, die Sie crawlen möchten.
1. (Optional) **Zusätzliche Konfiguration** — Legen Sie die folgenden Einstellungen fest:
+ **Crawl-Tiefe** — Die 'Tiefe' oder die Anzahl der Ebenen von der Ausgangsebene bis zur Durchforstung. Beispielsweise hat die Seed-URL-Seite Tiefe 1 und alle Hyperlinks auf dieser Seite, die ebenfalls gecrawlt werden, haben Tiefe 2.
+ **Maximale Dateigröße — Die maximale Größe** einer Webseite oder eines Anhangs, die gecrawlt werden soll, in MB.
+ **Maximale Anzahl von Links pro Seite** — Die maximale Anzahl der Links URLs auf einer einzelnen Webseite, die gecrawlt werden sollen.
+ **Maximale Drosselung der Crawling-Geschwindigkeit** — Die maximale Anzahl von URLs Crawlern pro Website-Host pro Minute.
+ **Dateien** — Wählen Sie diese Option, um Dateien zu crawlen, auf die die Webseiten verweisen.
+ **Crawlen und indexieren URLs** — Fügen Sie Muster für reguläre Ausdrücke hinzu, um das Crawlen bestimmter URLs Hyperlinks und die Indexierung aller Hyperlinks auf diesen URL-Webseiten ein- oder auszuschließen.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. **Zeitplan für die Synchronisierungsausführung** — Wählen Sie unter **Häufigkeit** aus, wie oft Amazon Kendra die Synchronisierung mit Ihrer Datenquelle erfolgen soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den Amazon Kendra generierten Standardfeldern von Webseiten und Dateien aus, die Sie Ihrem Index zuordnen möchten.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen web crawler**
Sie müssen mithilfe der [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API einen JSON-Wert des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-web-crawler-schema) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `WEBCRAWLERV2` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **URLs**— Geben Sie den Startpunkt oder den Startpunkt URLs der Websites oder die Sitemap URLs der Websites an, die Sie crawlen möchten. Sie können den Pfad zu einem Amazon S3 Bucket angeben, in dem Ihre Seed-Liste gespeichert ist. URLs Jede URL in der Textdatei für Seed URLs muss in einer separaten Zeile formatiert werden. Sie können auch den Pfad zu einem Amazon S3 Bucket angeben, in dem Ihre Sitemap-XML-Dateien gespeichert sind. Sie können mehrere Sitemap-Dateien zu einer ZIP-Datei zusammenfassen und die ZIP-Datei in Ihrem Amazon S3 Bucket speichern.
**Anmerkung**
Wenn du eine Sitemap crawlen möchtest, überprüfe, ob die Basis- oder Stamm-URL mit der URL auf deiner Sitemap-Seite übereinstimmt. URLs Wenn Ihre Sitemap-URL beispielsweise lautet *https://example.com/sitemap-page.html*, sollte die auf dieser Sitemap-Seite URLs aufgeführte Seite auch die Basis-URL "https://example.com/" verwenden.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Authentifizierung** — Wenn Ihre Websites dieselbe Authentifizierung erfordern, geben Sie entweder`BasicAuth`, `NTLM_Kerberos``SAML`, oder `Form` Authentifizierung an. Wenn für Ihre Websites keine Authentifizierung erforderlich ist, geben Sie `NoAuthentication` dies an.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Wenn Ihre Websites eine Basic-, NTLM- oder Kerberos-Authentifizierung erfordern, geben Sie ein Geheimnis an, in dem Ihre Authentifizierungsdaten mit Ihrem Benutzernamen und Passwort gespeichert werden. Sie geben den Amazon-Ressourcennamen (ARN) eines AWS Secrets Manager Geheimnisses an. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"seedUrlsHash": "Hash representation of all seed URLs",
"userName": "user name",
"password": "password"
}
```
Wenn für Ihre Websites eine SAML-Authentifizierung erforderlich ist, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"seedUrlsHash": "Hash representation of all seed URLs",
"userName": "user name",
"password": "password",
"userNameFieldXpath": "XPath for user name field",
"userNameButtonXpath": "XPath for user name button",
"passwordFieldXpath": "XPath for password field",
"passwordButtonXpath": "XPath for password button",
"loginPageUrl": "Full URL for website login page"
}
```
Wenn für Ihre Websites eine Formularauthentifizierung erforderlich ist, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"seedUrlsHash": "Hash representation of all seed URLs",
"userName": "user name",
"password": "password",
"userNameFieldXpath": "XPath for user name field",
"passwordFieldXpath": "XPath for password field",
"passwordButtonXpath": "XPath for password button",
"loginPageUrl": "Full URL for website login page"
}
```
Sie können die XPaths (XML Path Language) von Elementen mithilfe der Entwicklertools Ihres Webbrowsers finden. XPaths folgen normalerweise diesem Format:`//tagname[@Attribute='Value']`.
Sie können Webproxy-Anmeldeinformationen auch mithilfe von und AWS Secrets Manager secret angeben.
+ **IAM Rolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis zu gewähren und die erforderliche Öffentlichkeit APIs für den Webcrawler-Connector und aufzurufen. Amazon Kendra Weitere Informationen finden Sie unter [IAM Rollen für Webcrawler-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Domainbereich** — Wählen Sie aus, ob nur Website-Domains mit Subdomänen oder auch andere Domains, auf die die Webseiten verweisen, gecrawlt werden sollen. Standardmäßig werden Amazon Kendra nur die Domains der Websites gecrawlt, die Sie crawlen möchten.
+ Die „Tiefe“ oder Anzahl der Ebenen von der Seed-Ebene bis zum Crawl. Beispielsweise hat die Seed-URL-Seite Tiefe 1 und alle Hyperlinks auf dieser Seite, die ebenfalls gecrawlt werden, haben Tiefe 2.
+ Die maximale Anzahl von Personen URLs auf einer einzelnen Webseite, die gecrawlt werden sollen.
+ Die maximale Größe einer Webseite oder Anlage, die gecrawlt werden soll, in MB.
+ Die maximale Anzahl von URLs Crawlern pro Website-Host pro Minute.
+ Der Web-Proxy-Host und die Portnummer für die Verbindung zu internen Websites und das Crawlen. Der Hostname von *https://a.example.com/page1.html*ist beispielsweise "a.example.com" und die Portnummer ist 443, der Standardport für HTTPS. Wenn Web-Proxy-Anmeldeinformationen erforderlich sind, um eine Verbindung zu einem Website-Host herzustellen, können Sie einen erstellen AWS Secrets Manager , der die Anmeldeinformationen speichert.
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob das Crawlen bestimmter Hyperlinks URLs und die Indexierung von Hyperlinks auf diesen URL-Webseiten ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Feldzuordnungen** — Wählen Sie diese Option, um die Felder von Webseiten und Webseitendateien Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [Amazon Kendra Web Crawler-Vorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-web-crawler).
------
# Konfiguration der `robots.txt` Datei für Amazon Kendra Web Crawler
Amazon Kendra ist ein intelligenter Suchdienst, mit dem AWS Kunden Dokumente ihrer Wahl indexieren und durchsuchen können. Um Dokumente im Internet zu indexieren, können Kunden den Amazon Kendra Web Crawler verwenden, der angibt, welche URL (s) indexiert werden sollen und welche Betriebsparameter angegeben werden sollen. Amazon Kendra Kunden müssen vor der Indexierung einer bestimmten Website eine Autorisierung einholen.
Amazon Kendra Web Crawler respektiert die Standardanweisungen von robots.txt wie `Allow` und. `Disallow` Sie können die `robots.txt` Datei Ihrer Website ändern, um zu steuern, wie Amazon Kendra Web Crawler Ihre Website crawlt.
## Konfigurieren Sie, wie Amazon Kendra Web Crawler auf Ihre Website zugreift
Sie können mithilfe von AND-Anweisungen steuern, wie der Amazon Kendra Web Crawler Ihre Website indexiert. `Allow` `Disallow` Sie können außerdem kontrollieren, welche Webseiten indexiert werden und welche Webseiten nicht gecrawlt werden.
**Verwenden Sie die Amazon Kendra folgende Direktive, damit der Web Crawler alle Webseiten mit Ausnahme unzulässiger Webseiten crawlen kann:**
```
User-agent: amazon-kendra # Amazon Kendra Web Crawler
Disallow: /credential-pages/ # disallow access to specific pages
```
**Verwenden Sie die folgende Direktive, damit Amazon Kendra Web Crawler nur bestimmte Webseiten crawlen kann:**
```
User-agent: amazon-kendra # Amazon Kendra Web Crawler
Allow: /pages/ # allow access to specific pages
```
**Verwenden Sie die folgende Anweisung, um Amazon Kendra Web Crawler das Crawlen aller Website-Inhalte zu ermöglichen und das Crawlen für andere Roboter zu verbieten:**
```
User-agent: amazon-kendra # Amazon Kendra Web Crawler
Allow: / # allow access to all pages
User-agent: * # any (other) robot
Disallow: / # disallow access to any pages
```
## Web Crawler daran hindern, Amazon Kendra Ihre Website zu crawlen
Mithilfe der Direktive können Sie verhindern, dass Amazon Kendra Web Crawler Ihre Website indexiert. `Disallow` Sie können auch steuern, welche Webseiten gecrawlt werden und welche nicht.
**Verwenden Sie die folgende Anweisung, um zu verhindern, dass Amazon Kendra Web Crawler die Website crawlt:**
```
User-agent: amazon-kendra # Amazon Kendra Web Crawler
Disallow: / # disallow access to any pages
```
[Wenn Sie Fragen oder Bedenken zu Amazon Kendra Web Crawler haben, können Sie sich an das AWS Support-Team wenden.](https://aws.amazon.com/contact-us/?nc1=f_m)
# Box (Kasten)
Box ist ein Cloud-Speicherdienst, der Funktionen zum Hosten von Dateien bietet. Sie können ihn verwendenAmazon Kendra, um Inhalte in Ihren Box-Inhalten zu indizieren, einschließlich Kommentare, Aufgaben und Weblinks.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die [BoxConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BoxConfiguration.html)API eine Verbindung zu Ihrer Box-Datenquelle herstellen.
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Box-Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-box)
+ [
## Voraussetzungen
](#prerequisites-box)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-box)
+ [
## Weitere Informationen
](#box-learn-more)
+ [
## Hinweise
](#box-notes)
## Unterstützte Features
Amazon KendraDer Box-Datenquellen-Connector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Änderungsprotokoll, vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Box-Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihrer Box und AWS Ihren Konten vor.
**Stellen Sie in Box sicher, dass Sie über Folgendes verfügen:**
+ Ein Box Enterprise- oder Box Enterprise Plus-Konto.
+ In der Box Developer Console wurde eine benutzerdefinierte Box-App mit serverseitiger Authentifizierung mithilfe von JSON Web Tokens (JWT) konfiguriert. Weitere Informationen finden Sie in der [Box-Dokumentation zur Erstellung einer benutzerdefinierten App](https://developer.box.com/guides/applications/app-types/platform-apps/) und in der [Box-Dokumentation zur Konfiguration von JWT Auth.](https://developer.box.com/guides/authentication/jwt/)
+ Sie haben Ihre **App-Zugriffsebene** auf **App- und Unternehmenszugriff** festgelegt und die Option **API-Aufrufe mithilfe des Headers „as-user“** zugelassen.
+ Hat den Admin-Benutzer verwendet, um die folgenden **Anwendungsbereiche** zu Ihrer Box-App hinzuzufügen:
+ Alle in einer Box gespeicherten Dateien und Ordner schreiben
+ Benutzer verwalten
+ Gruppen verwalten
+ Unternehmenseigenschaften verwalten
+ Konfiguriertes Public/Private key pair mit einer Client-ID, einem geheimen Clientschlüssel, einer öffentlichen Schlüssel-ID, einer privaten Schlüssel-ID, einer Passphrase und einer Unternehmens-ID, die als Ihre Authentifizierungsdaten verwendet werden sollen. Weitere Informationen finden Sie unter [Paar aus öffentlichem und privatem Schlüssel](https://developer.box.com/guides/authentication/jwt/jwt-setup/#public-and-private-key-pair).
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ Ihre Box Enterprise ID wurde entweder aus den Einstellungen der Box Developer Console oder aus Ihrer Box-App kopiert. Beispiel, *801234567*.
+ Aktiviert, dass jedes Dokument in Box und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Ihre Box-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Box-Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Box-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Box-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Wenn Sie Box für noch nicht konfiguriert habenAmazon Kendra, finden Sie weitere Informationen unter[Voraussetzungen](#prerequisites-box).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra zu Box herzustellen**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Box-Konnektor** und dann **Konnektor hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie **Box Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Box Enterprise ID** — Geben Sie Ihre Box Enterprise ID ein. Beispiel, *801234567*.
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Box-Authentifizierungsdaten zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Box' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Geben Sie für **Client-ID**, **Client Secret**, **Public Key-ID**, **Private Key-ID** und **Passphrase** die Werte aus dem Public/Private Schlüssel ein, den Sie in Box konfiguriert haben.
1. Fügen Sie Ihr Geheimnis hinzu und speichern Sie es.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. **Box-Dateien** — Wählen Sie aus, ob Weblinks, Kommentare und Aufgaben gecrawlt werden sollen.
1. Für **zusätzliche Konfigurationen** — Fügen Sie Muster für reguläre Ausdrücke hinzu, um bestimmte Inhalte ein- oder auszuschließen.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. **Zeitplan für In-Sync-Ausführung** für **Häufigkeit** — Wählen Sie aus, wie oft Ihre Datenquelleninhalte synchronisiert und Ihr Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Standard-Datenquellenfelder** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra zu Box herzustellen**
Mithilfe der [BoxConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BoxConfiguration.html)API müssen Sie Folgendes angeben:
**Box Enterprise ID** — Geben Sie Ihre Box Enterprise ID an. Sie finden die Unternehmens-ID in den Einstellungen der Box Developer Console oder bei der Konfiguration einer App in Box.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Box-Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"clientID": "client-id",
"clientSecret": "client-secret",
"publicKeyID": "public-key-id",
"privateKey": "private-key",
"passphrase": "pass-phrase"
}
```
+ **IAMrole** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis zu gewähren und die erforderliche Öffentlichkeit APIs für den Box-Connector und Amazon Kendra anzurufen. Weitere Informationen finden Sie unter [IAMRollen für Box-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie dies `VpcConfiguration` als Teil der Datenquellenkonfiguration an. Siehe [Konfiguration Amazon Kendra für die Verwendung einer VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
+ **Änderungsprotokoll** — Gibt an, ob der Change-Log-Mechanismus der Box-Datenquelle verwendet werden Amazon Kendra soll, um zu ermitteln, ob ein Dokument im Index aktualisiert werden muss.
**Anmerkung**
Verwenden Sie das Änderungsprotokoll, wenn Sie nicht alle Dokumente scannen Amazon Kendra möchten. Wenn Ihr Änderungsprotokoll umfangreich ist, nimmt das Scannen der Dokumente in der Box-Datenquelle möglicherweise Amazon Kendra weniger Zeit in Anspruch als das Verarbeiten des Änderungsprotokolls. Wenn Sie Ihre Box-Datenquelle zum ersten Mal mit Ihrem Index synchronisieren, werden alle Dokumente gescannt.
+ **Kommentare, Aufgaben, Weblinks** — Geben Sie an, ob diese Inhaltstypen gecrawlt werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Inklusionsfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Ein- und Ausschlussfilter** — Geben Sie an, ob bestimmte Box-Dateien und -Ordner ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Benutzerkontextfilterung und Zugriffskontrolle** — Amazon Kendra durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Box-Datenquellenfelder Ihren Amazon Kendra Indexfeldern zuzuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer Box-Datenquelle finden Sie unter:
+ [Erste Schritte mit dem Amazon Kendra Box Connector](https://aws.amazon.com/blogs/machine-learning/getting-started-with-the-amazon-kendra-box-connector/)
## Hinweise
+ Wenn Zugriffskontrolllisten (ACLs) aktiviert sind, ist die Option „Nur neue oder geänderte Inhalte synchronisieren“ aufgrund von Box-API-Einschränkungen nicht verfügbar. Wir empfehlen, stattdessen die Modi „Vollständige Synchronisierung“ oder „Neue, geänderte oder gelöschte Inhalte“ zu verwenden oder sie zu deaktivieren, ACLs falls Sie diesen Synchronisierungsmodus verwenden müssen.
# Zusammenfluss
Confluence ist ein kollaboratives Arbeitsmanagement-Tool, das für die gemeinsame Nutzung, Speicherung und Bearbeitung von Projekten, Softwareentwicklung und Produktmanagement entwickelt wurde. Amazon Kendra unterstützt sowohl Confluence Center als auch Confluence Cloud. Server/Data Sie können die folgenden Amazon Kendra Confluence-Entitäten zum Indizieren verwenden:
+ **Bereiche** — Auf oberster Ebene ausgewiesene Bereiche für die Organisation verwandter Inhalte. Jeder Bereich dient als Container, der mehrere Seiten, Blogs und Anhänge aufnehmen kann.
+ **Seiten** — Einzelne Dokumente innerhalb eines Bereichs, in dem Benutzer Inhalte erstellen und verwalten. Seiten können Text, Bilder, Tabellen und Multimediaelemente enthalten und können verschachtelte Unterseiten haben. Jede Seite wird als einzelnes Dokument betrachtet.
+ **Blogs** – Inhalte, die Seiten ähneln und in der Regel für Updates oder Ankündigungen verwendet werden. Jeder Blogbeitrag wird als einzelnes Dokument betrachtet.
+ **Kommentare** — Ermöglicht es Benutzern, Feedback zu geben oder sich an Diskussionen zu bestimmten Inhalten innerhalb von Seiten oder Blogbeiträgen zu beteiligen.
+ **Anhänge** — Dateien, die auf Seiten oder Blogbeiträge in Confluence hochgeladen wurden, wie Bilder, Dokumente oder andere Dateitypen.
Standardmäßig indexiert Confluence-Archive und persönliche Bereiche Amazon Kendra nicht. Sie können wählen, ob sie bei der Erstellung der Datenquelle indexiert werden sollen. Wenn Sie einen Bereich nicht Amazon Kendra indexieren möchten, markieren Sie ihn in Confluence als privat.
Du kannst dich entweder über Amazon Kendra die [Amazon Kendra Konsole](https://console.aws.amazon.com/kendra/), die API oder die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API mit deiner Confluence-Datenquelle verbinden. [ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html)
Amazon Kendra hat zwei Versionen des Confluence-Connectors. Die folgenden Funktionen werden unterstützt.
****Confluence-Konnektor V2.0//API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)****
+ Feldzuordnungen
+ Kontrolle des Benutzerzugriffs
+ Muster von Inklusionen/Ausschlüssen
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
****Confluence Connector V1.0/[ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html)API** (nicht mehr unterstützt)**
+ Feldzuordnungen
+ Kontrolle des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ (Nur Confluence Server) Virtuelle private Cloud (VPC)
**Anmerkung**
Confluence Connector V1.0/API endete 2023. ConfluenceConfiguration Wir empfehlen, zu Confluence Connector V2.0/ API zu migrieren oder diesen zu verwenden. TemplateConfiguration
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Confluence-Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## ACLs im Confluence Connector
](#data-source-confluence-acls)
+ [
# Confluence-Konnektor V2.0
](data-source-v2-confluence.md)
+ [
# Confluence-Konnektor V1.0
](data-source-v1-confluence.md)
## ACLs im Confluence Connector
Connectoren unterstützen das Crawlen von Zugriffskontrolllisten (ACLs) und die Identifizierung von Informationen, sofern zutreffend, anhand der Datenquelle. Wenn Sie Dokumente ohne diese Option indizieren ACLs, gelten alle Dokumente als öffentlich. Die Indizierung von Dokumenten mit ACLs gewährleistet die Datensicherheit.
Der Amazon Kendra Confluence-Connector scannt Bereiche, um Seiten und Blogbeiträge zusammen mit ihren Inhalten zu sammeln. ACLs Wenn für eine Seite oder einen Blog keine Einschränkung gilt, erbt der Connector die Berechtigungen von seinem Bereich. Wenn auf einer Seite eine bestimmte Benutzer- oder Gruppenbeschränkung angewendet wird, können nur diese Benutzer auf diese Seite zugreifen. Wenn die Seite verschachtelt ist, erbt die verschachtelte Seite die Berechtigungen der übergeordneten Seite, sofern keine Einschränkungen angewendet werden. Ein ähnliches Berechtigungsmodell gilt für Blogs. Confluence unterstützt jedoch keine verschachtelten Blogs.
Darüber hinaus crawlt Amazon Kendra Confluence Connector Benutzerprinzipalinformationen (lokaler Benutzeralias, lokale Gruppen- und Verbundgruppen-Identitätskonfigurationen) und deren Berechtigungen für jeden konfigurierten Bereich.
**Anmerkung**
Der Confluence Cloud Connector unterstützt das Crawlen von Makros, Whiteboards oder Datenbanken nicht.
Der Amazon Kendra Confluence-Connector aktualisiert die ACL-Änderungen jedes Mal, wenn er Ihre Datenquelleninhalte crawlt. Um sicherzustellen, dass die richtigen Benutzer Zugriff auf die richtigen Inhalte haben, sollten Sie Ihre Datenquelle regelmäßig erneut synchronisieren, um alle ACL-Aktualisierungen zu erfassen.
# Confluence-Konnektor V2.0
Confluence ist ein kollaboratives Arbeitsmanagement-Tool, das für die gemeinsame Nutzung, Speicherung und Bearbeitung von Projekten, Softwareentwicklung und Produktmanagement entwickelt wurde. Sie können Amazon Kendra es verwenden, um Ihre Confluence-Bereiche, Seiten (einschließlich verschachtelter Seiten), Blogs sowie Kommentare und Anhänge zu indexierten Seiten und Blogs zu indizieren.
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Confluence-Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-v2-confluence)
+ [
## Voraussetzungen
](#prerequisites-v2-confluence)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-v2-confluence)
## Unterstützte Features
Amazon Kendra Der Confluence-Datenquellen-Connector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Muster von Inklusionen/Ausschlüssen
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Confluence-Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihrem Confluence und Ihren Konten vor. AWS
**Stellen Sie in Confluence sicher, dass Sie:**
+ Die URL deiner Confluence-Instanz wurde kopiert. Zum Beispiel:*https://example.confluence.com*, oder*https://www.example.confluence.com/*, oder. *https:// atlassian.net/* Sie benötigen die URL Ihrer Confluence-Instanz, um eine Verbindung herzustellen. Amazon Kendra
Wenn du Confluence Cloud verwendest, muss deine Host-URL mit enden. *atlassian.net/*
**Anmerkung**
Die folgenden URL-Formate werden **nicht** unterstützt:
*https://example.confluence.com/xyz*
*https://www.example.confluence.com//wiki/spacekey/xxx*
*https://atlassian.net/xyz*
**Anmerkung**
(On-Premise/Server) Amazon Kendra überprüft, ob die in AWS Secrets Manager der Datei enthaltenen Endpunktinformationen mit den Endpunktinformationen übereinstimmen, die in den Konfigurationsdetails Ihrer Datenquelle angegeben sind. Dies trägt zum Schutz vor dem [Problem des verwirrten Stellvertreters](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html) bei, bei dem es sich um ein Sicherheitsproblem handelt, bei dem ein Benutzer nicht berechtigt ist, eine Aktion auszuführen, sondern ihn Amazon Kendra als Proxy verwendet, um auf das konfigurierte Geheimnis zuzugreifen und die Aktion auszuführen. Wenn Sie Ihre Endpunktinformationen später ändern, müssen Sie ein neues Geheimnis erstellen, um diese Informationen zu synchronisieren.
+ Konfigurierte Basisauthentifizierungsdaten, die einen Benutzernamen (E-Mail-ID, die für die Anmeldung bei Confluence verwendet wurde) und ein Passwort (Confluence-API-Token als Passwort) enthalten. Weitere Informationen findest du unter [API-Token für dein Atlassian-Konto verwalten](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/#Create-an-API-token).
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon ab**, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ **Optional:** Konfigurierte OAuth 2.0-Anmeldeinformationen, die einen Confluence-App-Schlüssel, ein Confluence-App-Secret, ein Confluence-Zugriffstoken und ein Confluence-Aktualisierungstoken enthalten, um eine Verbindung zu Ihrer Confluence-Instanz herzustellen. Amazon Kendra Wenn Ihr Zugriffstoken abläuft, können Sie entweder das Aktualisierungstoken verwenden, um Ihr Zugriffstoken und Ihr Aktualisierungstokenpaar neu zu generieren. Oder Sie können den Autorisierungsvorgang wiederholen. Weitere Informationen zu Zugriffstoken finden Sie unter [ OAuth Zugriffstoken verwalten](https://support.atlassian.com/confluence-cloud/docs/manage-oauth-access-tokens/).
+ (Nur für Confluence Server/Data Center) **Optional:** In Confluence wurde ein Personal Access Token (PAT) konfiguriert. Siehe Persönliche Zugriffstoken [verwenden](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html).
**Stellen Sie sicher AWS-Konto, dass Sie Folgendes in Ihrem haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Du hast deine Confluence-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls du die API verwendest, den ARN des Secrets notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon ab**, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn du noch keine IAM Rolle oder keinen Schlüssel hast, kannst du die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn du deine Confluence-Datenquelle mit verbindest. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Confluence-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Confluence-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie Confluence noch nicht konfiguriert haben, finden Sie weitere Informationen unter. Amazon Kendra [Voraussetzungen](#prerequisites-v2-confluence)
------
#### [ Console ]
**Um eine Verbindung zu Confluence herzustellen Amazon Kendra **
1. [Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon Kendra Konsole.](https://console.aws.amazon.com/kendra/)
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Confluence-Konnektor und dann Konnektor** **hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Confluence-Connector** mit dem Tag „V2.0".
1. Geben Sie auf der Seite **„Datenquellendetails angeben**“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. Wählen Sie unter **Quelle** entweder **Confluence Cloud oder ** Server/Data Confluence**** Center aus.
1. **Confluence-URL — Geben Sie die Confluence-Host-URL ein**. Beispiel, *https://example.confluence.com*.
1. (Nur für Confluence Server/Data Center) **Speicherort des SSL-Zertifikats — *optional* — Geben Sie den Amazon S3 Pfad zu Ihrer SSL-Zertifikatsdatei** für Confluence Server ein.
1. (Nur für Confluence Server/Data Center) **Web-Proxy — *optional* — Geben Sie den Web-Proxy-Hostnamen** (ohne das `http://` `https://` OR-Protokoll) und die Portnummer (Port, der vom Host-URL-Transportprotokoll verwendet wird) ein. Die Portnummer sollte ein numerischer Wert zwischen 0 und 65535 sein.
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **Authentifizierung** **— Wählen Sie entweder **Standardauthentifizierung**, **OAuth 2.0-Authentifizierung** oder (nur für Confluence Server/Data Center) Authentifizierung mit Personal Access Token.**
1. **AWS Secrets Manager geheim** — Wählen Sie ein vorhandenes Geheimnis oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Confluence-Authentifizierungsdaten zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet. Geben Sie die folgenden Informationen in das Fenster ein:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Confluence-' wird Ihrem geheimen Namen automatisch hinzugefügt.
1. Wenn Sie die **Standardauthentifizierung** verwenden — Geben Sie den geheimen Namen, den Benutzernamen und das Passwort (Confluence-API-Token als Passwort) ein, die Sie in Confluence konfiguriert haben.
Wenn Sie die **OAuth22.0-Authentifizierung** verwenden — Geben Sie den geheimen Namen, den App-Schlüssel, den geheimen App-Schlüssel, das Zugriffstoken und das Aktualisierungstoken ein, die Sie in Confluence konfiguriert haben.
(Nur Confluence Server/Data Center) Wenn Sie die **Authentifizierung mit einem Personal Access Token verwenden — Geben Sie den geheimen Namen und das Confluence-Token** ein, die Sie in Ihrem Confluence konfiguriert haben.
1. Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
1. **IAM Rolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAM Rollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Im **Bereich Synchronisieren** für **Inhalte synchronisieren** — Wählen Sie aus den folgenden Inhaltstypen aus, ob Sie synchronisieren möchten: Seiten, Seitenkommentare, Seitenanhänge, Blogs, Blogkommentare, Bloganhänge, persönliche Bereiche und archivierte Bereiche.
**Anmerkung**
**Seitenkommentare und Seitenanhänge können nur ausgewählt werden, wenn Sie Seiten synchronisieren möchten.** **Blogkommentare und Bloganhänge können nur ausgewählt werden, wenn Sie Blogs synchronisieren möchten.**
**Wichtig**
Wenn Sie unter **Zusätzliche Konfiguration** kein Regex-Muster mit Leertaste angeben, werden standardmäßig alle Seiten und Blogs gecrawlt.
1. Geben Sie unter **Zusätzliche Konfiguration** für **Maximale Dateigröße die Dateigrößenbeschränkung** an, die gecrawlt werden soll. MBs Amazon Kendra Amazon Kendra durchsucht nur die Dateien innerhalb der von Ihnen definierten Größenbeschränkung. Die Standarddateigröße beträgt 50 MB. Die maximale Dateigröße sollte größer als 0 MB und kleiner oder gleich 50 MB sein.
Für **Spaces-Regex-Muster** — Geben Sie wie folgt an, ob bestimmte Leerzeichen in Ihren Index aufgenommen oder ausgeschlossen werden sollen:
+ Leertaste (zum Beispiel) *my-space-123*
**Anmerkung**
Wenn Sie kein Regex-Muster für die Leertaste angeben, werden standardmäßig alle Seiten und Blogs gecrawlt.
+ URL (zum Beispiel) *.\$1/MySite/MyDocuments/*
+ Dateityp (zum Beispiel*.\$1\$1.pdf, .\$1\$1.txt*)
Für **Regex-Muster für Entitätstitel** — Geben Sie Muster für reguläre Ausdrücke an, um bestimmte Blogs, Seiten, Kommentare und Anlagen anhand von Titeln ein- oder auszuschließen.
**Anmerkung**
Wenn Sie das Crawlen einer bestimmten Seite oder Unterseite ein- oder ausschließen möchten, können Sie Regex-Muster für Seitentitel verwenden.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Frequenz** aus, wie oft der Inhalt Ihrer Datenquelle synchronisiert und der Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den Amazon Kendra generierten Standard-Datenquellenfeldern aus, die Sie Ihrem Index zuordnen möchten. Um benutzerdefinierte Datenquellenfelder hinzuzufügen, erstellen Sie einen Indexfeldnamen für die Zuordnung und den Felddatentyp.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra zu Confluence herzustellen**
Sie müssen mithilfe der API ein JSON des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-confluence-schema) angeben. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `CONFLUENCEV2` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Host-URL** — Geben Sie die Confluence-Host-URL-Instanz an. Beispiel, *https://example.confluence.com*.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Authentifizierungstyp** — Geben Sie den Authentifizierungstyp an, ob`Basic`,`OAuth2`, (nur Confluence Server). `Personal-token`
+ (Optional — Nur für Confluence Server) **Speicherort des SSL-Zertifikats — Geben Sie das Land an, das Sie zum Speichern Ihres SSL-Zertifikats verwendet** haben. `S3bucketName` `s3certificateName`
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die von Ihnen in Confluence konfigurierten Authentifizierungsdaten enthält. Wenn Sie die Standardauthentifizierung verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"username": "email ID or user name",
"password": "Confluence API token"
}
```
Wenn Sie die OAuth 2.0-Authentifizierung verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"confluenceAppKey": "app key",
"confluenceAppSecret": "app secret",
"confluenceAccessToken": "access token",
"confluenceRefreshToken": "refresh token"
}
```
(Nur für Confluence Server) Wenn Sie die Standardauthentifizierung verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"hostUrl": "Confluence Server host URL",
"username": "Confluence Server user name",
"password": "Confluence Server password"
}
```
(Nur für Confluence Server) Wenn Sie die Authentifizierung mit dem Personal Access Token verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"hostUrl": "Confluence Server host URL",
"patToken": "personal access token"
}
```
+ **IAM role** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager geheimes Geheimnis und für das Aufrufen der erforderlichen Öffentlichkeit APIs für den Confluence-Connector und zu erteilen. Amazon Kendra Weitere Informationen finden Sie unter [IAM Rollen für Confluence-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Dateigröße** — Geben Sie die maximale Dateigröße für das Crawlen an.
+ **Dokument-/Inhaltstypen** — Geben Sie an, ob Seiten, Seitenkommentare, Seitenanhänge, Blogs, Blogkommentare, Bloganhänge, Bereiche und archivierte Bereiche gecrawlt werden sollen.
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob bestimmte Bereiche, Seiten, Blogs sowie deren Kommentare und Anlagen ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Web-Proxy** — Geben Sie Ihre Web-Proxy-Informationen an, wenn Sie über einen Webproxy eine Verbindung zu Ihrer Confluence-URL-Instanz herstellen möchten. Sie können diese Option für Confluence Server verwenden.
+ **Zugriffskontrollliste (ACL)** — Geben Sie an, ob die ACL-Informationen für Ihre Dokumente gecrawlt werden sollen, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
+ **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
+ **Feldzuordnungen** — Wählen Sie, ob Sie Ihre Confluence-Datenquellenfelder Ihren Indexfeldern zuordnen möchten. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen zu können. Amazon Kendra Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [Confluence-Template-Schema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-confluence-schema).
------
### Hinweise
+ Personal Access Token (PAT) ist für Confluence Cloud nicht verfügbar.
# Confluence-Konnektor V1.0
Confluence ist ein kollaboratives Arbeitsmanagement-Tool, das für die gemeinsame Nutzung, Speicherung und Bearbeitung von Projekten, Softwareentwicklung und Produktmanagement entwickelt wurde. Sie können Amazon Kendra es verwenden, um Ihre Confluence-Bereiche, Seiten (einschließlich verschachtelter Seiten), Blogs sowie Kommentare und Anhänge zu indexierten Seiten und Blogs zu indizieren.
**Anmerkung**
Confluence Connector V1.0/API endete 2023. ConfluenceConfiguration Wir empfehlen, zu Confluence Connector V2.0/ API zu migrieren oder diesen zu verwenden. TemplateConfiguration
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Confluence-Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-v1-confluence)
+ [
## Voraussetzungen
](#prerequisites-v1-confluence)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-v1-confluence)
+ [
## Weitere Informationen
](#confluence-v1-learn-more)
## Unterstützte Features
Amazon Kendra Der Confluence-Datenquellen-Connector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ (Nur für Confluence Server) Virtuelle private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Confluence-Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihrem Confluence und Ihren Konten vor. AWS
**Stellen Sie in Confluence sicher, dass Sie über Folgendes verfügen:**
+ Du hast mir die Amazon Kendra Erlaubnis erteilt, alle Inhalte in deiner Confluence-Instanz anzusehen, indem du:
+ Mitglied Amazon Kendra einer Gruppe werden. `confluence-administrators`
+ Gewährung von Site-Admin-Rechten für alle vorhandenen Bereiche, Blogs und Seiten.
+ Die URL deiner Confluence-Instanz wurde kopiert.
+ **Für SSO-Benutzer (Single Sign-On):** Bei der Konfiguration der **Confluence-Authentifizierungsmethoden** in Confluence Data Center wurde die Option **Auf der Anmeldeseite anzeigen** für den Benutzernamen und das Passwort aktiviert.
+ **Für Confluence Server**
+ Haben Sie Ihre grundlegenden Authentifizierungsdaten notiert, die den Benutzernamen und das Passwort Ihres Confluence-Administratorkontos enthalten, mit dem Sie sich verbinden möchten. Amazon Kendra
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon ab**, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (falls zutreffend) wiederzuverwenden.
+ **Optional: Es** wurde ein persönliches Zugriffstoken in Ihrem Confluence-Konto generiert, mit dem Sie sich verbinden können. Amazon Kendra Weitere Informationen finden Sie in der [Confluence-Dokumentation zur Generierung persönlicher Zugriffstoken](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html).
+ **Für Confluence Cloud**
+ Haben Sie Ihre grundlegenden Authentifizierungsdaten notiert, die den Benutzernamen und das Passwort Ihres Confluence-Administratorkontos für die Verbindung enthalten. Amazon Kendra
+ Aktiviert, dass jedes Dokument in Confluence und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicher AWS-Konto, dass Sie:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Du hast deine Confluence-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls du die API verwendest, den ARN des Secrets notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon ab**, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn du noch keine IAM Rolle oder keinen Schlüssel hast, kannst du die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn du deine Confluence-Datenquelle mit verbindest. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Confluence-Datenquelle herzustellen, müssen Sie Details zu Ihren Confluence-Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie Confluence noch nicht konfiguriert haben, finden Sie weitere Informationen unter. Amazon Kendra [Voraussetzungen](#prerequisites-v1-confluence)
------
#### [ Console ]
**Um eine Verbindung zu Confluence herzustellen Amazon Kendra **
1. [Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon Kendra Konsole.](https://console.aws.amazon.com/kendra/)
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Confluence Connector V1.0** und dann Datenquelle **hinzufügen** aus.
1. Geben Sie auf der Seite **„Datenquellendetails angeben**“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. Wählen Sie zwischen **Confluence Cloud** und **Confluence** Server.
1. Wenn Sie sich für **Confluence Cloud** entscheiden, geben Sie die folgenden Informationen ein:
1. **Confluence-URL — Ihre Confluence-URL**.
1. **AWS Secrets Manager geheim** — Wählen Sie ein vorhandenes Geheimnis oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Confluence-Authentifizierungsdaten zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Confluence-' wird Ihrem geheimen Namen automatisch hinzugefügt.
1. Für **Benutzername** und **Passwort** — Geben Sie Ihren Confluence-Benutzernamen und Ihr Passwort ein.
1. **Wählen Sie Authentifizierung speichern.**
1. Wenn Sie **Confluence Server** wählen, geben Sie die folgenden Informationen ein:
1. **Confluence-URL** — Ihr Confluence-Benutzername und Ihr Passwort.
1. (Optional) Geben Sie für den **Web-Proxy** die folgenden Informationen ein:
1. **Hostname** — Hostname für Ihr Confluence-Konto.
1. **Portnummer — Port**, der vom Host-URL-Transportprotokoll verwendet wird.
1. Wählen Sie für **Authentifizierung** entweder **Standardauthentifizierung** oder **Personal** Access Token (nur Confluence Server).
1. **AWS Secrets Manager geheim** — Wählen Sie ein vorhandenes Geheimnis oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Confluence-Authentifizierungsdaten zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Confluence-' wird Ihrem geheimen Namen automatisch hinzugefügt.
1. Für **Benutzername** und **Passwort** — Geben Sie die Werte für die Authentifizierungsdaten ein, die Sie in Confluence konfiguriert haben. Wenn Sie die Standardauthentifizierung verwenden, verwenden Sie Ihren Confluence-Benutzernamen (E-Mail-ID) und Ihr Passwort (API-Token). Wenn Sie ein persönliches Zugriffstoken verwenden, geben Sie die Details des **persönlichen Zugriffstokens** ein, das Sie im Confluence-Konto konfiguriert haben.
1. Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.
1. **IAM Rolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAM Rollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Für **Persönliche Bereiche einbeziehen** und **Archivierte Bereiche einbeziehen** — Wählen Sie die optionalen Bereichstypen aus, die in diese Datenquelle aufgenommen werden sollen.
1. Für **zusätzliche Konfigurationen** — Geben Sie Muster für reguläre Ausdrücke an, um bestimmte Inhalte ein- oder auszuschließen. Sie können bis zu 100 Muster hinzufügen.
1. Sie können auch festlegen, dass **Anlagen innerhalb bestimmter Bereiche gecrawlt** werden.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Häufigkeit** aus, wie oft mit Ihrer Datenquelle synchronisiert Amazon Kendra werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Für **Space**, **Page**, **Blog** — Wählen Sie aus den Amazon Kendra generierten Standard-Datenquellenfeldern oder **Zusätzliche vorgeschlagene Feldzuordnungen**, um Indexfelder hinzuzufügen.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra zu Confluence herzustellen**
Sie müssen mithilfe [ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html)der API Folgendes angeben:
+ **Confluence-Version** — Geben Sie die Version der Confluence-Instanz an, die Sie als oder verwenden. `CLOUD` `SERVER`
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Secrets ein, das Ihre Confluence-Authentifizierungsdaten enthält.
Wenn Sie Confluence Server verwenden, können Sie entweder Ihren Confluence-Benutzernamen und Ihr Passwort oder Ihr persönliches Zugriffstoken als Authentifizierungsdaten verwenden.
Wenn Sie Ihren Confluence-Benutzernamen und Ihr Passwort als Authentifizierungsdaten verwenden, speichern Sie die folgenden Anmeldeinformationen als JSON-Struktur in Ihrem Secret: Secrets Manager
```
{
"username": "user name",
"password": "password"
}
```
Wenn Sie ein persönliches Zugriffstoken verwenden, um eine Verbindung zu Confluence Server herzustellen Amazon Kendra, speichern Sie die folgenden Anmeldeinformationen als JSON-Struktur in Ihrem Secret: Secrets Manager
```
{
"patToken": "personal access token"
}
```
Wenn Sie Confluence Cloud verwenden, verwenden Sie Ihren Confluence-Benutzernamen und ein in Confluence konfiguriertes API-Token als Passwort. Sie speichern die folgenden Anmeldeinformationen als JSON-Struktur in Ihrem Secret: Secrets Manager
```
{
"username": "user name",
"password": "API token"
}
```
+ **IAM role** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis zu gewähren und die erforderliche Öffentlichkeit APIs für den Confluence-Connector aufzurufen und. Amazon Kendra Weitere Informationen finden Sie unter [IAM Rollen für Confluence-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Web-Proxy** — Gibt an, ob Sie über einen Web-Proxy eine Verbindung zu Ihrer Confluence-URL-Instanz herstellen möchten. Sie können diese Option für Confluence Server verwenden.
+ (Nur für Confluence Server) **Virtual Private Cloud (VPC)** — Geben Sie dies `VpcConfiguration` als Teil der Datenquellenkonfiguration an. Siehe [Konfiguration Amazon Kendra für die Verwendung einer VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
+ **Inklusions- und Ausschlussfilter** — Geben Sie Muster für reguläre Ausdrücke an, um bestimmte Bereiche, Blogbeiträge, Seiten, Bereiche und Anlagen ein- oder auszuschließen. Wenn Sie Anlagen indexieren möchten, werden nur Anlagen zu den indizierten Seiten und Blogs indexiert.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Inklusionsfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Confluence-Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen zu können. Amazon Kendra Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
+ **Benutzerkontextfilterung und Zugriffskontrolle**Amazon Kendra — durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer Confluence-Datenquelle finden Sie unter:
+ [Konfiguration Ihres Amazon Kendra Confluence Server-Connectors](https://aws.amazon.com/blogs/machine-learning/configuring-your-amazon-kendra-confluence-server-connector/)
# Benutzerdefinierter Datenquellen-Connector
Verwenden Sie eine benutzerdefinierte Datenquelle, wenn Sie über ein Repository verfügen, für das noch Amazon Kendra kein Datenquellen-Connector zur Verfügung steht. Sie können damit dieselben Metriken zum Ausführungsverlauf anzeigen, die Amazon Kendra Datenquellen bereitstellen, auch wenn Sie die Datenquellen nicht zum Synchronisieren Ihrer Amazon Kendra Repositorys verwenden können. Verwenden Sie dies, um eine konsistente Synchronisierungsüberwachung zwischen Amazon Kendra Datenquellen und benutzerdefinierten Datenquellen zu gewährleisten. Verwenden Sie insbesondere eine benutzerdefinierte Datenquelle, um Synchronisierungsmetriken für einen Datenquellenconnector anzuzeigen, den Sie mit [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)und erstellt haben [BatchDeleteDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchDeleteDocument.html) APIs.
Informationen zur Fehlerbehebung bei Ihrem benutzerdefinierten Amazon Kendra-Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
Wenn Sie eine benutzerdefinierte Datenquelle erstellen, haben Sie die vollständige Kontrolle darüber, wie die zu indizierenden Dokumente ausgewählt werden. Amazon Kendra stellt nur Metrikinformationen bereit, die Sie zur Überwachung Ihrer Datenquellen-Synchronisierungsaufträge verwenden können. Sie müssen den Crawler erstellen und ausführen, der bestimmt, welche Dokumente Ihre Datenquelle indexiert.
Sie müssen den Haupttitel Ihrer Dokumente mithilfe des [Document-Objekts](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Document.html) angeben, um das Ergebnis zu erhalten `DocumentTitle` und `DocumentURI` in die Antwort aufzunehmen. `_source_uri` [DocumentAttribute](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DocumentAttribute.html)`Query`
Sie erstellen einen Bezeichner für Ihre benutzerdefinierte Datenquelle mithilfe der Konsole oder mithilfe der [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html)API. Um die Konsole zu verwenden, geben Sie Ihrer Datenquelle einen Namen und optional eine Beschreibung und Ressourcen-Tags. Nachdem die Datenquelle erstellt wurde, wird eine Datenquellen-ID angezeigt. Kopieren Sie diese ID, um sie zu verwenden, wenn Sie die Datenquelle mit dem Index synchronisieren.
![\[Form for specifying data source details, including name, description, and optional tags.\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/images/CustomDataSource.png)
Sie können mithilfe der `CreateDataSource` API auch eine benutzerdefinierte Datenquelle erstellen. Die API gibt eine ID zurück, die Sie verwenden können, wenn Sie die Datenquelle synchronisieren. Wenn Sie die `CreateDataSource` API verwenden, um eine benutzerdefinierte Datenquelle zu erstellen, können Sie die `Configuration` `Schedule` Parameter `RoleArn` oder nicht festlegen. Wenn Sie diese Parameter festlegen, wird eine `ValidationException` Ausnahme Amazon Kendra zurückgegeben.
Um eine benutzerdefinierte Datenquelle zu verwenden, erstellen Sie eine Anwendung, die für die Aktualisierung des Amazon Kendra Index verantwortlich ist. Die Anwendung hängt von einem Crawler ab, den Sie erstellen. Der Crawler liest die Dokumente in Ihrem Repository und bestimmt, an welche Dokumente gesendet werden sollen. Amazon Kendra Ihre Anwendung sollte die folgenden Schritte ausführen:
1. Durchforsten Sie Ihr Repository und erstellen Sie eine Liste der Dokumente in Ihrem Repository, die hinzugefügt, aktualisiert oder gelöscht wurden.
1. Rufen Sie die [StartDataSourceSyncJob](https://docs.aws.amazon.com/kendra/latest/APIReference/API_StartDataSourceSyncJob.html)API auf, um zu signalisieren, dass ein Synchronisierungsjob gestartet wird. Sie geben eine Datenquellen-ID an, um die Datenquelle zu identifizieren, die synchronisiert wird. Amazon Kendra gibt eine Ausführungs-ID zurück, um einen bestimmten Synchronisierungsjob zu identifizieren.
1. Rufen Sie die [BatchDeleteDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchDeleteDocument.html)API auf, um Dokumente aus dem Index zu entfernen. Sie geben die Datenquellen-ID und die Ausführungs-ID an, um die Datenquelle zu identifizieren, die synchronisiert wird, und den Job, dem dieses Update zugeordnet ist.
1. Rufen Sie die [StopDataSourceSyncJob](https://docs.aws.amazon.com/kendra/latest/APIReference/API_StopDataSourceSyncJob.html)API auf, um das Ende des Synchronisierungsauftrags zu signalisieren. Nachdem Sie die `StopDataSourceSyncJob` API aufgerufen haben, ist die zugehörige Ausführungs-ID nicht mehr gültig.
1. Rufen Sie die [ListDataSourceSyncJobs](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ListDataSourceSyncJobs.html)API mit den Index- und Datenquellen-IDs auf, um die Synchronisierungsjobs für die Datenquelle aufzulisten und die Metriken für die Synchronisierungsjobs anzuzeigen.
Nachdem Sie einen Synchronisierungsjob beendet haben, können Sie einen neuen Synchronisierungsjob starten. Es kann eine gewisse Zeit dauern, bis alle eingereichten Dokumente dem Index hinzugefügt werden. Verwenden Sie die `ListDataSourceSyncJobs` API, um den Status des Synchronisierungsauftrags zu sehen. Wenn der für den Synchronisierungsjob `Status` zurückgegebene Wert lautet`SYNCING_INDEXING`, werden einige Dokumente noch indexiert. Sie können einen neuen Synchronisierungsauftrag starten, wenn der Status des vorherigen Jobs `FAILED` oder `SUCCEEDED` lautet.
Nachdem Sie die `StopDataSourceSyncJob` API aufgerufen haben, können Sie in einem Aufruf von `BatchPutDocument` oder keine Synchronisierungsauftrags-ID verwenden `BatchDeleteDocument` APIs. Wenn Sie dies tun, werden alle eingereichten Dokumente in der `FailedDocuments` Antwortnachricht der API zurückgegeben.
## Erforderliche Attribute
Wenn Sie ein Dokument Amazon Kendra über die `BatchPutDocument` API einreichen, benötigt jedes Dokument zwei Attribute, um die Datenquelle und den Synchronisierungslauf zu identifizieren, zu dem es gehört. Sie müssen die folgenden beiden Attribute angeben, um Dokumente aus Ihrer benutzerdefinierten Datenquelle korrekt einem Amazon Kendra Index zuzuordnen:
+ `_data_source_id`— Der Bezeichner der Datenquelle. Dieser Wert wird zurückgegeben, wenn Sie die Datenquelle mit der Konsole oder der `CreateDataSource` API erstellen.
+ `_data_source_sync_job_execution_id`— Der Bezeichner des Synchronisierungslaufs. Dies wird zurückgegeben, wenn Sie die Indexsynchronisierung mit der `StartDataSourceSyncJob` API starten.
Im Folgenden finden Sie die JSON-Daten, die für die Indexierung eines Dokuments mithilfe einer benutzerdefinierten Datenquelle erforderlich sind.
```
{
"Documents": [
{
"Attributes": [
{
"Key": "_data_source_id",
"Value": {
"StringValue": "data source identifier"
}
},
{
"Key": "_data_source_sync_job_execution_id",
"Value": {
"StringValue": "sync job identifier"
}
}
],
"Blob": "document content",
"ContentType": "content type",
"Id": "document identifier",
"Title": "document title"
}
],
"IndexId": "index identifier",
"RoleArn": "IAM role ARN"
}
```
Wenn Sie ein Dokument mithilfe der `BatchDeleteDocument` API aus dem Index entfernen, müssen Sie die folgenden beiden Felder im `DataSourceSyncJobMetricTarget` Parameter angeben:
+ `DataSourceId`— Der Bezeichner der Datenquelle. Dieser Wert wird zurückgegeben, wenn Sie die Datenquelle mit der Konsole oder der `CreateDataSource` API erstellen.
+ `DataSourceSyncJobId`— Der Bezeichner des Synchronisierungslaufs. Dies wird zurückgegeben, wenn Sie die Indexsynchronisierung mit der `StartDataSourceSyncJob` API starten.
Das Folgende ist das JSON, das erforderlich ist, um ein Dokument mithilfe der `BatchDeleteDocument` API aus dem Index zu löschen.
```
{
"DataSourceSyncJobMetricTarget": {
"DataSourceId": "data source identifier",
"DataSourceSyncJobId": "sync job identifier"
},
"DocumentIdList": [
"document identifier"
],
"IndexId": "index identifier"
}
```
## Anzeigen von -Metriken
Nach Abschluss eines Synchronisierungsauftrags können Sie die [DataSourceSyncJobMetrics](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DataSourceSyncJobMetrics.html)API verwenden, um die mit dem Synchronisierungsjob verknüpften Metriken abzurufen. Verwenden Sie dies, um Ihre benutzerdefinierten Datenquellensynchronisierungen zu überwachen.
Wenn Sie dasselbe Dokument mehrmals einreichen, entweder als Teil der `BatchPutDocument` API, der API oder wenn das `BatchDeleteDocument` Dokument sowohl zum Hinzufügen als auch zum Löschen eingereicht wird, wird das Dokument in den Kennzahlen nur einmal gezählt.
+ `DocumentsAdded`— Die Anzahl der Dokumente, die über die `BatchPutDocument` API eingereicht wurden, die mit diesem Synchronisierungsjob verknüpft ist, wurde dem Index zum ersten Mal hinzugefügt. Wenn ein Dokument mehr als einmal synchron zur Hinzufügung eingereicht wird, wird das Dokument in den Kennzahlen nur einmal gezählt.
+ `DocumentsDeleted`— Die Anzahl der Dokumente, die über die `BatchDeleteDocument` API eingereicht wurden, die mit diesem Synchronisierungsauftrag verknüpft ist, wurde aus dem Index gelöscht. Wenn ein Dokument bei einer Synchronisation mehr als einmal zum Löschen eingereicht wird, wird das Dokument in den Kennzahlen nur einmal gezählt.
+ `DocumentsFailed`— Die Anzahl der Dokumente, die mit diesem Synchronisierungsauftrag verknüpft sind und bei dem die Indizierung fehlgeschlagen ist. Dies sind Dokumente, die von Amazon Kendra zur Indizierung akzeptiert wurden, aber nicht indexiert oder gelöscht werden konnten. Wenn ein Dokument von nicht akzeptiert wird Amazon Kendra, wird der Bezeichner für das Dokument in der `FailedDocuments` Antworteigenschaft von and zurückgegeben. `BatchPutDocument` `BatchDeleteDocument` APIs
+ `DocumentsModified`— Die Anzahl der geänderten Dokumente, die über die diesem Synchronisierungsauftrag zugeordnete `BatchPutDocument` API übermittelt wurden und die im Amazon Kendra Index geändert wurden.
Amazon Kendra gibt bei der Indizierung von Dokumenten auch Amazon CloudWatch Metriken aus. Weitere Informationen finden Sie unter [Überwachung Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/cloudwatch-metrics.html) mit. Amazon CloudWatch
Amazon Kendra gibt die `DocumentsScanned` Metrik für benutzerdefinierte Datenquellen nicht zurück. Es gibt auch die im Dokument CloudWatch Metriken [für Amazon Kendra Datenquellen aufgeführten Metriken](https://docs.aws.amazon.com/kendra/latest/dg/cloudwatch-metrics.html#cloudwatch-metrics-data-source) aus.
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer benutzerdefinierten Datenquelle finden Sie unter:
+ [Hinzufügen von benutzerdefinierten Datenquellen zu Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/adding-custom-data-sources-to-amazon-kendra/)
# Benutzerdefinierte Datenquelle (Java)
Der folgende Code enthält eine Beispielimplementierung einer benutzerdefinierten Datenquelle mit Java. Das Programm erstellt zunächst eine benutzerdefinierte Datenquelle und synchronisiert dann neu hinzugefügte Dokumente mit der benutzerdefinierten Datenquelle zum Index.
Der folgende Code veranschaulicht das Erstellen und Verwenden einer benutzerdefinierten Datenquelle. Wenn Sie in Ihrer Anwendung eine benutzerdefinierte Datenquelle verwenden, müssen Sie nicht jedes Mal, wenn Sie Ihren Index mit Ihrer Datenquelle synchronisieren, eine neue Datenquelle erstellen (einmaliger Vorgang). Sie verwenden die Index-ID und die Datenquellen-ID, um Ihre Daten zu synchronisieren.
```
package com.amazonaws.kendra;
import java.util.concurrent.TimeUnit;
import software.amazon.awssdk.services.kendra.KendraClient;
import csoftware.amazon.awssdk.services.kendra.model.BatchPutDocumentRequest;
import csoftware.amazon.awssdk.services.kendra.model.BatchPutDocumentResponse;
import software.amazon.awssdk.services.kendra.model.CreateDataSourceRequest;
import software.amazon.awssdk.services.kendra.model.CreateDataSourceResponse;
import software.amazon.awssdk.services.kendra.model.DataSourceType;
import software.amazon.awssdk.services.kendra.model.Document;
import software.amazon.awssdk.services.kendra.model.ListDataSourceSyncJobsRequest;
import software.amazon.awssdk.services.kendra.model.ListDataSourceSyncJobsResponse;
import software.amazon.awssdk.services.kendra.model.StartDataSourceSyncJobRequest;
import software.amazon.awssdk.services.kendra.model.StartDataSourceSyncJobResponse;
import software.amazon.awssdk.services.kendra.model.StopDataSourceSyncJobRequest;
import software.amazon.awssdk.services.kendra.model.StopDataSourceSyncJobResponse;
public class SampleSyncForCustomDataSource {
public static void main(String[] args) {
KendraClient kendra = KendraClient.builder().build();
String myIndexId = "yourIndexId";
String dataSourceName = "custom data source";
String dataSourceDescription = "Amazon Kendra custom data source connector"
// Create custom data source
CreateDataSourceRequest createDataSourceRequest = CreateDataSourceRequest
.builder()
.indexId(myIndexId)
.name(dataSourceName)
.description(dataSourceDescription)
.type(DataSourceType.CUSTOM)
.build();
CreateDataSourceResponse createDataSourceResponse = kendra.createDataSource(createDataSourceRequest);
System.out.println(String.format("Response of creating data source: %s", createDataSourceResponse));
// Get the data source ID from createDataSourceResponse
String dataSourceId = createDataSourceResponse.Id();
// Wait for the custom data source to become active
System.out.println(String.format("Waiting for Amazon Kendra to create the data source %s", dataSourceId));
// You can use the DescribeDataSource API to check the status
DescribeDataSourceRequest describeDataSourceRequest = DescribeDataSourceRequest
.builder()
.indexId(myIndexId)
.id(dataSourceId)
.build();
while (true) {
DescribeDataSourceResponse describeDataSourceResponse = kendra.describeDataSource(describeDataSourceRequest);
DataSourceStatus status = describeDataSourceResponse.status();
System.out.println(String.format("Creating data source. Status: %s", status));
if (status != DataSourceStatus.CREATING) {
break;
}
TimeUnit.SECONDS.sleep(60);
}
// Start syncing yor data source by calling StartDataSourceSyncJob and providing your index ID
// and your custom data source ID
System.out.println(String.format("Synchronize the data source %s", dataSourceId));
StartDataSourceSyncJobRequest startDataSourceSyncJobRequest = StartDataSourceSyncJobRequest
.builder()
.indexId(myIndexId)
.id(dataSourceId)
.build();
StartDataSourceSyncJobResponse startDataSourceSyncJobResponse = kendra.startDataSourceSyncJob(startDataSourceSyncJobRequest);
// Get the sync job execution ID from startDataSourceSyncJobResponse
String executionId = startDataSourceSyncJobResponse.ExecutionId();
System.out.println(String.format("Waiting for the data source to sync with the index %s for execution ID %s", indexId, startDataSourceSyncJobResponse.executionId()));
// Add 2 documents uploaded to S3 bucket to your index using the BatchPutDocument API
// The added documents should sync with your custom data source
Document pollyDoc = Document
.builder()
.s3Path(
S3Path.builder()
.bucket("amzn-s3-demo-bucket")
.key("what_is_Amazon_Polly.docx")
.build())
.title("What is Amazon Polly?")
.id("polly_doc_1")
.build();
Document rekognitionDoc = Document
.builder()
.s3Path(
S3Path.builder()
.bucket("amzn-s3-demo-bucket")
.key("what_is_amazon_rekognition.docx")
.build())
.title("What is Amazon rekognition?")
.id("rekognition_doc_1")
.build();
BatchPutDocumentRequest batchPutDocumentRequest = BatchPutDocumentRequest
.builder()
.indexId(myIndexId)
.documents(pollyDoc, rekognitionDoc)
.build();
BatchPutDocumentResponse result = kendra.batchPutDocument(batchPutDocumentRequest);
System.out.println(String.format("BatchPutDocument result: %s", result));
// Once custom data source synced, stop the sync job using the StopDataSourceSyncJob API
StopDataSourceSyncJobResponse stopDataSourceSyncJobResponse = kendra.stopDataSourceSyncJob(
StopDataSourceSyncJobRequest()
.indexId(myIndexId)
.id(dataSourceId)
);
// List your sync jobs
ListDataSourceSyncJobsRequest listDataSourceSyncJobsRequest = ListDataSourceSyncJobsRequest
.builder()
.indexId(myIndexId)
.id(dataSourceId)
.build();
while (true) {
ListDataSourceSyncJobsResponse listDataSourceSyncJobsResponse = kendra.listDataSourceSyncJobs(listDataSourceSyncJobsRequest);
DataSourceSyncJob job = listDataSourceSyncJobsResponse.history().get(0);
System.out.println(String.format("Status: %s", job.status()));
}
}
}
```
# Dropbox
Dropbox ist ein Datei-Hosting-Dienst, der Cloud-Speicher, Dokumentenorganisation und Dokumentenvorlagen anbietet. Wenn Sie ein Dropbox-Nutzer sind, können Sie Amazon Kendra damit Ihre Dropbox-Dateien, Dropbox Paper, Dropbox Paper-Vorlagen und gespeicherte Verknüpfungen zu Webseiten indexieren. Sie können auch so konfigurierenAmazon Kendra, dass bestimmte Dropbox-Dateien, Dropbox Paper, Dropbox Paper-Vorlagen und gespeicherte Verknüpfungen zu Webseiten indexiert werden.
Amazon Kendraunterstützt sowohl Dropbox als auch Dropbox Advanced für Dropbox Business.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer Dropbox-Datenquelle herstellen.
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Dropbox-Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-dropbox)
+ [
## Voraussetzungen
](#prerequisites-dropbox)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-dropbox)
+ [
## Weitere Informationen
](#dropbox-learn-more)
+ [
## Hinweise
](#dropbox-notes)
## Unterstützte Features
Amazon KendraDer Dropbox-Datenquellen-Connector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Dropbox-Datenquelle Amazon Kendra zum Indizieren verwenden können, müssen Sie diese Änderungen in Ihrer Dropbox und AWS Ihren Konten vornehmen.
**Stellen Sie in Dropbox sicher, dass Sie über Folgendes verfügen:**
+ Sie haben ein Dropbox Advanced-Konto erstellt und einen Admin-Benutzer eingerichtet.
+ Hat eine Dropbox-App mit einem eindeutigen **App-Namen** konfiguriert und **Scoped Access** aktiviert. Informationen zum [Erstellen einer App finden Sie in der Dropbox-Dokumentation](https://www.dropbox.com/developers/reference/getting-started#app%20console).
+ Die **vollständigen Dropbox-Berechtigungen** wurden auf der Dropbox-Konsole aktiviert und die folgenden Berechtigungen hinzugefügt:
+ files.content.read
+ files.metadata.read
+ teilen.lesen
+ Dateianforderungen.lesen
+ gruppen.lesen
+ team\$1info.lesen
+ team\$1data.content.read
+ Sie haben Ihren Dropbox-App-Schlüssel, den geheimen Dropbox-App-Schlüssel und das Dropbox-Zugriffstoken für die Basisauthentifizierung zur Kenntnis genommen.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für mehrere Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ Sie haben ein temporäres OAuth 2.0-Zugriffstoken für Ihre Dropbox-App konfiguriert und kopiert. Dieses Token ist temporär und läuft nach 4 Stunden ab. Informationen zur [ OAuth Authentifizierung finden Sie in der Dropbox-Dokumentation](https://developers.dropbox.com/oauth-guide).
**Anmerkung**
Es wird empfohlen, ein Dropbox-Zugriffstoken für die Aktualisierung zu erstellen, das nie abläuft, anstatt sich auf ein einmaliges Zugriffstoken zu verlassen, das nach 4 Stunden abläuft. Ein Aktualisierungszugriffstoken ist permanent und läuft nie ab, sodass Sie Ihre Datenquelle auch in future synchronisieren können.
+ **Empfehlung: Es** wurde ein permanentes Dropbox-Aktualisierungstoken konfiguriert, das nie abläuft, damit Amazon Kendra Sie Ihre Datenquelle weiterhin ohne Unterbrechungen synchronisieren können. Informationen zu [Aktualisierungstoken finden Sie in der Dropbox-Dokumentation](https://developers.dropbox.com/oauth-guide).
+ Aktiviert, dass jedes Dokument in Dropbox und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Haben Ihre Dropbox-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Dropbox-Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Dropbox-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Dropbox-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie Dropbox noch nicht für konfiguriert habenAmazon Kendra, finden Sie weitere Informationen unter[Voraussetzungen](#prerequisites-dropbox).
------
#### [ Console ]
**So stellen Sie eine Verbindung Amazon Kendra zu Dropbox her**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Dropbox-Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Dropbox-Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **Art des Authentifizierungstokens** — Wählen Sie entweder ein permanentes Token (empfohlen) oder ein temporäres Zugriffstoken.
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Dropbox-Authentifizierungsdaten zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Dropbox' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Für Informationen zum **App-Schlüssel**, zum **geheimen App-Schlüssel** und zum Token (permanent oder temporär): Geben Sie die in Dropbox konfigurierten Werte für die Authentifizierungsdaten ein.
1. Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und sich dafür entscheiden, Ihre ACL zu verwenden, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Synchronisierungseinstellungen konfigurieren** die folgenden Informationen ein:
1. Für **Entitäten oder Inhaltstypen auswählen** — Wählen Sie Dropbox-Entitäten oder Inhaltstypen aus, die Sie crawlen möchten.
1. In **Zusätzliche Konfiguration** für **Regex-Muster — Fügen Sie Muster** für reguläre Ausdrücke hinzu, um bestimmte Dateien ein- oder auszuschließen.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie alle Inhalte neu und ersetzen vorhandene Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Frequenz** aus, wie oft der Inhalt Ihrer Datenquelle synchronisiert und der Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Vorlagen für **Dateien**, **Dropbox Paper** und Dropbox Paper** — Wählen Sie aus den Amazon Kendra generierten Standard-Datenquellenfeldern, die Sie Ihrem Index zuordnen möchten.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra zu Dropbox herzustellen**
Sie müssen mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API einen JSON-Wert des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-dropbox-schema) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `DROPBOX` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Zugriffstokentyp** — Geben Sie an, ob Sie ein permanentes oder ein temporäres Zugriffstoken für Ihr AWS Secrets Manager Geheimnis verwenden möchten, in dem Ihre Authentifizierungsdaten gespeichert werden.
**Anmerkung**
Es wird empfohlen, ein Zugriffstoken für die Aktualisierung zu erstellen, das in Dropbox nie abläuft, anstatt sich auf ein einmaliges Zugriffstoken zu verlassen, das nach 4 Stunden abläuft. Sie erstellen eine App und ein Zugriffstoken für die Aktualisierung in der Dropbox-Entwicklerkonsole und geben das Zugriffstoken geheim an.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Dropbox-Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"appKey": "Dropbox app key",
"appSecret": "Dropbox app secret",
"accesstoken": "temporary access token or refresh access token"
}
```
+ **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und sich dafür entscheiden, Ihre ACL zu verwenden, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
+ **IAMRolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager geheimes Passwort und für das Aufrufen der erforderlichen Öffentlichkeit APIs für den Dropbox-Connector und zu erteilen. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für Dropbox-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Dokument-/Inhaltstypen** — Geben Sie an, ob Dateien in Ihrer Dropbox, Dropbox Paper-Dokumente, Dropbox Paper-Vorlagen und in Ihrer Dropbox gespeicherte Webseitenverknüpfungen gecrawlt werden sollen.
+ **Ein- und Ausschlussfilter** — Geben Sie an, ob bestimmte Dateien ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Zugriffskontrollliste (ACL)** — Geben Sie an, ob die ACL-Informationen für Ihre Dokumente gecrawlt werden sollen, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
+ **Feldzuordnungen** — Wählen Sie, ob Sie Ihre Dropbox-Datenquellenfelder Ihren Amazon Kendra Indexfeldern zuordnen möchten. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [Dropbox-Vorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-dropbox-schema).
------
## Weitere Informationen
Weitere Informationen zur Integration von Amazon Kendra in Ihre Dropbox-Datenquelle finden Sie unter:
+ [Indizieren Sie Ihre Dropbox-Inhalte mithilfe des Dropbox-Connectors für Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/index-your-dropbox-content-using-the-dropbox-connector-for-amazon-kendra/)
## Hinweise
+ Wenn Zugriffskontrolllisten (ACLs) aktiviert sind, ist die Option „Nur neue oder geänderte Inhalte synchronisieren“ aufgrund von Einschränkungen der Dropbox-API nicht verfügbar. Wir empfehlen, stattdessen die Modi „Vollständige Synchronisierung“ oder „Neue, geänderte oder gelöschte Inhalte zu synchronisieren“ zu verwenden oder sie zu deaktivieren, ACLs falls Sie diesen Synchronisierungsmodus verwenden müssen.
# Drupal
**Anmerkung**
Der Drupal-Connector wird für Bestandskunden bis zum 31. Mai 2026 weiterhin vollständig unterstützt. Dieser Konnektor ist zwar nicht mehr für neue Benutzer verfügbar, aktuelle Benutzer können ihn jedoch weiterhin ohne Unterbrechung verwenden. Wir entwickeln unser Konnektor-Portfolio kontinuierlich weiter, um besser skalierbare und anpassbare Lösungen anbieten zu können. Für future Integrationen empfehlen wir, sich mit dem Amazon Kendra Custom Connector Framework [1] vertraut zu machen, das ein breiteres Spektrum von Unternehmensanwendungsfällen mit verbesserter Flexibilität unterstützt.
Drupal ist ein Open-Source-Content-Management-System (CMS), mit dem Sie Websites und Webanwendungen erstellen können. Sie können Folgendes verwendenAmazon Kendra, um in Drupal Folgendes zu indizieren:
+ Inhalt — Artikel, Standardseiten, Basisblöcke, Benutzerdefinierte Inhaltstypen, Benutzerdefinierte Blocktypen, Benutzerdefinierte Inhaltstypen, Benutzerdefinierte Blocktypen
+ Kommentar — Für jeden Inhaltstyp und Blocktyp
+ Anlagen — Für jeden Inhaltstyp und Blocktyp
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) oder die API eine Verbindung zu Ihrer Drupal-Datenquelle herstellen. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Drupal-Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-drupal)
+ [
## Voraussetzungen
](#prerequisites-drupal)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-drupal)
+ [
## Hinweise
](#drupal-notes)
## Unterstützte Features
Amazon KendraDer Drupal-Datenquellen-Connector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Filterung des Benutzerkontextes
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Drupal-Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihrem Drupal und Ihren Konten vor. AWS
**Stellen Sie in Drupal sicher, dass Sie:**
+ Sie haben ein Drupal (Standard) Suite-Konto und einen Benutzer mit Administratorrolle erstellt.
+ Der Name Ihrer Drupal-Site wurde kopiert und eine Host-URL konfiguriert. Beispiel, *https:///*.
+ Konfigurierte Basisauthentifizierungsdaten, die einen Benutzernamen (Login-Benutzername für die Drupal-Website) und ein Passwort (Drupal-Website-Passwort) enthalten.
+ **Empfohlen: Es** wurde ein OAuth 2.0-Anmeldeinformationstoken konfiguriert. Verwenden Sie dieses Token zusammen mit Ihrem Drupal-Passwort, Ihrer Client-ID, Ihrem Kundengeheimnis, Ihrem Benutzernamen (Login-Benutzername für die Drupal-Website) und Ihrem Passwort (Drupal-Website-Passwort), um eine Verbindung herzustellen. Amazon Kendra
+ Mit einer Administratorrolle wurden Ihrem Drupal-Konto die folgenden Berechtigungen hinzugefügt:
+ administer blocks
+ administer block\$1content display
+ administer block\$1content fields
+ administer block\$1content form display
+ administer views
+ view user email addresses
+ view own unpublished content
+ view page revisions
+ view article revisions
+ view all revisions
+ view the administration theme
+ access content
+ access content overview
+ access comments
+ search content
+ access files overview
+ access contextual links
**Anmerkung**
Wenn es benutzerdefinierte Inhaltstypen oder benutzerdefinierte Blocktypen gibt oder Ansichten und Blöcke zur Drupal-Website hinzugefügt werden, müssen diese mit Administratorzugriff versehen werden.
**Stellen Sie sicherAWS-Konto, dass Sie in Ihrem haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Haben Ihre Drupal-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir empfehlen **nicht**, dass Sie Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (falls zutreffend) wiederverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Drupal-Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Drupal-Datenquelle herzustellen, müssen Sie Details zu Ihren Drupal-Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Wenn Sie Drupal noch nicht konfiguriert haben, finden Sie weitere Informationen. Amazon Kendra [Voraussetzungen](#prerequisites-drupal)
------
#### [ Console ]
**Um eine Verbindung zu Amazon Kendra Drupal herzustellen**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Drupal-Konnektor** und dann **Konnektor hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Drupal-Connector** mit dem Tag „V2.0".
1. Geben Sie auf der Seite **„Datenquellendetails angeben**“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. Im **Feld Quelle** für **Host-URL** — Die Host-URL Ihrer Drupal-Site. Beispiel, *https:///*.
1. Für den **Speicherort des SSL-Zertifikats** — Geben Sie den Pfad zu dem in Ihrem Amazon S3 Bucket gespeicherten SSL-Zertifikat ein.
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. Für **Authentifizierung** — Wählen Sie je nach Anwendungsfall zwischen **Standardauthentifizierung** und **OAuth 2.0-Authentifizierung**.
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Drupal-Authentifizierungsdaten zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. Wenn Sie die **Standardauthentifizierung** gewählt haben, geben Sie einen **geheimen Namen**, den **Benutzernamen** (Drupal-Site-Benutzername) und das **Passwort (Drupal-Site-Passwort**) ein, die Sie kopiert haben, und wählen Sie **Speichern und Geheimnis hinzufügen**.
1. **Wenn Sie sich für die **OAuth 2.0-Authentifizierung** entschieden haben, geben Sie einen **geheimen Namen**, einen **Benutzernamen** (Drupal-Site-Benutzername), ein **Passwort (Drupal-Site-Passwort**), eine **Client-ID und einen **geheimen Client-Schlüssel**** ein, die in Ihrem Drupal-Konto generiert wurden, und wählen Sie Speichern und Geheimnis hinzufügen.**
1. Wählen Sie **Speichern**.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Wählen Sie für **den Synchronisierungsbereich** eine der folgenden Optionen aus:
**Anmerkung**
Wenn Sie **Artikel**, **Basic-Seiten** und **Basic-Blöcke** crawlen möchten, werden ihre Standardfelder automatisch synchronisiert. Sie können sich auch dafür entscheiden, ihre Kommentare, Anlagen, benutzerdefinierten Felder und andere benutzerdefinierte Entitäten zu synchronisieren.
1. Gehen Sie unter **Entitäten auswählen** wie folgt vor:
+ **Artikel** – Wählen Sie aus, ob **Artikel**, ihre **Kommentare** und ihre **Anhänge** gecrawlt werden sollen.
+ **Einfache Seiten** – Wählen Sie aus, ob **Einfache Seiten**, ihre **Kommentare** und ihre **Anhänge** gecrawlt werden sollen.
+ **Einfache Blöcke** – Wählen Sie aus, ob **Einfache Blöcke**, ihre **Kommentare** und ihre **Anhänge** gecrawlt werden sollen.
+ Sie können auch **benutzerdefinierte Inhaltstypen** und **benutzerdefinierte Blöcke** hinzufügen.
1. Für **zusätzliche Konfigurationen — optional**:
+ Für **Regex-Muster — Fügen Sie Muster** für reguläre Ausdrücke hinzu, um bestimmte Entitätstitel und Dateinamen ein- oder auszuschließen. Sie können bis zu 100 Muster hinzufügen.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Im **Zeitplan für die Synchronisierungsausführung**, **Häufigkeit** — Wie oft Amazon Kendra die Synchronisierung mit Ihrer Datenquelle erfolgen soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Für **Inhalte**, **Kommentare** und **Anlagen** — Wählen Sie aus den Amazon Kendra generierten Standard-Datenquellenfeldern aus, die Sie Ihrem Index zuordnen möchten.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra zu Drupal herzustellen**
Sie müssen mithilfe der [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API ein JSON des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-drupal-schema) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `DRUPAL` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem Drupal-Konto erstellt haben.
Wenn Sie die Standardauthentifizierung verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"username": "user name",
"password": "password"
}
```
Wenn Sie die OAuth 2.0-Authentifizierung verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"username": "user name",
"password": "password",
"clientId": "client id",
"clientSecret": "client secret"
}
```
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (falls zutreffend) wiederzuverwenden.
+ **IAMrole** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Secret zu geben und die erforderliche Öffentlichkeit APIs für den Drupal-Connector und aufzurufen. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für Drupal-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Sie können angeben, ob Inhalte, Kommentare und Anlagen eingeschlossen werden sollen. Sie können auch Muster für reguläre Ausdrücke angeben, um Inhalte, Kommentare und Anlagen ein- oder auszuschließen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Drupal-Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter[Drupal-Vorlagenschema](ds-schemas.md#ds-drupal-schema).
------
## Hinweise
+ Drupal APIs hat keine offiziellen Drosselungsgrenzen.
+ Java ist SDKs für Drupal nicht verfügbar.
+ Drupal-Daten können nur mit nativen JSON-APIs abgerufen werden.
+ Inhaltstypen, die keiner **Drupal-Ansicht** zugeordnet sind, können nicht gecrawlt werden.
+ **Sie benötigen Administratorzugriff, um Daten aus Drupal-Blöcken zu crawlen.**
+ Es ist keine JSON-API verfügbar, um den benutzerdefinierten Inhaltstyp mithilfe von HTTP-Verben zu erstellen.
+ Der Text und die Kommentare von Dokumenten für **Artikel**, **Einfache Seiten**, **Einfache Blöcke**, den benutzerdefinierten Inhaltstyp und den benutzerdefinierten Blocktyp werden im HTML-Format angezeigt. Wenn der HTML-Inhalt nicht ordnungsgemäß formatiert ist, werden die HTML-bezogenen Tags im Text und den Kommentaren von Dokumenten angezeigt und sind in den Amazon Kendra-Suchergebnissen sichtbar.
+ Inhaltstypen und **Blocktypen** ohne Beschreibung oder Hauptteil werden nicht aufgenommen. Amazon Kendra Nur **Kommentare** und **Anlagen** mit solchen **Inhalts** - oder **Blocktypen** werden in Ihren Amazon Kendra Index aufgenommen.
# GitHub
GitHub ist ein webbasierter Hosting-Dienst für die Softwareentwicklung, der Codespeicher und Verwaltungsdienste mit Versionskontrolle bereitstellt. Sie können Amazon Kendra damit Ihre GitHub Enterprise Cloud (SaaS) und GitHub Enterprise Server (On Prem) Repository-Dateien, Issue- und Pull-Requests, Issue- und Pull-Request-Kommentare sowie Issue- und Pull-Request-Kommentaranhänge indizieren. Sie können auch wählen, ob Sie bestimmte Dateien ein- oder ausschließen möchten.
**Anmerkung**
Amazon Kendraunterstützt jetzt einen aktualisierten GitHub Connector.
Die Konsole wurde automatisch für Sie aktualisiert. Alle neuen Konnektoren, die Sie in der Konsole erstellen, verwenden die aktualisierte Architektur. Wenn Sie die API verwenden, müssen Sie jetzt das [https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekt anstelle des `GitHubConfiguration` Objekts verwenden, um Ihren Connector zu konfigurieren.
Konnektoren, die mit der älteren Konsolen- und API-Architektur konfiguriert wurden, funktionieren weiterhin wie konfiguriert. Sie können sie jedoch nicht bearbeiten oder aktualisieren. Wenn Sie Ihre Connectorkonfiguration bearbeiten oder aktualisieren möchten, müssen Sie einen neuen Connector erstellen.
Wir empfehlen, Ihren Connector-Workflow auf die aktualisierte Version zu migrieren. Die Support für Konnektoren, die mit der älteren Architektur konfiguriert wurden, soll bis Juni 2024 eingestellt werden.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer GitHub Datenquelle herstellen.
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra GitHub Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-github)
+ [
## Voraussetzungen
](#prerequisites-github)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-github)
+ [
## Weitere Informationen
](#github-learn-more)
## Unterstützte Features
Amazon KendraGitHub Ein Datenquellenconnector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre GitHub Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren Konten GitHub und AWS Konten vor.
**Stellen Sie sicher GitHub, dass Sie Folgendes haben:**
+ Es wurde ein GitHub Benutzer mit Administratorrechten für die GitHub Organisation erstellt.
+ In Git Hub wurde ein persönliches Zugriffstoken konfiguriert, das als Ihre Authentifizierungsdaten verwendet werden soll. Weitere Informationen [zum Erstellen eines persönlichen Zugriffstokens finden Sie in der GitHub -Dokumentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token).
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ **Empfohlen: Es** wurde ein OAuth Token für Authentifizierungsdaten konfiguriert. Verwenden Sie ein OAuth Token für bessere API-Drosselungsgrenzen und eine bessere Konnektorleistung. Weitere Informationen finden Sie [in der GitHub Dokumentation zur OAuth Autorisierung](https://docs.github.com/en/rest/apps/oauth-applications?apiVersion=2022-11-28#about-oauth-apps-and-oauth-authorizations-of-github-apps).
+ Notiert die GitHub Host-URL für die Art des GitHub Dienstes, den Sie verwenden. Beispielsweise könnten die Host-URL für die GitHub Cloud *https://api.github.com* und die Host-URL für den GitHub Server lauten*https://on-prem-host-url/api/v3/*.
+ Notieren Sie sich den Namen Ihrer Organisation für GitHub das GitHub Enterprise Cloud (SaaS) -Konto oder das GitHub Enterprise Server-Konto (lokal), mit dem Sie eine Verbindung herstellen möchten. Sie finden den Namen Ihrer Organisation, indem Sie sich bei GitHub Desktop anmelden und **Ihre Organisationen** in der Dropdownliste Ihres Profilbilds auswählen.
+ **Optional (nur Server):** Es wurde ein SSL-Zertifikat generiert und der Pfad zu dem in einem Amazon S3 Bucket gespeicherten Zertifikat kopiert. Sie verwenden dies, um eine Verbindung herzustellen, GitHub falls Sie eine sichere SSL-Verbindung benötigen. Sie können mit OpenSSL einfach ein selbstsigniertes X509-Zertifikat auf jedem Computer generieren. Ein Beispiel für die Verwendung von OpenSSL zur Erstellung eines X509-Zertifikats finden Sie unter [X509-Zertifikat erstellen und signieren](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/configuring-https-ssl.html).
+ Die folgenden Berechtigungen wurden hinzugefügt:
**Für GitHub Enterprise Cloud (SaaS)**
+ `repo:status`— Gewährt read/write Zugriff auf den Commit-Status in öffentlichen und privaten Repositorys. Dieser Bereich ist nur erforderlich, um anderen Benutzern oder Services Zugriff auf den Commit-Status eines privaten Repositorys zu gewähren, ohne Zugriff auf den Code zu erteilen.
+ `repo_deployment` – Gewährt Zugriff auf den Bereitstellungsstatus für öffentliche und private Repositorys. Dieser Bereich ist nur erforderlich, um anderen Benutzern oder Services Zugriff auf den Bereitstellungsstatus eines privaten Repositorys zu gewähren, ohne Zugriff auf den Code zu erteilen.
+ `public_repo` – Beschränkt den Zugriff auf öffentliche Repositorys. Dazu gehören der read/write Zugriff auf Code, Commit-Status, Repository-Projekte, Mitarbeiter und Bereitstellungsstatus für öffentliche Repositorien und Organisationen. Dieser Bereich ist auch erforderlich, um öffentliche Repositorys mit einem Stern zu versehen.
+ `repo:invite`— Gewährt accept/decline Funktionen für Einladungen zur Zusammenarbeit an einem Repository. Dieser Bereich ist nur erforderlich, um anderen Benutzern oder Services Zugriff auf Einladungen zu gewähren, ohne Zugriff auf den Code zu erteilen.
+ `security_events` – Gewährt Lese- und Schreibzugriff auf Sicherheitsereignisse in der Codescan-API. Dieser Bereich ist nur erforderlich, um anderen Benutzern oder Services Zugriff auf Sicherheitsereignisse zu gewähren, ohne Zugriff auf den Code zu erteilen.
+ `read:org` – Schreibgeschützter Zugriff auf Organisationsmitgliedschaften, Organisationsprojekte und Teammitgliedschaften.
+ `user:email` – Gewährt Lesezugriff auf die E-Mail-Adressen eines Benutzers. Wird von Amazon Kendra zum ACLs Crawlen benötigt.
+ `user:follow` – Gewährt Zugriff, um anderen Benutzern zu folgen oder nicht mehr zu folgen. Wird von Amazon Kendra zum ACLs Crawlen benötigt.
+ `read:user` – Gewährt Zugriff zum Lesen der Profildaten eines Benutzers. Wird von Amazon Kendra zum ACLs Crawlen benötigt.
+ `workflow` – Ermöglicht das Hinzufügen und Aktualisieren von GitHub Actions-Workflow-Dateien. Workflow-Dateien können auch ohne diesen Bereich committet werden, wenn dieselbe Datei (mit demselben Pfad und Inhalt) in einem anderen Branch im selben Repository vorhanden ist.
Weitere Informationen finden Sie unter [Geltungsbereiche für OAuth Apps](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps) in Google Docs. GitHub
**Für GitHub Enterprise Server (vor Ort)**
+ `repo:status`— Gewährt read/write Zugriff auf den Commit-Status in öffentlichen und privaten Repositorys. Dieser Bereich ist nur erforderlich, um anderen Benutzern oder Services Zugriff auf den Commit-Status eines privaten Repositorys zu gewähren, ohne Zugriff auf den Code zu erteilen.
+ `repo_deployment` – Gewährt Zugriff auf den Bereitstellungsstatus für öffentliche und private Repositorys. Dieser Bereich ist nur erforderlich, um anderen Benutzern oder Services Zugriff auf den Bereitstellungsstatus eines privaten Repositorys zu gewähren, ohne Zugriff auf den Code zu erteilen.
+ `public_repo` – Beschränkt den Zugriff auf öffentliche Repositorys. Dazu gehören der read/write Zugriff auf Code, Commit-Status, Repository-Projekte, Mitarbeiter und Bereitstellungsstatus für öffentliche Repositorien und Organisationen. Dieser Bereich ist auch erforderlich, um öffentliche Repositorys mit einem Stern zu versehen.
+ `repo:invite`— Gewährt accept/decline Funktionen für Einladungen zur Zusammenarbeit an einem Repository. Dieser Bereich ist nur erforderlich, um anderen Benutzern oder Services Zugriff auf Einladungen zu gewähren, ohne Zugriff auf den Code zu erteilen.
+ `security_events` – Gewährt Lese- und Schreibzugriff auf Sicherheitsereignisse in der Codescan-API. Dieser Bereich ist nur erforderlich, um anderen Benutzern oder Services Zugriff auf Sicherheitsereignisse zu gewähren, ohne Zugriff auf den Code zu erteilen.
+ `read:user` – Gewährt Zugriff zum Lesen der Profildaten eines Benutzers. Für das Crawlen ACLs von Amazon Q Business erforderlich.
+ `user:email` – Gewährt Lesezugriff auf die E-Mail-Adressen eines Benutzers. Für das Crawlen ACLs von Amazon Q Business erforderlich.
+ `user:follow` – Gewährt Zugriff, um anderen Benutzern zu folgen oder nicht mehr zu folgen. Für das Crawlen ACLs von Amazon Q Business erforderlich.
+ `site_admin`— Gewährt Site-Administratoren Zugriff auf GitHub Enterprise Server Administration API-Endpunkte.
+ `workflow` – Ermöglicht das Hinzufügen und Aktualisieren von GitHub Actions-Workflow-Dateien. Workflow-Dateien können auch ohne diesen Bereich committet werden, wenn dieselbe Datei (mit demselben Pfad und Inhalt) in einem anderen Branch im selben Repository vorhanden ist.
Weitere Informationen finden Sie unter [Bereiche für OAuth Apps](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps) in GitHub Google Docs und [Grundlegendes zu Bereichen für OAuth Apps](https://developer.github.com/enterprise/2.16/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) in Developer. GitHub
+ Vergewissert, dass jedes Dokument in GitHub und zwischen anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Wir haben Ihre GitHub Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre GitHub Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Amazon KendraUm eine Verbindung mit Ihrer GitHub Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer GitHub Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie noch keine Konfiguration GitHub für vorgenommen habenAmazon Kendra, finden Sie weitere Informationen unter[Voraussetzungen](#prerequisites-github).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen GitHub**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **GitHub Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **GitHub Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **GitHubsource** — Wählen Sie zwischen **GitHub Enterprise Cloud** und **GitHubEnterprise Server**.
1. **GitHub Host-URL** — Beispielsweise könnte die Host-URL für die GitHub Cloud *https://api.github.com* und die Host-URL für den GitHub Server lauten. *https://on-prem-host-url/api/v3/*
1. **GitHub Name der Organisation** — Geben Sie den Namen Ihrer GitHub Organisation ein. Die Informationen zu Ihrer Organisation finden Sie in Ihrem GitHub Konto.
**Anmerkung**
GitHub Connector unterstützt das Crawlen einer einzelnen Organisation pro Datenquellen-Connector-Instanz.
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre GitHub Authentifizierungsdaten zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra- GitHub -' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Für **GitHubToken** — Geben Sie den in konfigurierten Wert für die Authentifizierungsnachweise ein. GitHub
1. Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) der Suchergebnisse zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. **Repositorys auswählen — Wählen Sie aus, ob alle Repositorys** gecrawlt werden sollen, oder wählen Sie aus.
Wenn Sie sich dafür entscheiden, ausgewählte Repositorys zu crawlen, fügen Sie die Namen für die Repositorys und optional die Namen bestimmter Branches hinzu.
1. **Inhaltstypen** — Wählen Sie die Inhaltstypen aus, die Sie aus Dateien, Issues, Pull Requests und mehr crawlen möchten.
1. **Regex-Muster — Fügen Sie Muster** für reguläre Ausdrücke hinzu, um bestimmte Dateien ein- oder auszuschließen.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. **Zeitplan für In-Sync-Ausführung** für **Häufigkeit** — Wählen Sie aus, wie oft Ihre Datenquelleninhalte synchronisiert und Ihr Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Standard-Datenquellenfelder** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen GitHub**
Sie müssen mithilfe der [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API einen JSON-Wert des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-github-schema) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `GITHUB` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **GitHubtype** — Geben Sie den Typ entweder als `SAAS` oder `ON_PREMISE` an.
+ **Host-URL** — Geben Sie die GitHub Host-URL oder die API-Endpunkt-URL an. Wenn Sie beispielsweise GitHub SaaS/Enterprise Cloud verwenden, könnte die Host-URL lauten`https://api.github.com`, und für GitHub On-Premises/Enterprise Server könnte die Host-URL lauten. `https://on-prem-host-url/api/v3/`
+ **Name der Organisation** — Geben Sie den Namen der Organisation des Kontos an. GitHub Sie finden den Namen Ihrer Organisation, indem Sie sich bei GitHub Desktop anmelden und in der Dropdownliste **Ihres Profilbilds Ihre Organisationen** auswählen.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) der Suchergebnisse zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr GitHub Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"personalToken": "token"
}
```
+ **IAMrole** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen öffentlichen Daten APIs für den GitHub Connector und Amazon Kendra zu erteilen. Weitere Informationen finden Sie unter [IAMRollen für GitHub Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
**Anmerkung**
Wenn Sie einen GitHub Server verwenden, müssen Sie einen verwenden, Amazon VPC um eine Verbindung zu Ihrem GitHub Server herzustellen.
+ **Repository-Filter** — Filtert Repositorys nach ihrem Namen und ihren Zweignamen.
+ **Dokument-/Inhaltstypen** — Geben Sie an, ob Repository-Dokumente, Issues, Issue-Kommentare, Issue-Kommentar-Anlagen, Pull-Requests, Pull-Request-Kommentare und Pull-Request-Kommentaranhänge gecrawlt werden sollen.
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob bestimmte Dateien und Ordner ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Zugriffskontrollliste (ACL)** — Geben Sie an, ob die ACL-Informationen für Ihre Dokumente gecrawlt werden sollen, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre GitHub Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Sie können Felder mit Dokumenten, Commits, Issues, Issue-Anhängen, Issue-Kommentaren, Pull-Requests, Pull-Request-Anhängen und Pull-Request-Kommentaren einbeziehen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Dokument für Ihre Dokumente ist erforderlich, damit Amazon Kendra Ihre Dokumente durchsuchen kann. Sie müssen den Feldnamen des Hauptteils Ihres Dokuments in Ihrer Datenquelle dem Namen `_document_body` des Indexfeldes zuordnen. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [GitHubVorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-github-schema).
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer GitHub Datenquelle finden Sie unter:
+ [Stellen Sie sich die Suche in GitHub Repositorys mit der Leistung des Connectors neu vor Amazon Kendra GitHub ](https://aws.amazon.com/blogs/machine-learning/reimagine-search-on-github-repositories-with-the-power-of-the-amazon-kendra-github-connector/)
# Gmail
Gmail ist ein von Google entwickelter E-Mail-Client, über den Sie E-Mail-Nachrichten mit Dateianhängen senden können. Gmail-Nachrichten können mithilfe von Ordnern und Labels sortiert und in Ihrem E-Mail-Posteingang gespeichert werden. Sie können Amazon Kendra damit Ihre E-Mail-Nachrichten und Nachrichtenanhänge indizieren. Sie können auch konfigurierenAmazon Kendra, dass bestimmte E-Mail-Nachrichten, Nachrichtenanhänge und Labels für die Indizierung ein- oder ausgeschlossen werden.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer Gmail-Datenquelle herstellen.
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Gmail-Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-gmail)
+ [
## Voraussetzungen
](#prerequisites-gmail)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-gmail)
+ [
## Weitere Informationen
](#gmail-learn-more)
+ [
## Hinweise
](#gmail-notes)
## Unterstützte Features
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Gmail-Datenquelle Amazon Kendra zum Indizieren verwenden können, müssen Sie diese Änderungen in Ihrem Gmail-Konto und AWS Ihren Konten vornehmen.
**Stellen Sie in Gmail sicher, dass Sie über Folgendes verfügen:**
+ Sie haben ein Administratorkonto in Google Cloud Platform und ein Google-Cloud-Projekt erstellt.
+ Gmail-API und Admin-SDK-API in Ihrem Admin-Konto aktiviert.
+ Sie haben ein Dienstkonto erstellt und einen privaten JSON-Schlüssel für Ihr Gmail heruntergeladen. Informationen dazu, wie Sie Ihren privaten Schlüssel erstellen und darauf zugreifen, finden Sie in der Google Cloud-Dokumentation zum [Erstellen eines Dienstkontoschlüssels](https://cloud.google.com/iam/docs/keys-create-delete#creating) und zu den [Anmeldeinformationen für das Dienstkonto](https://cloud.google.com/iam/docs/service-account-creds#key-types).
+ Die E-Mail-Adresse Ihres Administratorkontos, die E-Mail-Adresse Ihres Dienstkontos und Ihr privater Schlüssel wurden kopiert, um sie als Authentifizierungsdaten zu verwenden.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ Die folgenden Oauth-Bereiche (mit einer Administratorrolle) wurden für Ihren Benutzer und die gemeinsam genutzten Verzeichnisse, die Sie indexieren möchten, hinzugefügt:
+ https://www.googleapis.com/auth/admin.directory.user.readonly
+ https://www.googleapis.com/auth/gmail.schreibgeschützt
+ Aktiviert, dass jedes Dokument in Gmail und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Haben Ihre Gmail-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Gmail-Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Gmail-Datenquelle herzustellen, müssen Sie Details zu Ihren Gmail-Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie Gmail noch nicht für konfiguriert habenAmazon Kendra, finden Sie weitere Informationen unter[Voraussetzungen](#prerequisites-gmail).
------
#### [ Console ]
**So stellen Sie eine Verbindung Amazon Kendra zu Gmail her**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Gmail-Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Gmail-Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. Unter **Authentifizierung** für **AWSSecrets Managergeheime** Daten — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Gmail-Authentifizierungsdaten zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Geheimer Name** — Ein Name für Ihr Geheimnis.
1. **Kunden-E-Mail** — Die Kunden-E-Mail, die Sie aus Ihrem Google-Dienstkonto kopiert haben.
1. **E-Mail-Adresse des Administratorkontos**: Die E-Mail-Adresse des Administratorkontos, die Sie verwenden möchten.
1. **Privater Schlüssel** — Der private Schlüssel, den Sie aus Ihrem Google-Dienstkonto kopiert haben.
1. Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Für **Entitätstypen** — Wählen Sie aus, ob Nachrichtenanhänge synchronisiert werden sollen.
1. (Optional) Geben Sie für **Zusätzliche Konfiguration** die folgenden Informationen ein:
1. **Datumsbereich** — Geben Sie einen Datumsbereich ein, um das Start- und Enddatum der E-Mails anzugeben, die Sie crawlen möchten.
1. **E-Mail-Domänen** — Schließen Sie bestimmte E-Mails auf der Grundlage der E-Mail-Domänen „An“, „Von“, „CC“ und „BCC“ ein oder aus.
1. **Schlüsselwörter in Betreffs** — Schließen Sie E-Mails auf der Grundlage von Schlüsselwörtern in ihren E-Mail-Betreffs ein oder aus.
**Anmerkung**
Sie können sich auch dafür entscheiden, alle Dokumente einzubeziehen, die allen von Ihnen eingegebenen Betreff-Schlüsselwörtern entsprechen.
1. **Labels** — Fügen Sie Muster für reguläre Ausdrücke hinzu, um bestimmte E-Mail-Labels ein- oder auszuschließen.
1. **Anlagen** — Fügen Sie Muster für reguläre Ausdrücke hinzu, um bestimmte E-Mail-Anhänge ein- oder auszuschließen.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
**Wichtig**
Da es keine API zum Aktualisieren dauerhaft gelöschter Gmail-Nachrichten gibt, werden neue, geänderte oder gelöschte Inhalte synchronisiert:
Nachrichten, die dauerhaft aus Gmail gelöscht wurden, werden nicht aus Ihrem Amazon Kendra Index entfernt
Synchronisiert keine Änderungen an Gmail-E-Mail-Labels
Um die Änderungen an den Labels Ihrer Gmail-Datenquelle und dauerhaft gelöschte E-Mail-Nachrichten mit Ihrem Amazon Kendra Index zu synchronisieren, müssen Sie regelmäßig vollständige Crawls ausführen.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Häufigkeit** aus, wie oft Ihre Datenquelleninhalte synchronisiert und Ihr Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Standard-Datenquellenfelder** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
**Anmerkung**
Amazon KendraDer Gmail-Datenquellen-Connector unterstützt die Erstellung von benutzerdefinierten Indexfeldern aufgrund von API-Einschränkungen nicht.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra zu Gmail herzustellen**
Sie müssen mithilfe der [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API einen JSON-Wert des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-gmail-schema) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `GMAIL` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
**Wichtig**
Da es keine API zum Aktualisieren dauerhaft gelöschter Gmail-Nachrichten gibt, werden neue, geänderte oder gelöschte Inhalte synchronisiert:
Nachrichten, die dauerhaft aus Gmail gelöscht wurden, werden nicht aus Ihrem Amazon Kendra Index entfernt
Synchronisiert keine Änderungen an Gmail-E-Mail-Labels
Um die Änderungen an den Labels Ihrer Gmail-Datenquelle und dauerhaft gelöschte E-Mail-Nachrichten mit Ihrem Amazon Kendra Index zu synchronisieren, müssen Sie regelmäßig vollständige Crawls ausführen.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Gmail-Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"adminAccountEmailId": "service account email",
"clientEmailId": "user account email",
"privateKey": "private key"
}
```
+ **IAMRolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis zu gewähren und die erforderliche Öffentlichkeit APIs für den Gmail-Connector anzurufen undAmazon Kendra. Weitere Informationen finden Sie unter [IAMRollen für Gmail-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob bestimmte „An“ -, „Von“ -, „CC“ - und „BCC“ -E-Mails ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Benutzerkontextfilterung und Zugriffskontrolle** — Amazon Kendra durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
+ **Feldzuordnungen** — Wählen Sie aus, ob Sie Ihre Gmail-Datenquellenfelder Ihren Amazon Kendra Indexfeldern zuordnen möchten. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
**Anmerkung**
Amazon KendraDer Gmail-Datenquellen-Connector unterstützt die Erstellung von benutzerdefinierten Indexfeldern aufgrund von API-Einschränkungen nicht.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [GmailVorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-gmail-schema).
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer Gmail-Datenquelle finden Sie unter:
+ [Führen Sie mithilfe des Gmail-Connectors für eine intelligente Suche in allen E-Mails in Ihrem Google-Workspace durch Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/perform-intelligent-search-across-emails-in-your-google-workspace-using-the-gmail-connector-for-amazon-kendra/).
## Hinweise
+ Da es keine API zum Aktualisieren dauerhaft gelöschter Gmail-Nachrichten gibt, erfolgt die **Synchronisation mit`FULL_CRAWL`//Neue, geänderte oder gelöschte Inhalte**:
+ Nachrichten, die dauerhaft aus Gmail gelöscht wurden, werden nicht aus Ihrem Amazon Kendra Index entfernt
+ Synchronisiert keine Änderungen an Gmail-E-Mail-Labels
Um die Änderungen an den Labels Ihrer Gmail-Datenquelle und dauerhaft gelöschte E-Mail-Nachrichten mit Ihrem Amazon Kendra Index zu synchronisieren, müssen Sie regelmäßig vollständige Crawls ausführen.
+ Amazon KendraDer Gmail-Datenquellen-Connector unterstützt die Erstellung von benutzerdefinierten Indexfeldern aufgrund von API-Einschränkungen nicht.
# Google Drive
Google Drive ist ein Cloud-basierter Dateispeicherdienst. Sie können ihn verwenden Amazon Kendra , um Dokumente zu indizieren, die in den Ordnern „Geteilte Ablagen“, „Meine Ablagen“ und „Für mich freigegeben“ in Ihrer Google Drive-Datenquelle gespeichert sind. Sie können sowohl Google Workspace-Dokumente als auch Dokumente indizieren, die unter [Dokumentationstypen](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html) aufgeführt sind. Sie können auch Inklusions- und Ausschlussfilter verwenden, um Inhalte nach Dateiname, Dateityp und Dateipfad zu indizieren.
Sie können über Amazon Kendra die [Amazon Kendra Konsole](https://console.aws.amazon.com/kendra/), die API oder die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer Google Drive-Datenquelle herstellen. [GoogleDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_GoogleDriveConfiguration.html)
Amazon Kendra hat zwei Versionen des Google Drive-Connectors. Zu den unterstützten Funktionen jeder Version gehören:
**Google Drive-Konnektor V1.0/ API [GoogleDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_GoogleDriveConfiguration.html)**
+ Feldzuordnungen
+ Kontrolle des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
**Google Drive-Konnektor V2.0//API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)**
+ Feldzuordnungen
+ Kontrolle des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
**Anmerkung**
Der Google Drive-Connector V1.0/Google DriveConfiguration API wurde 2023 eingestellt. Wir empfehlen, zu Google Drive Connector V2.0/ API zu migrieren oder diesen zu verwenden. TemplateConfiguration
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Google Drive-Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
# Google Drive-Konnektor V1.0
](data-source-v1-google-drive.md)
+ [
# Google Drive-Anschluss V2.0
](data-source-v2-google-drive.md)
# Google Drive-Konnektor V1.0
Google Drive ist ein Cloud-basierter Dateispeicherdienst. Sie können ihn verwenden Amazon Kendra , um Dokumente und Kommentare zu indizieren, die in den Ordnern „Geteilte Ablagen“, „Meine Ablagen“ und „Für mich freigegeben“ in Ihrer Google Drive-Datenquelle gespeichert sind. Sie können Google Workspace-Dokumente sowie Dokumente indizieren, die unter [Dokumentationstypen](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html) aufgeführt sind. Sie können auch Inklusions- und Ausschlussfilter verwenden, um Inhalte nach Dateiname, Dateityp und Dateipfad zu indizieren.
**Anmerkung**
Der Google Drive-Connector V1.0/Google DriveConfiguration API wurde 2023 eingestellt. Wir empfehlen, zu Google Drive Connector V2.0/ API zu migrieren oder diesen zu verwenden. TemplateConfiguration
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Google Drive-Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-v1-google-drive)
+ [
## Voraussetzungen
](#prerequisites-v1-google-drive)
+ [
## Anweisungen zur Verbindung
](#data-source-v1-procedure-google-drive)
+ [
## Weitere Informationen
](#google-drive-learn-more)
## Unterstützte Features
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
## Voraussetzungen
Bevor Sie Ihre Google Drive-Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihrem Google Drive und Ihren AWS Konten vor.
**Stellen Sie in Google Drive Folgendes sicher:**
+ **Entweder** wurde Ihnen der Zugriff durch eine Super-Admin-Rolle gewährt **oder** Sie sind ein Benutzer mit Administratorrechten. Sie benötigen keine Super-Admin-Rolle für sich selbst, wenn Ihnen der Zugriff durch eine Super-Admin-Rolle gewährt wurde.
+ Mithilfe des Kontos wurde ein Dienstkonto mit **aktivierter Option Domänenweite G Suite-Delegierung** aktivieren und ein JSON-Schlüssel als privater Schlüssel erstellt.
+ Die E-Mail-Adresse Ihres Benutzerkontos und die E-Mail-Adresse Ihres Dienstkontos wurden kopiert. Wenn Sie eine Verbindung herstellen, geben Amazon Kendra Sie die E-Mail-Adresse Ihres Benutzerkontos als Administratorkonto-E-Mail und die E-Mail-Adresse Ihres Dienstkontos als Kunden-E-Mail in Ihrem AWS Secrets Manager Geheimen ein.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ Admin-SDK-API und Google Drive-API wurden zu Ihrem Konto hinzugefügt.
+ Die folgenden Berechtigungen wurden Ihrem Dienstkonto mithilfe einer Super-Admin-Rolle hinzugefügt (oder ein Benutzer mit einer Super-Admin-Rolle wurde gebeten, sie hinzuzufügen):
+ https://www.googleapis.com/auth/drive.readonly
+ https://www.googleapis.com/auth/drive.metadata.readonly
+ https://www.googleapis.com/auth/admin.directory.user.readonly
+ https://www.googleapis.com/auth/admin.directory.group.readonly
+ Vergewissert, dass jedes Dokument in Google Drive und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicher AWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Haben Ihre Google Drive-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Google Drive-Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Google Drive-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Google Drive-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Wenn Sie Google Drive noch nicht konfiguriert haben, Amazon Kendra sehen Sie nach[Voraussetzungen](#prerequisites-v1-google-drive).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra zu Google Drive herzustellen**
1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die [Amazon Kendra Konsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Google Drive-Connector V1.0** und dann **Connector hinzufügen** aus.
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. Als **Authentifizierungstyp** — Wählen Sie zwischen „Bestehend“ **und** „**Neu**“. Wenn Sie ein vorhandenes Geheimnis verwenden möchten, verwenden **Sie Select Secret**, um Ihr Geheimnis auszuwählen.
1. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird eine AWS Secrets Manager geheime Option geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Google Drive-' wird Ihrem geheimen Namen automatisch hinzugefügt.
1. Für **Admin-Konto-E-Mail**, **Kunden-E-Mail** und **privaten Schlüssel**: Geben Sie die Werte für die Authentifizierungsdaten ein, die Sie generiert und von Ihrem Google Drive-Konto heruntergeladen haben.
1. Wählen Sie Authentifizierung **speichern** aus.
1. **IAM Rolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAM Rollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Synchronisierungseinstellungen konfigurieren** die folgenden Informationen ein:
1. **Benutzerkonten ausschließen** — Die Google Drive-Nutzer, die Sie aus dem Index ausschließen möchten. Sie können bis zu 100 Benutzerkonten hinzufügen.
1. **Geteilte Ablagen ausschließen** — Die geteilten Google Drive-Ablagen, die Sie aus Ihrem Index ausschließen möchten. Sie können bis zu 100 geteilte Ablagen hinzufügen.
1. **Laufwerke mit Dateitypen ausschließen** — Die Google Drive-Dateitypen, die Sie aus Ihrem Index ausschließen möchten. Sie können sich auch dafür entscheiden, die MIME-Typauswahl zu bearbeiten.
1. **Zusätzliche Konfigurationen** — Reguläre Ausdrucksmuster zum Ein- oder Ausschließen bestimmter Inhalte. Sie können bis zu 100 Muster hinzufügen.
1. **Häufigkeit** — Wie oft Amazon Kendra wird die Synchronisierung mit Ihrer Datenquelle durchgeführt?
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Für **GoogleDrive Feldnamen** und **Zusätzliche vorgeschlagene Feldzuordnungen** — Wählen Sie eines der Amazon Kendra generierten Standarddatenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra zu Google Drive herzustellen**
Mithilfe der [GoogleDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_GoogleDriveConfiguration.html)API müssen Sie Folgendes angeben:
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Google Drive-Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"clientAccount": "service account email",
"adminAccount": "user account email"",
"privateKey": "private key"
}
```
+ **IAM Rolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis zu gewähren und die erforderliche Öffentlichkeit APIs für den Google Drive-Connector anzurufen und Amazon Kendra. Weitere Informationen finden Sie unter [IAM Rollen für Google Drive-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Inklusions- und Ausschlussfilter** — Amazon Kendra Indiziert standardmäßig alle Dokumente in Google Drive. Sie können angeben, ob bestimmte Inhalte in geteilten Ablagen, Benutzerkonten, MIME-Typen für Dokumente und Dateien ein- oder ausgeschlossen werden sollen. Wenn Sie Benutzerkonten ausschließen, wird keine der Dateien in „Meine Ablage“, die dem Konto gehören, indexiert. Mit dem Nutzer geteilte Dateien werden indexiert, es sei denn, der Eigentümer der Datei wird ebenfalls ausgeschlossen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Inklusionsfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Google Drive-Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
+ **Benutzerkontextfilterung und Zugriffskontrolle**Amazon Kendra — durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer Google Drive-Datenquelle finden Sie unter:
+ [Erste Schritte mit dem Amazon Kendra Google Drive-Connector](https://aws.amazon.com/blogs/machine-learning/getting-started-with-the-amazon-kendra-google-drive-connector/)
# Google Drive-Anschluss V2.0
Google Drive ist ein Cloud-basierter Dateispeicherdienst. Sie können ihn verwenden Amazon Kendra , um Dokumente und Kommentare zu indizieren, die in den Ordnern „Geteilte Ablagen“, „Meine Ablagen“ und „Für mich freigegeben“ in Ihrer Google Drive-Datenquelle gespeichert sind. Sie können Google Workspace-Dokumente sowie Dokumente indizieren, die unter [Dokumentationstypen](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html) aufgeführt sind. Sie können auch Inklusions- und Ausschlussfilter verwenden, um Inhalte nach Dateiname, Dateityp und Dateipfad zu indizieren.
**Anmerkung**
Der Google Drive-Connector V1.0/Google DriveConfiguration API wurde 2023 eingestellt. Wir empfehlen, zu Google Drive Connector V2.0/ API zu migrieren oder diesen zu verwenden. TemplateConfiguration
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Google Drive-Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-v2-google-drive)
+ [
## Voraussetzungen
](#prerequisites-v2-google-drive)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-v2-google-drive)
+ [
## Hinweise
](#google-drive-notes)
## Unterstützte Features
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Google Drive-Datenquelle Amazon Kendra zum Indizieren verwenden können, müssen Sie diese Änderungen in Ihrem Google Drive und AWS Ihren Konten vornehmen.
**Stellen Sie in Google Drive Folgendes sicher:**
+ **Entweder** wurde Ihnen der Zugriff durch eine Super-Admin-Rolle gewährt **oder** Sie sind ein Benutzer mit Administratorrechten. Sie benötigen keine Super-Admin-Rolle für sich selbst, wenn Ihnen der Zugriff durch eine Super-Admin-Rolle gewährt wurde.
+ Sie haben die Anmeldeinformationen für die Verbindung mit dem Google-Drive-Dienstkonto konfiguriert, die Ihre Administratorkonto-E-Mail, die Client-E-Mail (E-Mail-Adresse des Dienstkontos) und den privaten Schlüssel enthalten. Informationen zum [Erstellen und Löschen von Dienstkontoschlüsseln finden Sie in der Dokumentation zu Google Cloud](https://cloud.google.com/iam/docs/keys-create-delete).
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ Sie haben ein Google Cloud-Dienstkonto (ein Konto mit delegierter Befugnis, eine Benutzeridentität anzunehmen) mit aktivierter Option **Domänenweite G Suite-Delegierung aktivieren** für die server-to-server Authentifizierung erstellt und anschließend mithilfe des Kontos einen privaten JSON-Schlüssel generiert.
**Anmerkung**
Der private Schlüssel sollte nach der Erstellung des Dienstkontos generiert werden.
+ Sie haben die Admin-SDK-API und die Google-Drive-API zu Ihrem Benutzerkonto hinzugefügt.
+ **Optional:** Die Verbindungsanmeldedaten für Google Drive OAuth 2.0, die die Client-ID, den geheimen Client-Schlüssel und das Aktualisierungstoken enthalten, wurden als Verbindungsanmeldedaten für einen bestimmten Nutzer konfiguriert. Sie benötigen dies, um individuelle Kontodaten zu crawlen. Informationen zur [Verwendung von OAuth 2.0 für den Zugriff finden Sie in der Google-Dokumentation APIs](https://developers.google.com/identity/protocols/oauth2).
+ Die folgenden OAuth Bereiche wurden Ihrem Dienstkonto mithilfe einer Super-Admin-Rolle hinzugefügt (oder ein Nutzer mit einer Super-Admin-Rolle wurde gebeten, sie hinzuzufügen). Diese API-Bereiche werden benötigt, um alle Dokumente und Informationen zur Zugriffssteuerung (ACL) für alle Benutzer in einer Google-Workspace-Domain zu crawlen:
+ https://www.googleapis.com/auth/Drive.readonly — all Ihre Google Drive-Dateien anzeigen und herunterladen
+ https://www.googleapis.com/auth/drive.metadata.ReadOnly — Zeigen Sie Metadaten für Dateien in Ihrem Google Drive an
+ https://www.googleapis.com/auth/admin.directory.group.readonly — Bereich, in dem nur Gruppen-, Gruppenalias- und Mitgliederinformationen abgerufen werden. Dies wird für den Identity Amazon Kendra Crawler benötigt.
+ https://www.googleapis.com/auth/admin.directory.user.readOnly — Bereich, in dem nur Benutzer oder Benutzeraliase abgerufen werden. Dies ist für die Auflistung von Benutzern im Identity Crawler und für die Einstellung erforderlich. Amazon Kendra ACLs
+ https://www.googleapis.com/auth/Cloud-Plattform — Bereich für die Generierung von Zugriffstoken zum Abrufen von Inhalten großer Google Drive-Dateien.
+ https://www.googleapis.com/auth/forms.body.readOnly — Bereich für das Abrufen von Daten aus Google Forms.
**Um die Forms-API zu unterstützen, fügen Sie den folgenden zusätzlichen Bereich hinzu:**
+ https://www.googleapis.com/auth/forms.body.readonly
+ Aktiviert, dass jedes Dokument in Google Drive und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicher AWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Haben Ihre Google Drive-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Google Drive-Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Google Drive-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Google Drive-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Wenn Sie Google Drive noch nicht konfiguriert haben, Amazon Kendra sehen Sie nach[Voraussetzungen](#prerequisites-v2-google-drive).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra zu Google Drive herzustellen**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon Kendra Konsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Google Drive-Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Google Drive-Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. Zur **Authentifizierung** — Wählen Sie je nach Anwendungsfall zwischen **Google-Dienstkonto** und **OAuth 2.0-Authentifizierung**.
1. **AWS Secrets Manager geheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Google Drive-Authentifizierungsdaten zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Wenn Sie sich für ein **Google-Dienstkonto** entschieden haben, geben Sie einen Namen für Ihr Geheimnis, die E-Mail-ID des Administratorbenutzers oder „Dienstkontonutzers“ in Ihrer Dienstkontokonfiguration (Admin-E-Mail), die E-Mail-ID des Dienstkontos (Kunden-E-Mail) und den privaten Schlüssel ein, den Sie in Ihrem Dienstkonto erstellt haben.
Speichern Sie Ihr Geheimnis und fügen Sie es hinzu
1. Wenn Sie sich für die **OAuth 2.0-Authentifizierung** entschieden haben, geben Sie einen Namen für Ihr Geheimnis, Ihre Client-ID, Ihr Client-Geheimnis und das Aktualisierungstoken ein, das Sie in Ihrem OAuth Konto erstellt haben. Die Benutzer-E-Mail-ID (Benutzer, dessen Verbindungsdetails konfiguriert sind) wird als ACL festgelegt. Der Connector legt aufgrund von API-Einschränkungen keine anderen user/group Hauptinformationen als ACL fest.
Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. (Nur für Nutzer der Google-Dienstkontoauthentifizierung)
**Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) der Suchergebnisse zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
1. **IAM Rolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAM Rollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Synchronisierungseinstellungen konfigurieren** die folgenden Informationen ein:
1. **Inhalte synchronisieren** — Wählen Sie aus, welche Optionen oder welche Inhalte Sie crawlen möchten. Sie können wählen, ob Sie Meine Ablage (persönliche Ordner), Geteilte Ablage (für Sie geteilte Ordner) oder beides crawlen möchten. Sie können auch Dateikommentare hinzufügen.
1. Unter **Zusätzliche Konfiguration — optional** können Sie auch die folgenden optionalen Informationen eingeben:
1. **Maximale Dateigröße — Legt die maximale Größenbeschränkung** für Dateien fest, die MBs gecrawlt werden sollen.
1. **Benutzer-E-Mail** — Fügen Sie Benutzer-E-Mails hinzu, die Sie ein- oder ausschließen möchten.
1. **Geteilte Ablagen** — Fügen Sie die Namen der geteilten Ablagen hinzu, die Sie ein- oder ausschließen möchten.
1. **MIME-Typen** — Fügen Sie MIME-Typen hinzu, die Sie ein- oder ausschließen möchten.
1. **Entity-Regex-Muster — Fügen Sie Muster** für reguläre Ausdrücke hinzu, um bestimmte Anlagen für alle unterstützten Entitäten ein- oder auszuschließen. Sie können bis zu 100 Muster hinzufügen.
**Sie können include/exclude Regex-Muster für **Dateiname, Dateityp** **und Dateipfad** konfigurieren.**
+ **Dateiname — Der Name** der Datei, die ein- oder ausgeschlossen werden soll. Um beispielsweise eine Datei mit einem Namen zu indizieren`teamroster.txt`, geben Sie an`teamroster`.
+ **Dateityp** — Der Typ der Datei, die ein- oder ausgeschlossen werden soll. Beispielsweise .pdf .txt .docx.
+ **Dateipfad — Der Pfad** der Datei, die ein- oder ausgeschlossen werden soll. Um beispielsweise Dateien nur innerhalb `Products list` des Ordners eines Laufwerks zu indizieren, geben `/Products list` Sie Folgendes ein:
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue und geänderte Inhalte. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
**Wichtig**
Die Google-Drive-API bietet keine Unterstützung für das Abrufen von Kommentaren aus einer dauerhaft gelöschten Datei. Kommentare aus gelöschten Dateien können abgerufen werden. Wenn eine Datei in den Papierkorb verschoben wird, löscht der Connector Kommentare aus dem Index. Amazon Kendra
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung** für **Häufigkeit** aus, wie oft Ihre Datenquelleninhalte synchronisiert und Ihr Index aktualisiert werden soll.
1. Wählen Sie im **Synchronisierungslaufverlauf** aus, ob Amazon S3 beim Synchronisieren Ihrer Datenquelle automatisch generierte Berichte in einer gespeichert werden sollen. Dies ist nützlich, um Probleme beim Synchronisieren Ihrer Datenquelle nachzuverfolgen.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Für **Dateien** — Wählen Sie aus den Amazon Kendra generierten Standard-Datenquellenfeldern aus, die Sie Ihrem Index zuordnen möchten.
**Anmerkung**
Die Google Drive-API unterstützt das Erstellen benutzerdefinierter Felder nicht. Die Zuordnung benutzerdefinierter Felder ist für den Google Drive-Connector nicht verfügbar.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra zu Google Drive herzustellen**
Sie müssen mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API einen JSON-Wert des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `GOOGLEDRIVEV2` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Authentifizierungstyp** — Geben Sie an, ob die Dienstkontoauthentifizierung oder die OAuth 2.0-Authentifizierung verwendet werden soll.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
**Wichtig**
Die Google-Drive-API bietet keine Unterstützung für das Abrufen von Kommentaren aus einer dauerhaft gelöschten Datei. Kommentare aus gelöschten Dateien können abgerufen werden. Wenn eine Datei in den Papierkorb verschoben wird, löscht der Connector Kommentare aus dem Index. Amazon Kendra
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem Google Drive-Konto erstellt haben. Wenn Sie die Google-Dienstkonto-Authentifizierung verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"clientEmail": "user account email",
"adminAccountEmail": "service account email",
"privateKey": "private key"
}
```
Wenn Sie die OAuth 2.0-Authentifizierung verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"clientID": "OAuth client ID",
"clientSecret": "client secret",
"refreshToken": "refresh token"
}
```
+ **IAM Rolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen Öffentlichkeit APIs für den Google Drive-Connector und Amazon Kendra zu erteilen. Weitere Informationen finden Sie unter [IAM Rollen für Google Drive-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Meine Ablagen, Geteilte Ablagen, Kommentare** — Sie können angeben, ob diese Arten von Inhalten gecrawlt werden sollen.
+ **Inklusions- und Ausschlussfilter** — Sie können angeben, ob bestimmte Benutzerkonten, geteilte Ablagen und MIME-Typen ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Zugriffskontrollliste (ACL)** — Geben Sie an, ob die ACL-Informationen für Ihre Dokumente gecrawlt werden sollen, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
+ **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) der Suchergebnisse zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Google Drive-Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [Google Drive-Vorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-google-drive-schema).
------
## Hinweise
+ Die benutzerdefinierte Feldzuordnung ist für den Google-Drive-Konnektor nicht verfügbar, da die Google-Drive-Benutzeroberfläche das Erstellen benutzerdefinierter Felder nicht unterstützt.
+ Die Google Drive-API unterstützt das Abrufen von Kommentaren aus einer dauerhaft gelöschten Datei nicht. Kommentare können jedoch für Dateien im Papierkorb abgerufen werden. Wenn eine Datei in den Papierkorb verschoben wird, löscht der Amazon Kendra Connector Kommentare aus dem Index. Amazon Kendra
+ Die Google-Drive-API gibt keine Kommentare zurück, die in einer DOCX-Datei vorhanden sind.
+ Wenn die Berechtigung für ein bestimmtes Dokument Google document (Dokument, Tabelle, Folie usw.) **auf Allgemeiner Zugriff gesetzt ist: Jeder, der den Link** oder **Geteilt für Ihre spezifische Unternehmensdomain** hat, ist das Dokument für Benutzer der Amazon Kendra-Suche erst sichtbar, wenn der Benutzer, der die Anfrage stellt, auf das Dokument zugegriffen hat.
# IBM DB2
**Anmerkung**
Der IBM DB2-Konnektor wird für Bestandskunden bis zum 31. Mai 2026 weiterhin vollständig unterstützt. Dieser Konnektor ist zwar nicht mehr für neue Benutzer verfügbar, aktuelle Benutzer können ihn jedoch weiterhin ohne Unterbrechung verwenden. Wir entwickeln unser Konnektor-Portfolio kontinuierlich weiter, um besser skalierbare und anpassbare Lösungen anbieten zu können. Für future Integrationen empfehlen wir, sich mit dem Amazon Kendra Custom Connector Framework [1] vertraut zu machen, das ein breiteres Spektrum von Unternehmensanwendungsfällen mit verbesserter Flexibilität unterstützt.
IBM DB2ist ein relationales Datenbankmanagementsystem, das von entwickelt wurde. IBM Wenn Sie IBM DB2-Benutzer sind, können Sie Amazon Kendra verwenden, um Ihre IBM DB2-Datenquelle indexieren. Der Amazon Kendra IBM DB2 Datenquellen-Connector unterstützt DB2 11.5.7.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer IBM DB2 Datenquelle herstellen.
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra IBM DB2 Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-ibm-db2)
+ [
## Voraussetzungen
](#prerequisites-ibm-db2)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-ibm-db2)
+ [
## Hinweise
](#ibm-db2-notes)
## Unterstützte Features
+ Feldzuordnungen
+ Filterung des Benutzerkontextes
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre IBM DB2 Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren Konten IBM DB2 und AWS Konten vor.
**Stellen Sie in IBM DB2 Folgendes sicher:**
+ Notieren Sie sich Ihren Datenbankbenutzernamen und Ihr Passwort.
**Wichtig**
Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Die URL, der Port und die Instanz Ihres Datenbank-Hosts wurden kopiert.
+ Vergewissert, dass jedes Dokument in IBM DB2 und zwischen anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Wir haben Ihre IBM DB2 Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre IBM DB2 Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer IBM DB2 Datenquelle herzustellen, müssen Sie Details zu Ihren IBM DB2 Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben, Amazon Kendra finden Sie IBM DB2 weitere Informationen unter[Voraussetzungen](#prerequisites-ibm-db2).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen IBM DB2**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **IBM DB2Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **IBM DB2Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. Geben Sie unter **Quelle** die folgenden Informationen ein:
1. **Host** — Geben Sie den Datenbank-Hostnamen ein.
1. **Port** — Geben Sie den Datenbankport ein.
1. **Instanz** — Geben Sie die Datenbankinstanz ein.
1. **Speicherort des SSL-Zertifikats aktivieren** — Geben Sie hier den Amazon S3 Pfad zu Ihrer SSL-Zertifikatsdatei ein.
1. Geben Sie im Feld **Authentifizierung** die folgenden Informationen ein:
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre IBM DB2 Authentifizierungsdaten zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra- IBM DB2 -' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Für **Datenbankbenutzername** und **Passwort** — Geben Sie die Werte der Authentifizierungsdaten ein, die Sie aus Ihrer Datenbank kopiert haben.
1. Wählen Sie **Speichern**.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Wählen Sie unter **Synchronisierungsbereich** aus den folgenden Optionen aus:
+ **SQL-Abfrage** – Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Primärschlüsselspalte** – Geben Sie den Primärschlüssel für die Datenbanktabelle an. Dadurch wird eine Tabelle in Ihrer Datenbank identifiziert.
+ **Titelspalte** – Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein.
+ **Hauptspalte** — Geben Sie den Namen der Textspalte des Dokuments in Ihrer Datenbanktabelle ein.
1. Wählen Sie **unter Zusätzliche Konfiguration — *optional*** aus den folgenden Optionen, um bestimmte Inhalte zu synchronisieren, anstatt alle Dateien zu synchronisieren:
+ **Spalten zur Erkennung von Änderungen** — Geben Sie die Namen der Spalten ein, anhand derer Inhaltsänderungen erkannt Amazon Kendra werden sollen. Amazon Kendraindexiert den Inhalt neu, wenn sich eine dieser Spalten ändert.
+ ** IDsBenutzerspalte** — Geben Sie den Namen der Spalte ein, die Benutzer IDs enthält, denen Zugriff auf Inhalte gewährt werden soll.
+ **Gruppenspalte** – Geben Sie den Namen der Spalte ein, die Gruppen enthält, denen Zugriff auf Inhalte gewährt werden soll.
+ ** URLsQuellspalte** — Geben Sie den Namen der Spalte ein, die die URLs zu indizierende Quelle enthält.
+ **Spalte mit Zeitstempeln** — Geben Sie den Namen der Spalte ein, die Zeitstempel enthält. Amazon Kendraverwendet Zeitstempelinformationen, um Änderungen an Ihren Inhalten zu erkennen und nur geänderte Inhalte zu synchronisieren.
+ **Zeitzonenspalte** – Geben Sie den Namen der Spalte ein, die Zeitzonen für den Inhalt enthält, der durchsucht werden soll.
+ **Zeitstempelformat** – Geben Sie den Namen der Spalte ein, die Zeitstempelformate enthält, die verwendet werden sollen, um Inhaltsänderungen zu erkennen und Ihre Inhalte erneut zu synchronisieren.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Im **Synchronisierungslaufplan** für **Frequenz** — Wie oft Amazon Kendra wird mit Ihrer Datenquelle synchronisiert?
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den generierten Standarddatenquellenfeldern — **Dokument IDs**, **Dokumenttitel** und **Quelle URLs** — aus, die Sie dem Index zuordnen möchten. Amazon Kendra
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen IBM DB2**
Mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API müssen Sie Folgendes angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `JDBC` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Datenbanktyp** — Sie müssen den Datenbanktyp als `db2` angeben.
+ **SQL-Abfrage** — Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen an. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem IBM DB2 Konto erstellt haben. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"user name": "database user name",
"password": "password"
}
```
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (falls zutreffend) wiederzuverwenden.
+ **IAMRolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen Öffentlichkeit APIs für den IBM DB2 Connector und zu erteilen. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für IBM DB2 Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Sie können mithilfe von Benutzern, Gruppen IDs, Quellen, Zeitstempeln und Zeitzonen angeben URLs, ob bestimmte Inhalte eingeschlossen werden sollen.
+ **Benutzerkontextfilterung und Zugriffskontrolle** — Amazon Kendra durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre IBM DB2 Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter[DB2 IBM-Vorlagenschema](ds-schemas.md#ds-ibm-db2-schema).
------
## Hinweise
+ Gelöschte Datenbankzeilen werden nicht nachverfolgt, wenn nach Amazon Kendra aktualisiertem Inhalt gesucht wird.
+ Die Größe von Feldnamen und Werten in einer Zeile Ihrer Datenbank darf 400 KB nicht überschreiten.
+ Wenn Ihre Datenbankdatenquelle eine große Datenmenge enthält und Sie nicht Ihren gesamten Datenbankinhalt nach der ersten Synchronisierung indizieren möchtenAmazon Kendra, können Sie wählen, ob nur neue, geänderte oder gelöschte Dokumente synchronisiert werden sollen.
+ Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Es hat sich bewährt, das Hinzufügen von Tabellen mit sensiblen Daten oder personenbezogenen Daten (PII) zu vermeiden.
# Jira
Jira ist ein Projektmanagement-Tool für Softwareentwicklung, Produktmanagement und Fehlerüberwachung. Sie können ihn verwendenAmazon Kendra, um Ihre Jira-Projekte, Probleme, Kommentare, Anhänge, Arbeitsprotokolle und Status zu indizieren.
Amazon Kendraunterstützt derzeit nur Jira Cloud.
Sie können entweder über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) oder die API eine Verbindung zu Ihrer Jira-Datenquelle herstellen. [JiraConfiguration ](https://docs.aws.amazon.com/kendra/latest/APIReference/API_JiraConfiguration.html) Eine Liste der Funktionen, die von den einzelnen Funktionen unterstützt werden, finden Sie unter[Unterstützte Features](#supported-features-jira).
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Jira-Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-jira)
+ [
## Voraussetzungen
](#prerequisites-jira)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-jira)
+ [
## Weitere Informationen
](#jira-learn-more)
## Unterstützte Features
Amazon KendraDer Jira-Datenquellen-Connector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Jira-Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihrem Jira und Ihren Konten vor. AWS
**Stellen Sie in Jira Folgendes sicher:**
+ Konfigurierte API-Token-Authentifizierungsdaten, die eine Jira-ID (Benutzername oder E-Mail) und Jira-Anmeldeinformationen (Jira-API-Token) enthalten. Informationen zur Verwaltung von API-Token findest du in der [Atlassian-Dokumentation](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/).
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon ab**, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ Sie haben sich die URL Ihres Jira-Kontos aus Ihren Jira-Kontoeinstellungen notiert. Beispiel, *https://company.atlassian.net/*.
+ Aktiviert, dass jedes Dokument in Jira und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Du hast deine Jira-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls du die API verwendest, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Jira-Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Jira-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Jira-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Wenn Sie Jira für Amazon Kendra noch nicht konfiguriert haben, finden Sie weitere Informationen unter. [Voraussetzungen](#prerequisites-jira)
------
#### [ Console ]
**So stellen Sie eine Verbindung Amazon Kendra zu Jira her**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Jira-Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie **Jira Connector mit dem Tag** „V2.0".
1. Geben Sie auf der Seite **„Datenquellendetails angeben**“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Jira-Konto-URL** — Geben Sie die URL Ihres Jira-Kontos ein. Beispiel: *https://company.atlassian.net/*.
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Jira-Authentifizierungsdaten zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Jira-' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Für **Jira ID — Geben Sie den Jira-Benutzernamen** oder die Jira-E-Mail-Adresse ein.
1. Für **Passwort/Token — Geben Sie das in Jira konfigurierte Jira-API-Token** ein.
1. Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) der Suchergebnisse zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. **Wählen Sie aus, welche Jira-Projekte indexiert werden sollen** — Wählen Sie aus, ob alle Projekte oder bestimmte Projekte gecrawlt werden sollen.
1. **Zusätzliche Konfiguration** — Geben Sie bestimmte Status und Problemtypen an. Wählen Sie, ob Kommentare, Anlagen und Arbeitsprotokolle gecrawlt werden sollen. Verwenden Sie Muster mit regulären Ausdrücken, um bestimmte Inhalte ein- oder auszuschließen.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie alle Inhalte neu und ersetzen vorhandene Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Frequenz** aus, wie oft der Inhalt Ihrer Datenquelle synchronisiert und der Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Standard-Datenquellenfelder** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra zu Jira herzustellen**
Mithilfe der [JiraConfiguration ](https://docs.aws.amazon.com/kendra/latest/APIReference/API_JiraConfiguration.html)API müssen Sie Folgendes angeben:
+ **Datenquellen-URL** — Geben Sie die URL Ihres Jira-Kontos an. Beispiel, *company.atlassian.net*.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Jira-Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"jiraId": "Jira user name or email",
"jiraCredential": "Jira API token"
}
```
+ **IAMrole** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis zu gewähren und die erforderliche Öffentlichkeit APIs für den Jira-Konnektor aufzurufen und. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für Jira-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie dies `VpcConfiguration` als Teil der Datenquellenkonfiguration an. Siehe [Konfiguration Amazon Kendra für die Verwendung einer VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
+ **Änderungsprotokoll** — Ob der Änderungsprotokollmechanismus der Jira-Datenquelle verwendet werden Amazon Kendra soll, um festzustellen, ob ein Dokument im Index aktualisiert werden muss.
**Anmerkung**
Verwenden Sie das Änderungsprotokoll, wenn Sie nicht alle Dokumente scannen Amazon Kendra möchten. Wenn Ihr Änderungsprotokoll umfangreich ist, dauert das Scannen der Dokumente in der Jira-Datenquelle möglicherweise Amazon Kendra weniger Zeit als das Verarbeiten des Änderungsprotokolls. Wenn Sie Ihre Jira-Datenquelle zum ersten Mal mit Ihrem Index synchronisieren, werden alle Dokumente gescannt.
+ **Inklusions- und Ausschlussfilter** — Sie können angeben, ob bestimmte Dateien ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Kommentar, Anlagen und Arbeitsprotokolle** — Sie können angeben, ob bestimmte Kommentare, Anlagen und Arbeitsprotokolle zu Problemen gecrawlt werden sollen.
+ **Projekte, Probleme, Status** — Sie können angeben, ob bestimmte Projekte IDs, Problemtypen und Status gecrawlt werden sollen.
+ **Benutzerkontextfilterung und Zugriffskontrolle** — Amazon Kendra durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Jira-Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Feld „Hauptteil des Dokuments“ oder das Äquivalent zum Dokumententext für Ihre Dokumente ist erforderlich, damit Sie Ihre Dokumente durchsuchen Amazon Kendra können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer Jira-Datenquelle finden Sie unter:
+ [Durchsuchen Sie Ihre Jira-Projekte intelligent mit dem Jira Cloud Connector Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/intelligently-search-your-jira-projects-with-amazon-kendra-jira-cloud-connector/)
# Microsoft Exchange
Microsoft Exchange ist ein Tool für die Zusammenarbeit in Unternehmen für Messaging, Besprechungen und Filesharing. Wenn Sie ein Microsoft Exchange-Benutzer sind, können Sie Amazon Kendra damit Ihre Microsoft Exchange-Datenquelle indizieren.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer Microsoft Exchange-Datenquelle herstellen.
Informationen zur Problembehandlung Ihres Amazon Kendra Microsoft Exchange-Datenquellenconnectors finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
## Unterstützte Features
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Microsoft Exchange-Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihrem Microsoft Exchange und Ihren AWS Konten vor.
**Stellen Sie in Microsoft Exchange sicher, dass Sie über Folgendes verfügen:**
+ Hat ein Microsoft Exchange-Konto in Office 365 erstellt.
+ Haben Sie Ihre Microsoft 365-Mandanten-ID notiert. Sie finden Ihre Mandanten-ID in den Eigenschaften Ihres Azure Active Directory-Portals oder in Ihrer OAuth Anwendung.
+ Hat eine OAuth Anwendung im Azure-Portal konfiguriert und die Client-ID und den geheimen Client-Schlüssel oder die Kundenanmeldedaten notiert. Weitere Informationen finden Sie im [Microsoft-Tutorial](https://learn.microsoft.com/en-us/power-apps/developer/data-platform/walkthrough-register-app-azure-active-directory) und im [Beispiel für registrierte Apps](https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application).
**Anmerkung**
Wenn Sie eine App im Azure-Portal erstellen oder registrieren, stellt die geheime ID den tatsächlichen geheimen Wert dar. Sie müssen den tatsächlichen geheimen Wert sofort bei der Erstellung des Geheimnisses und der App notieren oder speichern. Sie können auf Ihr Geheimnis zugreifen, indem Sie den Namen Ihrer Anwendung im Azure-Portal auswählen und dann zur Menüoption für Zertifikate und Geheimnisse navigieren.
Sie können auf Ihre Client-ID zugreifen, indem Sie den Namen Ihrer Anwendung im Azure-Portal auswählen und dann zur Übersichtsseite navigieren. Die Anwendungs-ID (Client) ist die Client-ID.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ Sie haben die folgenden Berechtigungen für die Konnektor-Anwendung hinzugefügt:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/data-source-exchange.html)
+ Aktiviert, dass jedes Dokument in Microsoft Exchange und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, eindeutig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen pro Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Ihre Microsoft Exchange-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Microsoft Exchange-Datenquelle mit verbindenAmazon Kendra. Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Microsoft Exchange-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Microsoft Exchange-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Wenn Sie Microsoft Exchange für noch nicht konfiguriert habenAmazon Kendra, finden Sie weitere Informationen unter[Voraussetzungen](#prerequisites-exchange).
------
#### [ Console ]
**So stellen Sie eine Verbindung Amazon Kendra zu Microsoft Exchange her**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Microsoft Exchange-Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie **Microsoft Exchange Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Mandanten-ID** — Geben Sie Ihre Microsoft 365-Mandanten-ID ein. Sie finden Ihre Mandanten-ID in den Eigenschaften Ihres Azure Active Directory-Portals oder in Ihrer OAuth Anwendung.
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Microsoft Exchange-Authentifizierungsanmeldeinformationen zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Microsoft Exchange
1. Für **Client ID**, **Client Secret** — Geben Sie die in Microsoft Exchange konfigurierten Authentifizierungsdaten im Azure-Portal ein.
1. Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. **Benutzer IDs** — Geben Sie die E-Mail-Adresse des Benutzers an, wenn Sie Inhalte nach bestimmten E-Mails filtern möchten.
1. **Zusätzliche Konfiguration** — Geben Sie die Inhaltstypen an, die Sie crawlen möchten.
+ **Entitätstypen** — Sie können wählen, ob Kalender- oder Kontaktinhalte gecrawlt werden sollen OneNotes.
+ **Kalender-Crawling** — Geben Sie das Start- und Enddatum ein, um Inhalte zwischen bestimmten Daten zu crawlen.
+ **E-Mail einbeziehen** — Geben Sie „An“, „Von“ und E-Mail-Betreffzeilen ein, um bestimmte E-Mails zu filtern, die Sie crawlen möchten.
+ **Zugriff auf freigegebene Ordner** — Aktivieren Sie diese Option, um das Crawlen der Zugriffskontrollliste für Ihre Microsoft Exchange-Datenquelle zu aktivieren.
+ **Regex für Domänen — Fügen Sie Muster für** reguläre Ausdrücke hinzu, um bestimmte E-Mail-Domänen ein- oder auszuschließen.
+ **Regex-Muster — Fügen Sie Muster** für reguläre Ausdrücke hinzu, um bestimmte Dateien ein- oder auszuschließen.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Frequenz** aus, wie oft der Inhalt Ihrer Datenquelle synchronisiert und der Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Standard-Datenquellenfelder** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
**Anmerkung**
Der Amazon Kendra Microsoft Exchange-Datenquellenconnector unterstützt keine benutzerdefinierten Feldzuordnungen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**So stellen Sie eine Verbindung Amazon Kendra zu Microsoft Exchange her**
Sie müssen mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API eine JSON-Datei des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-msexchange-schema.html) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `MSEXCHANGE` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Mandanten-ID** — Sie finden Ihre Mandanten-ID in den Eigenschaften Ihres Azure Active Directory-Portals oder in Ihrer OAuth Anwendung.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Microsoft Exchange-Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"clientId": "client ID",
"clientSecret": "client secret"
}
```
+ **IAMrole** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis zu gewähren und die erforderliche Öffentlichkeit APIs für den Microsoft Exchange-Connector aufzurufen undAmazon Kendra. Weitere Informationen finden Sie unter [IAMRollen für Microsoft Exchange-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob bestimmte Inhalte ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Zugriffskontrollliste (ACL)** — Geben Sie an, ob die ACL-Informationen für Ihre Dokumente gecrawlt werden sollen, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Microsoft Exchange-Datenquellenfelder Ihren Amazon Kendra Indexfeldern zuzuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [Microsoft Exchange-Vorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-msexchange-schema).
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer Microsoft Exchange-Datenquelle finden Sie unter:
+ [Indizieren Sie Ihre Microsoft Exchange-Inhalte mit dem Exchange-Connector für Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/index-your-microsoft-exchange-content-using-the-exchange-connector-for-amazon-kendra/)
## Hinweise
+ Wenn Access Control Lists (ACLs) aktiviert sind, ist die Option „Nur neue oder geänderte Inhalte synchronisieren“ aufgrund von Microsoft Exchange-API-Einschränkungen nicht verfügbar. Wir empfehlen, stattdessen die Modi „Vollständige Synchronisierung“ oder „Neue, geänderte oder gelöschte Inhalte“ zu verwenden oder sie zu deaktivieren, ACLs falls Sie diesen Synchronisierungsmodus verwenden müssen.
# Microsoft OneDrive
Microsoft OneDrive ist ein Cloud-basierter Speicherdienst, mit dem Sie Ihre Inhalte speichern, teilen und hosten können. Sie können Amazon Kendra es verwenden, um Ihre OneDrive Datenquelle zu indizieren.
Sie können über Amazon Kendra die [Amazon Kendra Konsole](https://console.aws.amazon.com/kendra/) und die [OneDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_OneDriveConfiguration.html)API eine Verbindung zu Ihrer OneDrive Datenquelle herstellen.
Amazon Kendra hat zwei Versionen des OneDrive Connectors. Zu den unterstützten Funktionen jeder Version gehören:
** OneDrive Microsoft-Konnektor V1.0//API [OneDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_OneDriveConfiguration.html)**
+ Feldzuordnungen
+ Einschluss- und Ausschlussfilter
** OneDrive Microsoft-Konnektor V2.0//API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)**
+ Filterung des Benutzerkontextes
+ Crawler zur Benutzeridentität
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
**Anmerkung**
Die Support für OneDrive Connector OneDriveConfiguration V1.0/API wird voraussichtlich im Juni 2023 eingestellt. Wir empfehlen die Verwendung von OneDrive Connector V2.0 TemplateConfiguration /API.
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra OneDrive Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
# OneDrive Microsoft-Konnektor V1.0
](data-source-v1-onedrive.md)
+ [
# OneDrive Microsoft-Anschluss V2.0
](data-source-v2-onedrive.md)
+ [
## Weitere Informationen
](#onedrive-learn-more)
+ [
## Hinweise
](#onedrive-notes)
# OneDrive Microsoft-Konnektor V1.0
Microsoft OneDrive ist ein Cloud-basierter Speicherdienst, mit dem Sie Ihre Inhalte speichern, teilen und hosten können. Sie können Amazon Kendra es verwenden, um Ihre OneDrive Microsoft-Datenquelle zu indizieren.
**Anmerkung**
Die Support für OneDrive Connector V1.0/ Microsft OneDrive API wird voraussichtlich im Juni 2023 eingestellt. Wir empfehlen die Verwendung von OneDrive Connector V2.0 /API. TemplateConfiguration
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra OneDrive Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-v1-onedrive)
+ [
## Voraussetzungen
](#prerequisites-v1-onedrive)
+ [
## Anweisungen zur Verbindung
](#data-source-v1-procedure-onedrive)
## Unterstützte Features
+ Feldzuordnungen
+ Einschluss- und Ausschlussfilter
## Voraussetzungen
Bevor Sie Ihre OneDrive Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren AWS Konten OneDrive und Konten vor.
**Stellen Sie in Ihrem Azure Active Directory (AD) sicher, dass Sie über Folgendes verfügen:**
+ Sie haben eine Azure Active Directory (AD)-Anwendung erstellt.
+ Sie haben die AD-Anwendungs-ID verwendet, um einen geheimen Schlüssel für die Anwendung auf der AD-Website zu registrieren. Der geheime Schlüssel muss die Anwendungs-ID und einen geheimen Schlüssel enthalten.
+ Sie haben die AD-Domain der Organisation kopiert.
+ Ihrer AD-Anwendung wurden mit der Option Microsoft Graph die folgenden Anwendungsberechtigungen hinzugefügt:
+ Dateien in allen Websitesammlungen lesen (File.Read.All)
+ Lesen Sie das vollständige Profil aller Benutzer (User.Read.All)
+ Lesen Sie die Verzeichnisdaten (Directory.Read.All)
+ Alle Gruppen lesen (Group.Read.All)
+ Elemente in allen Websitesammlungen lesen (Site.Read.All)
+ Die Liste der Benutzer wurde kopiert, deren Dokumente indexiert werden müssen. Sie können wählen, ob Sie eine Liste mit Benutzernamen angeben möchten, oder Sie können die Benutzernamen in einer Datei angeben, die in einer gespeichert ist Amazon S3. Nachdem Sie die Datenquelle erstellt haben, können Sie:
+ Die Benutzerliste ändern.
+ Wechseln Sie von einer Benutzerliste zu einer Liste, die in einem Amazon S3 Bucket gespeichert ist.
+ Ändern Sie den Amazon S3 Bucket-Speicherort einer Benutzerliste. Wenn Sie den Bucket-Speicherort ändern, müssen Sie auch die IAM Rolle für die Datenquelle aktualisieren, damit sie Zugriff auf den Bucket hat.
**Anmerkung**
Wenn Sie die Liste der Benutzernamen in einem Amazon S3 Bucket speichern, muss die IAM Richtlinie für die Datenquelle den Zugriff auf den Bucket und gegebenenfalls den Zugriff auf den Schlüssel ermöglichen, mit dem der Bucket verschlüsselt wurde.
+ Aktiviert, dass jedes Dokument in OneDrive und zwischen anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen pro Index eindeutig sein.
**Stellen Sie in Ihrem sicher AWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Wir haben Ihre OneDrive Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre OneDrive Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer OneDrive Datenquelle herzustellen, müssen Sie Details zu Ihren OneDrive Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben, Amazon Kendra finden Sie OneDrive weitere Informationen unter[Voraussetzungen](#prerequisites-v1-onedrive).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen OneDrive**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon Kendra Konsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **OneDrive Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **OneDrive Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **OneDrive Mandanten-ID** — Geben Sie die OneDrive Mandanten-ID ohne das Protokoll ein.
1. **Art der Authentifizierung** **— Wählen Sie zwischen „**Neu**“ und „Bestehend“.**
1.
1. Wenn Sie **Vorhanden** auswählen, wählen Sie unter **Secret auswählen** ein vorhandenes Secret aus.
1. Wenn Sie „**Neu**“ wählen, geben Sie die folgenden Informationen in den Bereich „**Neues AWS Secrets Manager Geheimnis**“ ein:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra- OneDrive -' wird Ihrem geheimen Namen automatisch hinzugefügt.
1. **Für **Anwendungs-ID** und **Anwendungskennwort** — Geben Sie die Werte für die Authentifizierungsdaten aus Ihrem OneDrive Konto ein und wählen Sie dann Authentifizierung speichern.**
1. **IAM Rolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAM Rollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Wählen Sie je nach Anwendungsfall zwischen **Datei** **auflisten und Namensliste**.
1. Wenn Sie „**Datei auflisten**“ wählen, geben Sie die folgenden Informationen ein:
1. **Standort auswählen** — Geben Sie den Pfad zu Ihrem Amazon S3 Bucket ein.
**Benutzerlistendatei hinzufügen zu Amazon S3** — Wählen Sie diese Option, um Ihre Benutzerlistendateien zu Ihrem Amazon S3 Bucket hinzuzufügen.
**Zuordnungen lokaler Benutzergruppen** — Wählen Sie diese Option aus, um Ihre Inhalte mithilfe der lokalen Gruppenzuweisung zu filtern.
1. Wenn Sie „**Namensliste**“ wählen, geben Sie die folgenden Informationen ein:
1. **Benutzername** — Geben Sie bis zu 10 Benutzerlaufwerke für die Indizierung ein. Um mehr als 10 Benutzer hinzuzufügen, erstellen Sie eine Datei, die die Namen enthält.
**Weitere hinzufügen** — Wählen Sie diese Option, um weitere Benutzer hinzuzufügen.
**Zuordnungen lokaler Benutzergruppen** — Wählen Sie diese Option aus, um Ihre Inhalte mithilfe der lokalen Gruppenzuweisung zu filtern.
1. Für **zusätzliche Konfigurationen** — Fügen Sie Muster für reguläre Ausdrücke hinzu, um bestimmte Dateien ein- oder auszuschließen. Sie können bis zu 100 Muster hinzufügen.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Frequenz** aus, wie oft mit Ihrer Datenquelle synchronisiert Amazon Kendra werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Für **Standard-Datenquellenfelder** und **Zusätzliche vorgeschlagene Feldzuordnungen** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann Datenquelle **hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen OneDrive**
Mithilfe der [OneDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_OneDriveConfiguration.html)API müssen Sie Folgendes angeben:
+ **Mandanten-ID** — Geben Sie die Azure Active Directory-Domäne der Organisation an.
+ **OneDrive Benutzer** — Geben Sie die Liste der Benutzerkonten an, deren Dokumente indexiert werden sollen.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr OneDrive Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"username": "OAuth client ID",
"password": "client secret"
}
```
+ **IAM role** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen öffentlichen Daten APIs für den OneDrive Connector und Amazon Kendra zu erteilen. Weitere Informationen finden Sie unter [IAM Rollen für OneDrive Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob bestimmte Dokumente ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre OneDrive Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
+ **Benutzerkontextfilterung und Zugriffskontrolle**Amazon Kendra — durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
------
# OneDrive Microsoft-Anschluss V2.0
Microsoft OneDrive ist ein Cloud-basierter Speicherdienst, mit dem Sie Ihre Inhalte speichern, teilen und hosten können. Sie können Amazon Kendra es verwenden, um Ihre OneDrive Datenquelle zu indizieren.
Sie können über Amazon Kendra die [Amazon Kendra Konsole](https://console.aws.amazon.com/kendra/) und die [OneDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/OneDriveConfiguration.html)API eine Verbindung zu Ihrer OneDrive Datenquelle herstellen.
**Anmerkung**
Die Support für OneDrive Connector V1.0/ OneDriveConfiguration API wird voraussichtlich im Juni 2023 eingestellt. Wir empfehlen die Verwendung von OneDrive Connector V2.0/ TemplateConfiguration API. Version 2.0 bietet zusätzliche Funktionen ACLs und Identity-Crawler-Funktionen.
Informationen zur Problembehandlung Ihres Amazon Kendra OneDrive Datenquellen-Connectors finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-v2-onedrive)
+ [
## Voraussetzungen
](#prerequisites-v2-onedrive)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-v2-onedrive)
## Unterstützte Features
Amazon Kendra OneDrive Ein Datenquellenconnector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre OneDrive Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren Konten OneDrive und AWS Konten vor.
**Stellen Sie sicher OneDrive, dass Sie Folgendes haben:**
+ Hat ein OneDrive Konto in Office 365 erstellt.
+ Haben Sie Ihre Microsoft 365-Mandanten-ID notiert. Sie finden Ihre Mandanten-ID in den Eigenschaften Ihres Azure Active Directory-Portals oder in Ihrer OAuth Anwendung.
+ Sie haben eine OAuth Anwendung im Azure-Portal erstellt und die Client-ID und das Client-Geheimnis oder die Client-Anmeldeinformationen, die für die Authentifizierung mit einem AWS Secrets Manager Geheimnis verwendet wurden, notiert. Weitere Informationen finden Sie im [Microsoft-Tutorial](https://learn.microsoft.com/en-us/power-apps/developer/data-platform/walkthrough-register-app-azure-active-directory) und im [Beispiel für registrierte Apps](https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application).
**Anmerkung**
Wenn Sie eine App im Azure-Portal erstellen oder registrieren, stellt die geheime ID den tatsächlichen geheimen Wert dar. Sie müssen den tatsächlichen geheimen Wert sofort bei der Erstellung des Geheimnisses und der App notieren oder speichern. Sie können auf Ihr Geheimnis zugreifen, indem Sie den Namen Ihrer Anwendung im Azure-Portal auswählen und dann zur Menüoption für Zertifikate und Geheimnisse navigieren.
Sie können auf Ihre Client-ID zugreifen, indem Sie den Namen Ihrer Anwendung im Azure-Portal auswählen und dann zur Übersichtsseite navigieren. Die Anwendungs-ID (Client) ist die Client-ID.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ Sie haben die AD-Anwendungs-ID verwendet, um einen geheimen Schlüssel für die Anwendung auf der AD-Website zu registrieren. Der geheime Schlüssel muss die Anwendungs-ID und einen geheimen Schlüssel enthalten.
+ Sie haben die AD-Domain der Organisation kopiert.
+ Ihrer AD-Anwendung wurden die folgenden Berechtigungen für die Microsoft Graph-Option hinzugefügt:
+ Dateien in allen Websitesammlungen lesen (File.Read.All)
+ Lesen Sie die vollständigen Profile aller Benutzer (User.Read.All)
+ Alle Gruppen lesen (Group.Read.All)
+ Alle Notizen lesen (Notes.Read.All)
+ Die Liste der Benutzer wurde kopiert, deren Dokumente indexiert werden müssen. Sie können wählen, ob Sie eine Liste mit Benutzernamen angeben möchten, oder Sie können die Benutzernamen in einer Datei angeben, die in einer gespeichert ist Amazon S3. Nachdem Sie die Datenquelle erstellt haben, können Sie:
+ Die Benutzerliste ändern.
+ Wechseln Sie von einer Benutzerliste zu einer Liste, die in einem Amazon S3 Bucket gespeichert ist.
+ Ändern Sie den Amazon S3 Bucket-Speicherort einer Benutzerliste. Wenn Sie den Bucket-Speicherort ändern, müssen Sie auch die IAM Rolle für die Datenquelle aktualisieren, damit sie Zugriff auf den Bucket hat.
**Anmerkung**
Wenn Sie die Liste der Benutzernamen in einem Amazon S3 Bucket speichern, muss die IAM Richtlinie für die Datenquelle den Zugriff auf den Bucket und gegebenenfalls den Zugriff auf den Schlüssel ermöglichen, mit dem der Bucket verschlüsselt wurde.
Der OneDrive Connector verwendet **E-Mail von Kontaktinformationen**, die in den **OneDrive-Benutzereigenschaften** vorhanden sind. Stellen Sie sicher, dass für den Benutzer, dessen Daten Sie crawlen möchten, das E-Mail-Feld auf der Seite **mit den Kontaktinformationen** konfiguriert ist, da es für neue Benutzer möglicherweise leer ist.
**Stellen Sie sicher, dass Sie in Ihrem AWS Konto Folgendes haben:**
+ Hat einen Amazon Kendra Index erstellt und bei Verwendung der API die Index-ID notiert.
+ Sie haben eine IAM Rolle für Ihre Datenquelle erstellt und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
+ Wir haben Ihre OneDrive Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre OneDrive Datenquelle mit verbinden Amazon Kendra. Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer OneDrive Datenquelle herzustellen, müssen Sie Details zu Ihren OneDrive Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben Amazon Kendra, finden Sie OneDrive weitere Informationen unter[Voraussetzungen](#prerequisites-v2-onedrive).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen OneDrive**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon Kendra Konsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **OneDrive Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **OneDrive Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **OneDrive Mandanten-ID** — Geben Sie die OneDrive Mandanten-ID ohne das Protokoll ein.
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. Bei der **Authentifizierung** — Wählen Sie zwischen „**Neu**“ und „**Bestehend**“.
1.
1. Wenn Sie **Vorhanden** auswählen, wählen Sie unter **Secret auswählen** ein vorhandenes Secret aus.
1. Wenn Sie „**Neu**“ wählen, geben Sie die folgenden Informationen in den Bereich „**Neues AWS Secrets Manager Geheimnis**“ ein:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra- OneDrive -' wird Ihrem geheimen Namen automatisch hinzugefügt.
1. Für **Client ID** und **Client Secret** — Geben Sie die Client-ID und den geheimen Client-Schlüssel ein.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
1. **IAM Rolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAM Rollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1.
1. Für den **Synchronisierungsbereich** — Wählen Sie aus, welche OneDrive Benutzerdaten indexiert werden sollen. Sie können maximal 10 Benutzer manuell hinzufügen.
1. Für **zusätzliche Konfigurationen** — Fügen Sie Muster für reguläre Ausdrücke hinzu, um bestimmte Inhalte ein- oder auszuschließen. Sie können bis zu 100 Muster hinzufügen.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Frequenz** aus, wie oft der Inhalt Ihrer Datenquelle synchronisiert und der Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Standard-Datenquellenfelder** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen OneDrive**
Sie müssen mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API einen JSON-Wert des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-onedrive-schema) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `ONEDRIVEV2` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Mandanten-ID** — Geben Sie die Microsoft 365-Mandanten-ID an. Sie finden Ihre Mandanten-ID in den Eigenschaften Ihres Azure Active Directory-Portals oder in Ihrer OAuth Anwendung.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem OneDrive Konto erstellt haben.
Wenn Sie die OAuth 2.0-Authentifizierung verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"clientId": "client ID",
"clientSecret": "client secret"
}
```
+ **IAM role** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen öffentlichen Daten APIs für den OneDrive Connector und Amazon Kendra zu erteilen. Weitere Informationen finden Sie unter [IAM Rollen für OneDrive Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Sie können angeben, ob bestimmte Dateien, OneNote Abschnitte und Seiten ein- oder ausgeschlossen werden sollen. OneNote
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
+ **Feldzuordnungen** — Sie können dem Connector nur integrierte oder allgemeine Indexfelder zuordnen. Amazon Kendra OneDrive Die Zuordnung benutzerdefinierter Felder ist für den OneDrive Connector aufgrund von API-Einschränkungen nicht verfügbar. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [OneDrive Vorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-onedrive-schema).
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer OneDrive Datenquelle finden Sie unter:
+ [Ankündigung des aktualisierten OneDrive Microsoft-Connectors (V2) für Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/announcing-the-updated-microsoft-onedrive-connector-v2-for-amazon-kendra/).
## Hinweise
+ Wenn Zugriffskontrolllisten (ACLs) aktiviert sind, ist die Option „Nur neue oder geänderte Inhalte synchronisieren“ aufgrund von OneDrive API-Einschränkungen nicht verfügbar. Wir empfehlen, stattdessen die Modi „Vollständige Synchronisierung“ oder „Neue, geänderte oder gelöschte Inhalte“ zu verwenden oder sie zu deaktivieren, ACLs falls Sie diesen Synchronisierungsmodus verwenden müssen.
# Microsoft SharePoint
SharePoint ist ein Dienst zur gemeinsamen Erstellung von Websites, mit dem Sie Webinhalte anpassen und Seiten, Websites, Dokumentbibliotheken und Listen erstellen können. Sie können Amazon Kendra es verwenden, um Ihre SharePoint Datenquelle zu indizieren.
Amazon Kendra unterstützt derzeit SharePoint Online und SharePoint Server (Versionen 2013, 2016, 2019 und Subscription Edition).
Sie können entweder über Amazon Kendra die [Amazon Kendra Konsole](https://console.aws.amazon.com/kendra/), die API oder die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer SharePoint Datenquelle herstellen. [SharePointConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SharePointConfiguration.html)
Amazon Kendra hat zwei Versionen des SharePoint Connectors. Zu den unterstützten Funktionen jeder Version gehören:
**SharePoint Konnektor V1.0/ API [SharePointConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SharePointConfiguration.html)**
+ Feldzuordnungen
+ Kontrolle des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Änderungsprotokoll
+ Virtual Private Cloud (VPC)
**SharePoint Konnektor V2.0/API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)**
+ Feldzuordnungen
+ Kontrolle des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
**Anmerkung**
SharePoint Connector V1.0/ SharePointConfiguration API endete 2023. Wir empfehlen, zu SharePoint Connector V2.0/ API zu migrieren oder diesen zu verwenden. TemplateConfiguration
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra SharePoint Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
# SharePoint Konnektor V1.0
](data-source-v1-sharepoint.md)
+ [
# SharePoint Anschluss V2.0
](data-source-v2-sharepoint.md)
# SharePoint Konnektor V1.0
SharePoint ist ein Dienst zur gemeinsamen Erstellung von Websites, mit dem Sie Webinhalte anpassen und Seiten, Websites, Dokumentbibliotheken und Listen erstellen können. Wenn Sie ein SharePoint Benutzer sind, können Amazon Kendra Sie Ihre SharePoint Datenquelle indizieren.
**Anmerkung**
SharePoint Connector V1.0/ SharePointConfiguration API endete 2023. Wir empfehlen, zu SharePoint Connector V2.0/ API zu migrieren oder diesen zu verwenden. TemplateConfiguration
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra SharePoint Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-v1-sharepoint)
+ [
## Voraussetzungen
](#prerequisites-v1-sharepoint)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-v1-sharepoint)
+ [
## Weitere Informationen
](#sharepoint-v1-learn-more)
## Unterstützte Features
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Änderungsprotokoll
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre SharePoint Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren AWS Konten SharePoint und Konten vor.
Sie müssen Anmeldeinformationen angeben, die Sie sicher AWS Secrets Manager geheim speichern.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
**Stellen Sie sicher SharePoint, dass Sie über Folgendes verfügen:**
+ Notiert die URL der SharePoint Websites, die Sie indexieren möchten.
+ **Für SharePoint Online:**
+ Haben Sie Ihre Basisauthentifizierungsdaten notiert, die einen Benutzernamen und ein Passwort mit Administratorberechtigungen für die Website enthalten.
+ **Optional:** Generierte OAuth 2.0-Anmeldeinformationen, die einen Benutzernamen, ein Passwort, eine Client-ID und einen geheimen Client-Schlüssel enthalten.
+ Sie haben **Sicherheitsstandards** in Ihrem Azure-Portal mit einem Administratorbenutzer deaktiviert. Weitere Informationen zur Verwaltung von Sicherheitsstandardeinstellungen im Azure-Portal finden Sie in der [Microsoft-Dokumentation zur Vorgehensweise bei enable/disable Sicherheitsstandards](https://learn.microsoft.com/en-us/microsoft-365/business-premium/m365bp-conditional-access?view=o365-worldwide&tabs=secdefaults#security-defaults-1).
+ **Für SharePoint Server:**
+ Notiert Ihren SharePoint Serverdomänennamen (den NetBIOS-Namen in Ihrem Active Directory). Sie verwenden diesen zusammen mit Ihrem Benutzernamen und Passwort für die SharePoint Standardauthentifizierung, um eine Verbindung zum SharePoint Amazon Kendra Server herzustellen.
**Anmerkung**
Wenn Sie SharePoint Server verwenden und Ihre Access Control List (ACL) in das E-Mail-Format konvertieren müssen, um nach Benutzerkontext zu filtern, geben Sie die URL des LDAP-Servers und die LDAP-Suchbasis an. Oder Sie können die Verzeichnisdomänenüberschreibung verwenden. Die URL des LDAP-Servers ist der vollständige Domainname und die Portnummer (z. B. ldap: //example.com:389). Die LDAP-Suchbasis sind die Domänencontroller „example“ und „com“. Mit der Überschreibung der Verzeichnisdomäne können Sie die E-Mail-Domäne verwenden, anstatt die LDAP-Server-URL und die LDAP-Suchbasis zu verwenden. Die E-Mail-Domain für username@example.com lautet beispielsweise „example.com“. Sie können diese Überschreibung verwenden, wenn Sie sich keine Gedanken über die Validierung Ihrer Domain machen und einfach Ihre E-Mail-Domain verwenden möchten.
+ Ihrem SharePoint Konto wurden die folgenden Berechtigungen hinzugefügt:
**Für SharePoint Listen**
+ Elemente öffnen — Zeigt die Quelle von Dokumenten mit serverseitigen Dateihandlern an.
+ Anwendungsseiten anzeigen — Formulare, Ansichten und Anwendungsseiten anzeigen. Listen auflisten.
+ Elemente anzeigen — Zeigt Elemente in Listen und Dokumente in Dokumentbibliotheken an.
+ Versionen anzeigen — Frühere Versionen eines Listenelements oder Dokuments anzeigen.
** SharePoint Für Websites**
+ Verzeichnisse durchsuchen — Listet Dateien und Ordner auf einer Website mithilfe von SharePoint Designer und der Web-DAV-Schnittstelle auf.
+ Benutzerinformationen durchsuchen — Zeigt Informationen über Benutzer der Website an.
+ Berechtigungen auflisten — Zählt die Berechtigungen für die Website, die Liste, den Ordner, das Dokument oder das Listenelement auf.
+ Öffnen — Öffnet eine Website, eine Liste oder einen Ordner, um auf Elemente innerhalb des Containers zuzugreifen.
+ Client-Integrationsfunktionen verwenden — Verwenden Sie SOAP, WebDAV, das Client-Objektmodell oder SharePoint Designer-Schnittstellen, um auf die Website zuzugreifen.
+ Remote-Schnittstellen verwenden — Verwenden Sie Funktionen, mit denen Client-Anwendungen gestartet werden.
+ Seiten anzeigen — Seiten auf einer Website anzeigen.
+ Vergewissert, dass jedes Dokument in SharePoint und zwischen anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicher AWS-Konto, dass Sie:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Ihre SharePoint Authentifizierungsdaten wurden AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre SharePoint Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer SharePoint Datenquelle herzustellen, müssen Sie Details zu Ihren SharePoint Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben, Amazon Kendra sehen Sie SharePoint nach[Voraussetzungen](#prerequisites-v1-sharepoint).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen SharePoint**
1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die [Amazon Kendra Konsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **SharePoint Connector v1.0** und dann **Datenquelle hinzufügen** aus.
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. Als **Hosting-Methode** — Wählen Sie zwischen **SharePoint Online** und **SharePointServer**.
1. Für **SharePointOnline** — Geben Sie die **Site ein, die für Ihr URLs SharePoint Repository spezifisch** ist.
1. Für **SharePointServer** — Wählen Sie Ihre **SharePoint Version**, geben Sie **Site URLs specific for your SharePoint repository** und den Amazon S3 Pfad zum Speicherort Ihres **SSL-Zertifikats** ein.
1. (Nur SharePoint Server) Für **Web-Proxy** — Geben Sie den **Hostnamen** und die **Portnummer** Ihrer internen SharePoint Instanz ein. Die Portnummer sollte ein numerischer Wert zwischen 0 und 65535 sein.
1. Für die **Authentifizierung** — Wählen Sie je nach Anwendungsfall zwischen den folgenden Optionen:
1. **Für SharePoint Online — Wählen Sie zwischen **Standardauthentifizierung und 2.0-Authentifizierung**. OAuth **
1. ****Für SharePoint Server — Wählen Sie zwischen **Keine, LDAP und Manuell**.****
1. Für **AWS Secrets Manager geheim** — Wählen Sie ein vorhandenes Geheimnis oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Authentifizierungsdaten zu speichern. SharePoint Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet. Sie müssen einen **geheimen Namen** eingeben. Das Präfix 'AmazonKendra- SharePoint -' wird Ihrem geheimen Namen automatisch hinzugefügt.
1. Geben Sie die folgenden weiteren Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. Wählen Sie je nach Anwendungsfall aus den folgenden SharePoint Cloud-Authentifizierungsoptionen:
1. **Standardauthentifizierung** — Geben Sie Ihren SharePoint Kontonutzernamen als **Benutzername** und das SharePoint Kontopasswort als **Passwort ein**.
1. **OAuth 2.0-Authentifizierung** — Geben Sie Ihren SharePoint Kontonutzernamen als **Benutzername**, das SharePoint Kontopasswort als **Passwort**, Ihre automatisch generierte eindeutige SharePoint ID als **Client-ID** und die gemeinsame geheime Zeichenfolge ein, die von beiden verwendet wird, SharePoint und Amazon Kendra als **Kundengeheimnis**.
1. Wählen Sie je nach Anwendungsfall aus den folgenden Optionen für die SharePoint Serverauthentifizierung:
1. **Keine** — Geben Sie Ihren SharePoint Kontonutzernamen als **Benutzername**, Ihr SharePoint Kontopasswort als **Passwort** und Ihren **Serverdomänennamen** ein.
1. **LDAP** — Geben Sie Ihren SharePoint Kontonutzernamen als **Benutzername**, das SharePoint Kontopasswort als **Passwort**, Ihren **LDAP-Serverendpunkt** (einschließlich Protokoll- und Portnummer zum Beispiel*ldap://example.com:389*) und Ihre **LDAP-Suchbasis** (z. B.) ein. *dc=example, dc=com*
1. **Manuell** — Geben Sie Ihren SharePoint Kontonutzernamen als **Benutzername**, Ihr SharePoint Kontopasswort als **Passwort** und Ihre **E-Mail-Domain Override (E-Mail-Domäne** des Verzeichnisbenutzers oder der Gruppe) ein.
1. Wählen Sie **Speichern**.
1. **Virtual Private Cloud (VPC)** — Sie müssen auch **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
**Anmerkung**
Sie müssen eine VPC verwenden, wenn Sie SharePoint Server verwenden. Amazon VPC ist für andere SharePoint Versionen optional.
1. **IAM Rolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAM Rollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. **Änderungsprotokoll verwenden** — Wählen Sie diese Option, um Ihren Index zu aktualisieren, anstatt alle Ihre Dateien zu synchronisieren.
1. **Anlagen crawlen — Wählen Sie diese Option, um Anlagen** zu crawlen.
1. **Lokale Gruppenzuordnungen verwenden** — Wählen Sie diese Option, um sicherzustellen, dass Dokumente ordnungsgemäß gefiltert werden.
1. **Zusätzliche Konfiguration** — Fügen Sie Muster für reguläre Ausdrücke hinzu, um bestimmte Dateien ein- oder auszuschließen. Sie können bis zu 100 Muster hinzufügen.
1. **Zeitplan für die Synchronisierungsausführung** für die **Frequenz** — Wie oft Amazon Kendra wird die Synchronisierung mit Ihrer Datenquelle durchgeführt?
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Amazon Kendra Standard-Feldzuordnungen** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
1. Für **benutzerdefinierte Feldzuordnungen** — Fügen Sie benutzerdefinierte Datenquellenfelder hinzu, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann Datenquelle **hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen SharePoint**
Mithilfe der [SharePointConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SharePointConfiguration.html)API müssen Sie Folgendes angeben:
+ **SharePointVersion** — Geben Sie die SharePoint Version an, die Sie bei der Konfiguration SharePoint verwenden. Dies ist unabhängig davon der Fall, ob Sie SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 oder SharePoint Online verwenden.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem SharePoint Konto erstellt haben. Das Geheimnis wird in einer JSON-Struktur gespeichert.
Für die **Standardauthentifizierung im SharePoint Internet** muss mindestens die folgende JSON-Struktur in Ihrem Secret enthalten sein:
```
{
"userName": "user name",
"password": "password"
}
```
Für die **SharePoint Online OAuth 2.0-Authentifizierung** muss die folgende JSON-Mindeststruktur in Ihrem Secret enthalten sein:
```
{
"userName": "SharePoint account user name"",
"password": "SharePoint account password",
"clientId": "SharePoint auto-generated unique client id",
"clientSecret": "secret string shared by Amazon Kendra and SharePoint to authorize communications"
}
```
Für die **SharePoint Server-Basisauthentifizierung** ist die folgende Mindest-JSON-Struktur in Ihrem Secret enthalten:
```
{
"userName": "user name",
"password": "password",
"domain": "server domain name"
}
```
Für die **SharePoint Server-LDAP-Authentifizierung** (wenn Sie Ihre Zugriffskontrollliste (ACL) in das E-Mail-Format konvertieren müssen, um nach Benutzerkontext zu filtern, können Sie die LDAP-Server-URL und die LDAP-Suchbasis in Ihr Geheimnis aufnehmen) ist die folgende JSON-Mindeststruktur, die in Ihrem Geheimnis enthalten sein muss:
```
{
"userName": "user name",
"password": "password",
"domain": "server domain name"
"ldapServerUrl": "ldap://example.com:389",
"ldapSearchBase": "dc=example,dc=com"
}
```
Für die **manuelle SharePoint Serverauthentifizierung** muss die folgende JSON-Struktur mindestens in Ihrem Secret enthalten sein:
```
{
"userName": "user name",
"password": "password",
"domain": "server domain name",
"emailDomainOverride": "example.com"
}
```
+ **IAM role** — Geben Sie an`RoleArn`, wann Sie aufrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Secret und für das Aufrufen der erforderlichen öffentlichen Daten APIs für den SharePoint Connector und Amazon Kendra zu erteilen. Weitere Informationen finden Sie unter [IAM Rollen für SharePoint Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
+ **Amazon VPC**— Wenn Sie SharePoint Server verwenden, geben Sie dies im `VpcConfiguration` Rahmen der Datenquellenkonfiguration an. Siehe [Konfiguration Amazon Kendra für die Verwendung einer VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Webproxy** — Gibt an, ob Sie URLs über einen Webproxy eine Verbindung zu Ihrer SharePoint Site herstellen möchten. Sie können diese Option nur für SharePoint Server verwenden.
+ **Indizierung von Listen** — Gibt an, ob Amazon Kendra der Inhalt von Anlagen zu SharePoint Listenelementen indexiert werden soll.
+ **Änderungsprotokoll** — Gibt an, ob der Mechanismus für das Änderungsprotokoll der SharePoint Datenquelle verwendet werden Amazon Kendra soll, um zu ermitteln, ob ein Dokument im Index aktualisiert werden muss.
**Anmerkung**
Verwenden Sie das Änderungsprotokoll, wenn Sie nicht alle Dokumente scannen Amazon Kendra möchten. Wenn Ihr Änderungsprotokoll umfangreich ist, nimmt das Scannen der Dokumente in der SharePoint Datenquelle möglicherweise Amazon Kendra weniger Zeit in Anspruch als das Verarbeiten des Änderungsprotokolls. Wenn Sie Ihre SharePoint Datenquelle zum ersten Mal mit Ihrem Index synchronisieren, werden alle Dokumente gescannt.
+ **Inklusions- und Ausschlussfilter** — Sie können angeben, ob bestimmte Inhalte ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Feldzuordnungen — Ordnen** Sie Ihre SharePoint Datenquellenfelder Ihren Indexfeldern zu. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
+ **Benutzerkontextfilterung und Zugriffskontrolle**Amazon Kendra — durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer SharePoint Datenquelle finden Sie unter:
+ [Erste Schritte mit dem Amazon Kendra SharePoint Online-Connector](https://aws.amazon.com/blogs/machine-learning/getting-started-with-the-amazon-kendra-sharepoint-online-connector/)
# SharePoint Anschluss V2.0
SharePoint ist ein Dienst zur gemeinsamen Erstellung von Websites, mit dem Sie Webinhalte anpassen und Seiten, Websites, Dokumentbibliotheken und Listen erstellen können. Sie können Amazon Kendra es verwenden, um Ihre SharePoint Datenquelle zu indizieren.
Amazon Kendra unterstützt derzeit SharePoint Online und SharePoint Server (2013, 2016, 2019 und Subscription Edition).
**Anmerkung**
SharePoint Connector V1.0/ SharePointConfiguration API endete 2023. Wir empfehlen, zu SharePoint Connector V2.0/ API zu migrieren oder diesen zu verwenden. TemplateConfiguration
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra SharePoint Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-v2-sharepoint)
+ [
## Voraussetzungen
](#prerequisites-v2-sharepoint)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-v2-sharepoint)
+ [
## Hinweise
](#sharepoint-notes)
## Unterstützte Features
Amazon Kendra SharePoint Ein Datenquellenconnector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre SharePoint Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren Konten SharePoint und AWS Konten vor.
Sie müssen Anmeldeinformationen angeben, die Sie sicher AWS Secrets Manager geheim speichern.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
**Stellen Sie unter SharePoint Online sicher, dass Sie über Folgendes verfügen:**
+ Ihre SharePoint Instanz wurde kopiert URLs. Das Format für die Host-URL, die Sie eingeben, ist*https://yourdomain.com/sites/mysite*. Ihre URL muss mit beginnen`https`.
+ Der Domainname Ihrer SharePoint Instanz-URL wurde kopiert.
+ Sie haben Ihre grundlegenden Authentifizierungsdaten notiert, die den Benutzernamen und das Passwort mit Administratorberechtigungen für die Verbindung mit SharePoint Online enthalten.
+ Sie haben **Sicherheitsstandards** in Ihrem Azure-Portal mit einem Administratorbenutzer deaktiviert. Weitere Informationen zur Verwaltung von Sicherheitsstandardeinstellungen im Azure-Portal finden Sie in der [Microsoft-Dokumentation zur Vorgehensweise bei enable/disable Sicherheitsstandards](https://learn.microsoft.com/en-us/microsoft-365/business-premium/m365bp-conditional-access?view=o365-worldwide&tabs=secdefaults#security-defaults-1).
+ Die Multi-Faktor-Authentifizierung (MFA) wurde in Ihrem SharePoint Konto deaktiviert, sodass das Crawlen Ihrer Inhalte nicht blockiert Amazon Kendra wird. SharePoint
+ **Wenn Sie einen anderen Authentifizierungstyp als die Standardauthentifizierung verwenden:** Die Mandanten-ID Ihrer Instanz wurde kopiert. SharePoint Einzelheiten zum Ermitteln Ihrer Mandanten-ID finden Sie unter [Finden Sie Ihre Microsoft 365-Mandanten-ID](https://learn.microsoft.com/en-us/sharepoint/find-your-office-365-tenant-id).
+ Wenn Sie zur Cloud-Benutzerauthentifizierung mit Microsoft Entra migrieren müssen, lesen Sie die [Microsoft-Dokumentation zur Cloud-Authentifizierung](https://learn.microsoft.com/en-us/entra/identity/hybrid/connect/migrate-from-federation-to-cloud-authentication).
+ **Für die OAuth 2.0-Authentifizierung und die OAuth 2.0-Aktualisierungstokenauthentifizierung:** Notieren Sie sich Ihre Anmeldeinformationen für die **Standardauthentifizierung**, die den Benutzernamen und das Passwort enthalten, mit denen Sie eine Verbindung zu SharePoint Online herstellen, sowie die Client-ID und das Client-Geheimnis, die nach der Registrierung SharePoint bei Azure AD generiert wurden.
+ **Wenn Sie ACL nicht verwenden**, wurden die folgenden Berechtigungen hinzugefügt:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/data-source-v2-sharepoint.html)
**Anmerkung**
Note.Read.All und Sites.Read.All sind nur erforderlich, wenn Sie Dokumente crawlen möchten. OneNote
Wenn Sie bestimmte Websites crawlen möchten, kann die Berechtigung auf bestimmte Websites und nicht auf alle in der Domäne verfügbaren Websites beschränkt werden. Sie konfigurieren die Berechtigung **Sites.Selected (Anwendung)**. Mit dieser API-Berechtigung müssen Sie die Zugriffsberechtigung für jede Site explizit über die Microsoft Graph-API festlegen. Weitere Informationen finden Sie im [Microsoft-Blog zu Sites.Selected-Berechtigungen](https://techcommunity.microsoft.com/t5/microsoft-sharepoint-blog/develop-applications-that-use-sites-selected-permissions-for-spo/ba-p/3790476).
+ **Wenn Sie ACL verwenden**, wurden die folgenden Berechtigungen hinzugefügt:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/data-source-v2-sharepoint.html)
**Anmerkung**
GroupMember**.Read.All und User.Read.All sind nur erforderlich, wenn Identity Crawler aktiviert ist.**
Wenn Sie bestimmte Websites crawlen möchten, kann die Berechtigung auf bestimmte Websites und nicht auf alle in der Domäne verfügbaren Websites beschränkt werden. Sie konfigurieren die Berechtigung **Sites.Selected (Anwendung)**. Mit dieser API-Berechtigung müssen Sie die Zugriffsberechtigung für jede Site explizit über die Microsoft Graph-API festlegen. Weitere Informationen finden Sie im [Microsoft-Blog zu Sites.Selected-Berechtigungen](https://techcommunity.microsoft.com/t5/microsoft-sharepoint-blog/develop-applications-that-use-sites-selected-permissions-for-spo/ba-p/3790476).
+ **Für die reine Azure AD-Authentifizierung:** Privater Schlüssel und die Client-ID, die Sie nach der Registrierung SharePoint bei Azure AD generiert haben. Beachten Sie auch das X.509-Zertifikat.
+ **Wenn Sie ACL nicht verwenden**, wurden die folgenden Berechtigungen hinzugefügt:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/data-source-v2-sharepoint.html)
**Anmerkung**
Wenn Sie bestimmte Websites crawlen möchten, kann die Berechtigung auf bestimmte Websites und nicht auf alle in der Domäne verfügbaren Websites beschränkt werden. Sie konfigurieren die Berechtigung **Sites.Selected (Anwendung)**. Mit dieser API-Berechtigung müssen Sie die Zugriffsberechtigung für jede Site explizit über die Microsoft Graph-API festlegen. Weitere Informationen finden Sie im [Microsoft-Blog zu Sites.Selected-Berechtigungen](https://techcommunity.microsoft.com/t5/microsoft-sharepoint-blog/develop-applications-that-use-sites-selected-permissions-for-spo/ba-p/3790476).
+ **Wenn Sie ACL verwenden**, wurden die folgenden Berechtigungen hinzugefügt:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/data-source-v2-sharepoint.html)
**Anmerkung**
Wenn Sie bestimmte Websites crawlen möchten, kann die Berechtigung auf bestimmte Websites und nicht auf alle in der Domäne verfügbaren Websites beschränkt werden. Sie konfigurieren die Berechtigung **Sites.Selected (Anwendung)**. Mit dieser API-Berechtigung müssen Sie die Zugriffsberechtigung für jede Site explizit über die Microsoft Graph-API festlegen. Weitere Informationen finden Sie im [Microsoft-Blog zu Sites.Selected-Berechtigungen](https://techcommunity.microsoft.com/t5/microsoft-sharepoint-blog/develop-applications-that-use-sites-selected-permissions-for-spo/ba-p/3790476).
+ **Für SharePoint reine App-Authentifizierung:** Notiert Ihre SharePoint Client-ID und Ihren geheimen Client-Schlüssel, die bei der Erteilung der Genehmigung für SharePoint App Only generiert wurden, sowie Ihre Client-ID und Ihren geheimen Client-Schlüssel, die bei der Registrierung Ihrer SharePoint App bei Azure AD generiert wurden.
**Anmerkung**
SharePoint Die reine App-Authentifizierung wird für die Version 2013 *nicht* unterstützt. SharePoint
+ **(Optional) Wenn Sie OneNote Dokumente crawlen und **Identity Crawler verwenden, wurden die folgenden**** Berechtigungen hinzugefügt:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/data-source-v2-sharepoint.html)
**Anmerkung**
****Für das Crawlen von Entitäten mithilfe der Standardauthentifizierung und der reinen App-Authentifizierung sind keine API-Berechtigungen erforderlich. SharePoint****
**Stellen Sie unter SharePoint Server sicher, dass Sie über Folgendes verfügen:**
+ Ihre SharePoint Instanz URLs und den Domainnamen von Ihnen kopiert SharePoint URLs. Das Format für die von Ihnen eingegebene Host-URL ist*https://yourcompany/sites/mysite*. Ihre URL muss mit beginnen`https`.
**Anmerkung**
(On-Premise/Server) Amazon Kendra prüft, ob die AWS Secrets Manager darin enthaltenen Endpunktinformationen mit den Endpunktinformationen übereinstimmen, die in den Konfigurationsdetails Ihrer Datenquelle angegeben sind. Dies trägt zum Schutz vor dem [Problem des verwirrten Stellvertreters](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html) bei, bei dem es sich um ein Sicherheitsproblem handelt, bei dem ein Benutzer nicht berechtigt ist, eine Aktion auszuführen, sondern ihn Amazon Kendra als Proxy verwendet, um auf das konfigurierte Geheimnis zuzugreifen und die Aktion auszuführen. Wenn Sie Ihre Endpunktinformationen später ändern, müssen Sie ein neues Geheimnis erstellen, um diese Informationen zu synchronisieren.
+ Die Multi-Faktor-Authentifizierung (MFA) wurde in Ihrem SharePoint Konto deaktiviert, sodass das Crawlen Ihrer Inhalte nicht blockiert Amazon Kendra wird. SharePoint
+ Wenn Sie die reine **SharePoint App-Authentifizierung** für die Zugriffskontrolle verwenden:
+ Die SharePoint Client-ID wurde kopiert, die bei der Registrierung von App Only auf Site-Ebene generiert wurde. Das Client-ID-Format ist ClientId @TenantId. Beispiel, *ffa956f3-8f89-44e7-b0e4-49670756342c@888d0b57-69f1-4fb8-957f-e1f0bedf82fe*.
+ Der geheime SharePoint Client-Schlüssel, der bei der Registrierung von App Only auf Site-Ebene generiert wurde, wurde kopiert.
**Hinweis:** Da Client IDs - und Client-Schlüssel nur für einzelne Sites generiert werden, wenn Sie den SharePoint Server für die Only-App-Authentifizierung registrieren, wird nur eine Site-URL für die SharePoint Only-App-Authentifizierung unterstützt.
**Anmerkung**
SharePoint Die reine App-Authentifizierung wird für die Version SharePoint 2013 *nicht* unterstützt.
+ Wenn Sie **eine E-Mail-ID mit benutzerdefinierter Domain** für die Zugriffskontrolle verwenden:
+ Haben Sie den Wert Ihrer benutzerdefinierten E-Mail-Domain notiert — zum Beispiel: "“. *amazon.com*
+ Wenn Sie **eine E-Mail-ID mit Domain aus der IDP-Autorisierung** verwenden, haben Sie Folgendes kopiert:
+ LDAP-Serverendpunkt (Endpunkt des LDAP-Servers einschließlich Protokoll und Portnummer). Beispiel: *ldap://example.com:389*.
+ LDAP-Suchbasis (Suchbasis des LDAP-Benutzers). Beispiel: *CN=Users,DC=sharepoint,DC=com*.
+ LDAP-Benutzername und LDAP-Passwort.
+ Entweder konfigurierte NTLM-Authentifizierungsdaten **oder** konfigurierte Kerberos-Authentifizierungsdaten, die einen Benutzernamen (Kontobenutzername) und ein Passwort (SharePoint Kontokennwort) enthalten. SharePoint
**Stellen Sie sicher AWS-Konto, dass Sie Folgendes in Ihrem haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Ihre SharePoint Authentifizierungsdaten wurden AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre SharePoint Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer SharePoint Datenquelle herzustellen, müssen Sie Details zu Ihren SharePoint Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben, Amazon Kendra sehen Sie SharePoint nach[Voraussetzungen](#prerequisites-v2-sharepoint).
------
#### [ Console: SharePoint Online ]
**Um eine Verbindung Amazon Kendra zu SharePoint Online herzustellen**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon Kendra Konsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **SharePoint Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **SharePoint Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Hosting-Methode** — Wählen Sie **SharePointOnline**.
1. Für **Ihr SharePoint Repository URLs spezifische Site** — Geben Sie den SharePoint Host ein. URLs Das Format für den von URLs Ihnen eingegebenen Host ist*https://yourdomain.sharepoint.com/sites/mysite*. Die URL muss mit dem `https`-Protokoll beginnen. Trennen Sie es URLs mit einer neuen Zeile. Sie können bis zu 100 hinzufügen URLs.
1. **Domain** — Geben Sie die SharePoint Domain ein. Die Domain in der URL *https://yourdomain.sharepoint.com/sites/mysite* lautet *yourdomain* beispielsweise.
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
Sie können auch den Typ der Benutzer-ID auswählen, d. h. den Benutzerprinzipalnamen oder die vom Azure-Portal abgerufene Benutzer-E-Mail. Wenn Sie nichts angeben, wird E-Mail standardmäßig verwendet.
1. **Authentifizierung** — Wählen Sie entweder Standardauthentifizierung, OAuth 2.0, reine Azure AD-Authentifizierung, reine App-Authentifizierung oder SharePoint OAuth 2.0-Aktualisierungstoken-Authentifizierung. Sie wählen entweder ein vorhandenes AWS Secrets Manager Geheimnis aus, um Ihre Authentifizierungsdaten zu speichern, oder erstellen ein Geheimnis.
1. Wenn Sie die **Standardauthentifizierung** verwenden, muss Ihr Geheimnis einen geheimen Namen, einen SharePoint Benutzernamen und ein Passwort enthalten.
1. Wenn Sie die **OAuth 2.0-Authentifizierung** verwenden, muss Ihr Geheimnis die SharePoint Mandanten-ID, den geheimen Namen, den SharePoint Benutzernamen, das Passwort, die bei der Registrierung SharePoint in Azure AD generierte Azure AD-Client-ID und den Azure AD-Client-Schlüssel, der bei der Registrierung SharePoint in Azure AD generiert wurde, enthalten.
1. Wenn Sie die **Azure AD App-Only-Authentifizierung** verwenden, muss Ihr Geheimnis die SharePoint Mandanten-ID, das selbstsignierte Azure AD-X.509-Zertifikat, den geheimen Namen, die bei der Registrierung SharePoint in Azure AD generierte Azure AD-Client-ID und den privaten Schlüssel zur Authentifizierung des Connectors für Azure AD enthalten.
1. Wenn Sie die **SharePointApp-Only-Authentifizierung** verwenden, muss Ihr geheimer Schlüssel die SharePoint Mandanten-ID, den geheimen Namen, die SharePoint Client-ID, die Sie bei der Registrierung von App Only auf Mandantenebene generiert haben, den SharePoint Client-Schlüssel, der bei Ihrer Registrierung für App Only auf Mandantenebene generiert wurde, die Azure AD-Client-ID, die bei der Registrierung SharePoint in Azure AD generiert wurde, und den Azure AD-Client-Schlüssel, der bei der Registrierung SharePoint bei Azure AD generiert wurde, enthalten.
Das SharePoint Client-ID-Format ist. *ClientID@TenantId* Beispiel, *ffa956f3-8f89-44e7-b0e4-49670756342c@888d0b57-69f1-4fb8-957f-e1f0bedf82fe*.
1. Wenn Sie die **OAuth 2.0-Aktualisierungstoken-Authentifizierung** verwenden, muss Ihr geheimer Schlüssel die SharePoint Mandanten-ID, den geheimen Namen, die eindeutige Azure AD-Client-ID, die bei der Registrierung SharePoint in Azure AD generiert wurde, das Azure AD-Client-Geheimnis, das bei der Registrierung SharePoint bei Azure AD generiert wurde, und das für die Verbindung Amazon Kendra generierte Aktualisierungstoken enthalten SharePoint.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
Sie können auch wählen, ob Sie die lokale Gruppenzuweisung oder die Azure Active Directory-Gruppenzuordnung crawlen möchten.
**Anmerkung**
Das Crawling von AD-Gruppenzuordnungen ist nur für OAuth 2.0-, OAuth 2.0-Aktualisierungstoken und reine SharePoint App-Authentifizierung verfügbar.
1. **IAM Rolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAM Rollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Wählen Sie unter **Synchronisierungsbereich** aus den folgenden Optionen aus:
1. **Entitäten auswählen** — Wählen Sie die Entitäten aus, die Sie crawlen möchten. **Sie können wählen, ob **alle** Entitäten oder eine beliebige Kombination von **Dateien**, **Anlagen**, ****Link-Seiten****, **Ereignissen**, **Kommentaren** und Listendaten gecrawlt werden sollen.**
1. In der **zusätzlichen Konfiguration** für **Entity-Regex-Muster**: Fügen Sie reguläre Ausdrucksmuster für **Links**, **Seiten** und **Ereignisse** hinzu, um bestimmte Entitäten einzubeziehen, anstatt alle Ihre Dokumente zu synchronisieren.
1. **Regex-Muster — Fügen Sie Muster** für reguläre Ausdrücke hinzu, um Dateien anhand von **Dateipfad**, Dateiname, **Dateityp**, **OneNote Abschnittsnamen** **und **OneNote Seitennamen** ein- oder auszuschließen, anstatt** all Ihre Dokumente zu synchronisieren. Sie können bis zu 100 hinzufügen.
**Anmerkung**
OneNote Crawling ist nur für OAuth 2.0, OAuth 2.0-Aktualisierungstoken und reine SharePoint App-Authentifizierung verfügbar.
1. Wählen Sie für **den Synchronisierungsmodus** aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle zum ersten Mal mit Amazon Kendra synchronisieren, werden standardmäßig alle Inhalte synchronisiert.
+ **Vollständige Synchronisierung** – Alle Inhalte werden unabhängig vom vorherigen Synchronisierungsstatus synchronisiert.
+ Synchronisieren **neuer oder geänderter Dokumente — Synchronisiert** nur neue oder geänderte Dokumente.
+ Synchronisieren **neuer, geänderter oder gelöschter Dokumente — Synchronisieren** Sie nur neue, geänderte und gelöschte Dokumente.
1. Im **Zeitplan für die Synchronisierungsausführung unter** **Häufigkeit** — Wählen Sie aus, wie oft Ihre Datenquelleninhalte synchronisiert und Ihr Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Standard-Datenquellenfelder** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ Console: SharePoint Server ]
**Um eine Verbindung Amazon Kendra herzustellen SharePoint**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon Kendra Konsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **SharePoint Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **SharePoint Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Hosting-Methode** — Wählen Sie **SharePointServer**.
1. ** SharePointVersion wählen** — Wählen Sie entweder **SharePoint 2013**, **SharePoint 2016**, **SharePoint 2019** und **SharePoint (Abonnement-Edition**).
1. Für **Ihr SharePoint Repository URLs spezifische Site** — Geben Sie den SharePoint Host ein. URLs Das Format für den von URLs Ihnen eingegebenen Host ist*https://yourcompany/sites/mysite*. Die URL muss mit dem `https`-Protokoll beginnen. Trennen Sie es URLs mit einer neuen Zeile. Sie können bis zu 100 hinzufügen URLs.
1. **Domain** — Geben Sie die SharePoint Domain ein. Die Domain in der URL *https://yourcompany/sites/mysite* lautet beispielsweise *yourcompany*
1. **Speicherort des SSL-Zertifikats** — Geben Sie den Amazon S3 Pfad zu Ihrer SSL-Zertifikatsdatei ein.
1. (Optional) Für **Webproxy** — Geben Sie den Hostnamen (ohne `https://` das `http://` OR-Protokoll) und die Portnummer ein, die vom Host-URL-Transportprotokoll verwendet wird. Der numerische Wert für die Portnummer sollte zwischen 0 und 65535 liegen.
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
Für SharePoint Server können Sie aus den folgenden ACL-Optionen wählen:
1. **E-Mail-ID mit Domain von IDP** — Die Benutzer-ID basiert auf E-Mails IDs , deren Domains vom zugrunde liegenden Identity Provider (IDP) abgerufen wurden. **Sie geben die IDP-Verbindungsdetails im Rahmen der Authentifizierung Secrets Manager geheim an.**
1. **E-Mail-ID mit benutzerdefinierter Domain — Die** Benutzer-ID basiert auf dem Wert der benutzerdefinierten E-Mail-Domain. Beispiel, „*amazon.com*“. Die E-Mail-Domain wird verwendet, um die E-Mail-ID für die Zugriffskontrolle zu erstellen. Sie müssen Ihre benutzerdefinierte E-Mail-Domain eingeben.
1. **Domain\$1 User with Domain — Die** Benutzer-ID wird im Format Domain\$1 User ID erstellt. Sie müssen einen gültigen Domänennamen angeben. Zum Beispiel: *"sharepoint2019"* um eine Zugriffskontrolle zu erstellen.
1. Wählen Sie für **Authentifizierung** entweder SharePoint Nur-App-Authentifizierung, NTLM-Authentifizierung oder Kerberos-Authentifizierung. Sie wählen entweder ein vorhandenes AWS Secrets Manager Geheimnis zum Speichern Ihrer Authentifizierungsdaten oder erstellen ein Geheimnis.
1. Wenn Sie die **NTLM-Authentifizierung** oder die **Kerberos-Authentifizierung** verwenden, muss Ihr Geheimnis einen geheimen Namen, einen SharePoint Benutzernamen und ein Passwort enthalten.
Wenn Sie **E-Mail-ID mit Domain von IDP** verwenden, geben Sie auch Folgendes ein:
+ **LDAP-Serverendpunkt — Endpunkt** des LDAP-Servers, einschließlich Protokoll und Portnummer. Beispiel: *ldap://example.com:389*.
+ **LDAP-Suchbasis — Suchbasis des** LDAP-Benutzers. Beispiel: *CN=Users,DC=sharepoint,DC=com*.
+ **LDAP-Benutzername — Ihr LDAP-Benutzername**.
+ **LDAP-Passwort — Ihr LDAP-Passwort**.
1. Wenn Sie die **SharePointreine App-Authentifizierung** verwenden, muss Ihr geheimer Schlüssel einen geheimen Namen, eine SharePoint Client-ID, die Sie bei der Registrierung von App Only auf Site-Ebene generiert haben, und einen geheimen SharePoint Client-Schlüssel, der bei Ihrer Registrierung für App Only auf Site-Ebene generiert wurde, enthalten.
Das SharePoint Client-ID-Format ist. *ClientID@TenantId* Beispiel, *ffa956f3-8f89-44e7-b0e4-49670756342c@888d0b57-69f1-4fb8-957f-e1f0bedf82fe*.
**Hinweis:** Da Client IDs - und Client-Schlüssel nur für einzelne Sites generiert werden, wenn Sie SharePoint Server für die Only-App-Authentifizierung registrieren, wird nur eine Site-URL für die SharePoint Only-App-Authentifizierung unterstützt.
Wenn Sie **E-Mail-ID mit Domain von IDP** verwenden, geben Sie auch Folgendes ein:
+ **LDAP-Serverendpunkt** — Endpunkt des LDAP-Servers, einschließlich Protokoll und Portnummer. Beispiel: *ldap://example.com:389*.
+ **LDAP-Suchbasis — Suchbasis des** LDAP-Benutzers. Beispiel: *CN=Users,DC=sharepoint,DC=com*.
+ **LDAP-Benutzername — Ihr LDAP-Benutzername**.
+ **LDAP-Passwort — Ihr LDAP-Passwort**.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
Sie können auch wählen, ob Sie die lokale Gruppenzuweisung oder die Azure Active Directory-Gruppenzuordnung crawlen möchten.
**Anmerkung**
Das Crawling von AD-Gruppenzuordnungen ist nur für die SharePoint App-Authentifizierung verfügbar.
1. **IAM Rolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAM Rollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Wählen Sie unter **Synchronisierungsbereich** aus den folgenden Optionen aus:
1. **Entitäten auswählen** — Wählen Sie die Entitäten aus, die Sie crawlen möchten. **Sie können wählen, ob **Alle** Entitäten oder eine beliebige Kombination aus **Dateien**, **Anlagen**, ****Link-Seiten****, **Ereignissen** und Listendaten gecrawlt werden sollen.**
1. In der **zusätzlichen Konfiguration** für **Entity-Regex-Muster**: Fügen Sie reguläre Ausdrucksmuster für **Links**, **Seiten** und **Ereignisse** hinzu, um bestimmte Entitäten einzubeziehen, anstatt alle Ihre Dokumente zu synchronisieren.
1. **Regex-Muster — Fügen Sie Muster** für reguläre Ausdrücke hinzu, um Dateien nach **Dateipfad, Dateiname, **Dateityp****, **OneNoteAbschnittsname** **und **OneNoteSeitenname** ein- oder auszuschließen, anstatt** all Ihre Dokumente zu synchronisieren. Sie können bis zu 100 hinzufügen.
**Anmerkung**
OneNote Crawling ist nur für die Authentifizierung nur über SharePoint Apps verfügbar.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie alle Inhalte neu und ersetzen vorhandene Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue und geänderte Inhalte. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Frequenz** aus, wie oft der Inhalt Ihrer Datenquelle synchronisiert und der Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Standard-Datenquellenfelder** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen SharePoint**
Sie müssen mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API einen JSON-Wert des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `SHAREPOINTV2` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Repository-Endpunkt-Metadaten** — Geben Sie das `tenantID` `domain` `siteUrls` Ende Ihrer SharePoint Instanz an.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue und geänderte Inhalte zu indizieren. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
**Anmerkung**
Identity Crawler ist nur verfügbar, wenn Sie auf eingestellt `crawlAcl` haben. `true`
+ **Zusätzliche Eigenschaften des Repositorys** — Geben Sie Folgendes an:
+ (Für Azure AD) `s3bucketName` und `s3certificateName` Sie verwenden, um Ihr selbstsigniertes Azure AD-X.509-Zertifikat zu speichern.
+ Authentifizierungstyp (`auth_Type`), den Sie verwenden, unabhängig davon `OAuth2``OAuth2App`,,`OAuth2Certificate`,`Basic`, `OAuth2_RefreshToken``NTLM`, und. `Kerberos`
+ Version (`version`), die Sie verwenden, ob `Server` oder`Online`. Wenn Sie verwenden, können `Server` Sie das `onPremVersion` als`2013`, `2016``2019`, oder `SubscriptionEdition` weiter spezifizieren.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem SharePoint Konto erstellt haben.
Wenn Sie SharePoint Online verwenden, können Sie zwischen Basic-, OAuth 2.0-, Azure AD App-Only- und SharePoint App-Only-Authentifizierung wählen. Im Folgenden finden Sie die Mindest-JSON-Struktur, die für jede Authentifizierungsoption in Ihrem Geheimnis enthalten sein muss:
+ **Grundlegende Authentifizierung**
```
{
"userName": "SharePoint account user name",
"password": "SharePoint account password"
}
```
+ **OAuth 2.0-Authentifizierung**
```
{
"clientId": "client id generated when registering SharePoint with Azure AD",
"clientSecret": "client secret generated when registering SharePoint with Azure AD",
"userName": "SharePoint account user name",
"password": "SharePoint account password"
}
```
+ **Azure AD-Authentifizierung nur für Apps**
```
{
"clientId": "client id generated when registering SharePoint with Azure AD",
"privateKey": "private key to authorize connection with Azure AD"
}
```
+ **SharePoint Reine App-Authentifizierung**
```
{
"clientId": "client id generated when registering SharePoint for App Only at Tenant Level",
"clientSecret": "client secret generated when registering SharePoint for App Only at Tenant Level",
"adClientId": "client id generated while registering SharePoint with Azure AD",
"adClientSecret": "client secret generated while registering SharePoint with Azure AD"
}
```
+ **OAuth 2.0 Token-Authentifizierung aktualisieren**
```
{
"clientId": "client id generated when registering SharePoint with Azure AD",
"clientSecret": "client secret generated when registering SharePoint with Azure AD",
"refreshToken": "refresh token generated to connect to SharePoint"
}
```
Wenn Sie SharePoint Server verwenden, können Sie zwischen der SharePoint reinen App-Authentifizierung, der NTLM-Authentifizierung und der Kerberos-Authentifizierung wählen. Im Folgenden sind die Mindest-JSON-Strukturen aufgeführt, die für jede Authentifizierungsoption in Ihrem Geheimnis enthalten sein müssen:
+ ** SharePoint Authentifizierung nur über Apps**
```
{
"siteUrlsHash": "Hash representation of SharePoint site URLs",
"clientId": "client id generated when registering SharePoint for App Only at Site Level",
"clientSecret": "client secret generated when registering SharePoint for App Only at Site Level"
}
```
+ ** SharePoint Reine App-Authentifizierung mit Domain aus der IDP-Autorisierung**
```
{
"siteUrlsHash": "Hash representation of SharePoint site URLs",
"clientId": "client id generated when registering SharePoint for App Only at Site Level",
"clientSecret": "client secret generated when registering SharePoint for App Only at Site Level",
"ldapUrl": "LDAP Account url eg. ldap://example.com:389",
"baseDn": "LDAP Account base dn eg. CN=Users,DC=sharepoint,DC=com",
"ldapUser": "LDAP account user name",
"ldapPassword": "LDAP account password"
}
```
+ **(Nur Server) NTLM- oder Kerberos-Authentifizierung**
```
{
"siteUrlsHash": "Hash representation of SharePoint site URLs",
"userName": "SharePoint account user name",
"password": "SharePoint account password"
}
```
+ **(Nur Server) NTLM- oder Kerberos-Authentifizierung mit Domain aus IDP-Autorisierung**
```
{
"siteUrlsHash": "Hash representation of SharePoint site URLs",
"userName": "SharePoint account user name",
"password": "SharePoint account password",
"ldapUrl": "ldap://example.com:389",
"baseDn": "CN=Users,DC=sharepoint,DC=com",
"ldapUser": "LDAP account user name",
"ldapPassword": "LDAP account password"
}
```
+ **IAM Rolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen öffentlichen Daten für den Connector und zu erteilen. APIs SharePoint Amazon Kendra Weitere Informationen finden Sie unter [IAM Rollen für SharePoint Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Sie können angeben, ob bestimmte Dateien und andere Inhalte ein- oder ausgeschlossen werden sollen. OneNotes
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Feldzuordnungen — Ordnen** Sie Ihre SharePoint Datenquellenfelder Ihren Indexfeldern zu. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [SharePoint Vorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-sharepoint).
------
## Hinweise
+ Der Connector unterstützt benutzerdefinierte Feldzuordnungen nur für die Entität **Files**.
+ Für alle SharePoint Serverversionen muss das ACL-Token in Kleinbuchstaben geschrieben werden. Für **E-Mail mit Domain von IDP** und **E-Mail-ID mit benutzerdefinierter Domain-ACL**, zum Beispiel:*user@sharepoint2019.com*. Für **Domain\$1 User with Domain** ACL, zum Beispiel:*sharepoint2013\$1user*.
+ Wenn Access Control Lists (ACLs) aktiviert sind, ist die Option „Nur neue oder geänderte Inhalte synchronisieren“ aufgrund von SharePoint API-Einschränkungen nicht verfügbar. Wir empfehlen, stattdessen die Modi „Vollständige Synchronisierung“ oder „Neue, geänderte oder gelöschte Inhalte“ zu verwenden oder sie zu deaktivieren, ACLs falls Sie diesen Synchronisierungsmodus verwenden müssen.
+ Der Connector unterstützt den Modus „**Änderungsprotokoll/Neue oder geänderte Inhalte“ für** SharePoint 2013 nicht.
+ Wenn der Name einer Entität ein `%`-Zeichen enthält, überspringt der Konnektor diese Dateien aufgrund von API-Einschränkungen.
+ OneNote kann vom Connector nur mit einer Mandanten-ID und mit einem 2.0-, OAuth OAuth 2.0-Aktualisierungstoken oder mit aktivierter SharePoint Only-App-Authentifizierung für SharePoint Online gecrawlt werden.
+ Der Connector durchsucht den ersten Abschnitt eines OneNote Dokuments nur unter Verwendung seines Standardnamens, auch wenn das Dokument umbenannt wurde.
+ **Der Connector crawlt Links in den Versionen SharePoint 2019, SharePoint Online und Subscription nur, wenn neben Links auch **Seiten** und **Dateien** als zu durchsuchende Entitäten ausgewählt wurden.**
+ Der Connector crawlt Links in den Jahren SharePoint 2013 und SharePoint 2016, wenn **Links** als Entität für das Crawlen ausgewählt wurde.
+ Der Connector durchsucht Listenanhänge und Kommentare nur, wenn **List Data** auch als Entität für das Crawlen ausgewählt wurde.
+ Der Konnektor crawlt Ereignisanhänge nur, wenn **Ereignisse** ebenfalls als zu crawlende Entität ausgewählt wurde.
+ In der SharePoint Online-Version wird das ACL-Token in Kleinbuchstaben geschrieben. Wenn sich beispielsweise der **Benutzerprinzipalname** *MaryMajor@domain.com* im Azure-Portal befindet, gilt dies auch für das ACL-Token im SharePoint Connector*marymajor@domain.com*.
+ Wenn Sie in **Identity Crawler** für SharePoint Online und Server verschachtelte Gruppen crawlen möchten, müssen Sie sowohl das lokale Crawling als auch das AD-Gruppen-Crawling aktivieren.
+ Wenn Sie SharePoint Online verwenden und der Benutzerprinzipalname in Ihrem Azure-Portal eine Kombination aus Groß- und Kleinschreibung ist, konvertiert die SharePoint API ihn intern in Kleinbuchstaben. Aus diesem Grund legt der Amazon Kendra SharePoint Konnektor ACL in Kleinbuchstaben fest.
# Microsoft SQL Server
**Anmerkung**
Der Microsoft SQL Server-Konnektor wird für Bestandskunden bis zum 31. Mai 2026 weiterhin vollständig unterstützt. Dieser Konnektor ist zwar nicht mehr für neue Benutzer verfügbar, aktuelle Benutzer können ihn jedoch weiterhin ohne Unterbrechung verwenden. Wir entwickeln unser Konnektor-Portfolio kontinuierlich weiter, um besser skalierbare und anpassbare Lösungen anbieten zu können. Für future Integrationen empfehlen wir, sich mit dem Amazon Kendra Custom Connector Framework [1] vertraut zu machen, das ein breiteres Spektrum von Unternehmensanwendungsfällen mit verbesserter Flexibilität unterstützt.
Microsoft SQL Server ist ein von Microsoft entwickeltes Verwaltungssystem für relationale Datenbanken (RDBMS). Wenn Sie ein Microsoft SQL Server Benutzer sind, können Sie Amazon Kendra damit Ihre Microsoft SQL Server Datenquelle indizieren. Der Amazon Kendra Microsoft SQL Server Datenquellenconnector unterstützt MS SQL Server 2019.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer Microsoft SQL Server Datenquelle herstellen.
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Microsoft SQL Server Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-ms-sql-server)
+ [
## Voraussetzungen
](#prerequisites-ms-sql-server)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-ms-sql-server)
+ [
## Hinweise
](#ms-sql-server-notes)
## Unterstützte Features
+ Feldzuordnungen
+ Filterung des Benutzerkontextes
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Microsoft SQL Server Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren Konten Microsoft SQL Server und AWS Konten vor.
**Stellen Sie in Microsoft SQL Server Folgendes sicher:**
+ Notieren Sie sich Ihren Datenbankbenutzernamen und Ihr Passwort.
**Wichtig**
Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Die URL, der Port und die Instanz Ihres Datenbank-Hosts wurden kopiert.
+ Vergewissert, dass jedes Dokument in Microsoft SQL Server und zwischen anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen pro Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Wir haben Ihre Microsoft SQL Server Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Microsoft SQL Server Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Microsoft SQL Server Datenquelle herzustellen, müssen Sie Details zu Ihren Microsoft SQL Server Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben, Amazon Kendra finden Sie Microsoft SQL Server weitere Informationen unter[Voraussetzungen](#prerequisites-ms-sql-server).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen Microsoft SQL Server**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Microsoft SQL ServerConnector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Microsoft SQL ServerConnector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. Geben Sie unter **Quelle** die folgenden Informationen ein:
1. **Host** — Geben Sie den Datenbank-Hostnamen ein.
1. **Port** — Geben Sie den Datenbankport ein.
1. **Instanz** — Geben Sie die Datenbankinstanz ein.
1. **Speicherort für SSL-Zertifikate aktivieren** — Geben Sie hier den Amazon S3 Pfad zu Ihrer SSL-Zertifikatsdatei ein.
1. Geben Sie im Feld **Authentifizierung** die folgenden Informationen ein:
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Microsoft SQL Server Authentifizierungsdaten zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra- Microsoft SQL Server -' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Für **Datenbankbenutzername** und **Passwort** — Geben Sie die Werte der Authentifizierungsdaten ein, die Sie aus Ihrer Datenbank kopiert haben.
1. Wählen Sie **Speichern**.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Wählen Sie unter **Synchronisierungsbereich** aus den folgenden Optionen aus:
+ **SQL-Abfrage** – Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
**Anmerkung**
Wenn ein Tabellenname Sonderzeichen (nicht alphanumerisch) enthält, müssen Sie den Tabellennamen in eckige Klammern setzen. Beispiel: *select \$1 from [my-database-table]*
+ **Primärschlüsselspalte** – Geben Sie den Primärschlüssel für die Datenbanktabelle an. Dadurch wird eine Tabelle in Ihrer Datenbank identifiziert.
+ **Titelspalte** – Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein.
+ **Hauptspalte** — Geben Sie den Namen der Hauptspalte des Dokuments in Ihrer Datenbanktabelle an.
1. Wählen Sie **unter Zusätzliche Konfiguration — *optional*** aus den folgenden Optionen, um bestimmte Inhalte zu synchronisieren, anstatt alle Dateien zu synchronisieren:
+ **Spalten zur Erkennung von Änderungen** — Geben Sie die Namen der Spalten ein, anhand derer Inhaltsänderungen erkannt Amazon Kendra werden sollen. Amazon Kendraindexiert den Inhalt neu, wenn sich eine dieser Spalten ändert.
+ ** IDsBenutzerspalte** — Geben Sie den Namen der Spalte ein, die Benutzer IDs enthält, denen Zugriff auf Inhalte gewährt werden soll.
+ **Gruppenspalte** – Geben Sie den Namen der Spalte ein, die Gruppen enthält, denen Zugriff auf Inhalte gewährt werden soll.
+ ** URLsQuellspalte** — Geben Sie den Namen der Spalte ein, die die URLs zu indizierende Quelle enthält.
+ **Spalte mit Zeitstempeln** — Geben Sie den Namen der Spalte ein, die Zeitstempel enthält. Amazon Kendraverwendet Zeitstempelinformationen, um Änderungen an Ihren Inhalten zu erkennen und nur geänderte Inhalte zu synchronisieren.
+ **Zeitzonenspalte** – Geben Sie den Namen der Spalte ein, die Zeitzonen für den Inhalt enthält, der durchsucht werden soll.
+ **Zeitstempelformat** – Geben Sie den Namen der Spalte ein, die Zeitstempelformate enthält, die verwendet werden sollen, um Inhaltsänderungen zu erkennen und Ihre Inhalte erneut zu synchronisieren.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Im **Synchronisierungslaufplan** für **Frequenz** — Wie oft Amazon Kendra wird mit Ihrer Datenquelle synchronisiert?
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den generierten Standarddatenquellenfeldern — **Dokument IDs**, **Dokumenttitel** und **Quelle URLs** — aus, die Sie dem Index zuordnen möchten. Amazon Kendra
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen Microsoft SQL Server**
Mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API müssen Sie Folgendes angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `JDBC` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Datenbanktyp** — Sie müssen den Datenbanktyp als `sqlserver` angeben.
+ **SQL-Abfrage** — Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen an. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
**Anmerkung**
Wenn ein Tabellenname Sonderzeichen (nicht alphanumerisch) enthält, müssen Sie den Tabellennamen in eckige Klammern setzen. Beispiel: *select \$1 from [my-database-table]*
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem Microsoft SQL Server Konto erstellt haben. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"user name": "database user name",
"password": "password"
}
```
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ **IAMRolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen Öffentlichkeit APIs für den Microsoft SQL Server Connector und zu erteilen. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für Microsoft SQL Server Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Sie können mithilfe von Benutzern, Gruppen IDs, Quellen, Zeitstempeln und Zeitzonen angeben URLs, ob bestimmte Inhalte eingeschlossen werden sollen.
+ **Benutzerkontextfilterung und Zugriffskontrolle** — Amazon Kendra durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Microsoft SQL Server Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter[Microsoft SQL Server-Vorlagenschema](ds-schemas.md#ds-ms-sql-server-schema).
------
## Hinweise
+ Gelöschte Datenbankzeilen werden nicht nachverfolgt, wenn nach Amazon Kendra aktualisierten Inhalten gesucht wird.
+ Die Größe von Feldnamen und Werten in einer Zeile Ihrer Datenbank darf 400 KB nicht überschreiten.
+ Wenn Ihre Datenbankdatenquelle eine große Datenmenge enthält und Sie nicht möchtenAmazon Kendra, dass Ihr gesamter Datenbankinhalt nach der ersten Synchronisierung indexiert wird, können Sie wählen, ob nur neue, geänderte oder gelöschte Dokumente synchronisiert werden sollen.
+ Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Es hat sich bewährt, das Hinzufügen von Tabellen mit sensiblen Daten oder personenbezogenen Daten (PII) zu vermeiden.
# Microsoft Teams
Microsoft Teams ist ein Tool für die Zusammenarbeit in Unternehmen für Messaging, Besprechungen und Filesharing. Wenn Sie ein Microsoft Teams-Benutzer sind, können Sie Amazon Kendra damit Ihre Microsoft Teams-Datenquelle indizieren.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer Microsoft Teams-Datenquelle herstellen.
Informationen zur Problembehandlung Ihres Amazon Kendra Microsoft Teams-Datenquellenconnectors finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-teams)
+ [
## Voraussetzungen
](#prerequisites-teams)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-teams)
+ [
## Weitere Informationen
](#teams-learn-more)
+ [
## Hinweise
](#teams-notes)
## Unterstützte Features
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Microsoft Teams-Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren Microsoft Teams und AWS Konten vor.
**Stellen Sie in Microsoft Teams sicher, dass Sie über Folgendes verfügen:**
+ Hat ein Microsoft Teams-Konto in Office 365 erstellt.
+ Haben Sie Ihre Microsoft 365-Mandanten-ID notiert. Sie finden Ihre Mandanten-ID in den Eigenschaften Ihres Azure Active Directory-Portals oder in Ihrer OAuth Anwendung.
+ Hat eine OAuth Anwendung im Azure-Portal konfiguriert und die Client-ID und den geheimen Client-Schlüssel oder die Kundenanmeldedaten notiert. Weitere Informationen finden Sie im [Microsoft-Tutorial](https://learn.microsoft.com/en-us/power-apps/developer/data-platform/walkthrough-register-app-azure-active-directory) und im [Beispiel für registrierte Apps](https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application).
**Anmerkung**
Wenn Sie eine App im Azure-Portal erstellen oder registrieren, stellt die geheime ID den tatsächlichen geheimen Wert dar. Sie müssen den tatsächlichen geheimen Wert sofort bei der Erstellung des Geheimnisses und der App notieren oder speichern. Sie können auf Ihr Geheimnis zugreifen, indem Sie den Namen Ihrer Anwendung im Azure-Portal auswählen und dann zur Menüoption für Zertifikate und Geheimnisse navigieren.
Sie können auf Ihre Client-ID zugreifen, indem Sie den Namen Ihrer Anwendung im Azure-Portal auswählen und dann zur Übersichtsseite navigieren. Die Anwendungs-ID (Client) ist die Client-ID.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ Sie haben die erforderlichen Berechtigungen hinzugefügt. Sie können wählen, ob Sie alle Berechtigungen hinzufügen möchten, oder Sie können den Umfang einschränken, indem Sie weniger Berechtigungen auswählen, je nachdem, welche Entitäten Sie crawlen möchten. In der folgenden Tabelle sind die Berechtigungen auf Anwendungsebene nach der entsprechenden Entität aufgeführt:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/data-source-teams.html)
+ Aktiviert, dass jedes Dokument in Microsoft Teams und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Haben Ihre Microsoft Teams-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Microsoft Teams-Datenquelle mit verbindenAmazon Kendra. Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Microsoft Teams-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Microsoft Teams-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Wenn Sie Microsoft Teams für noch nicht konfiguriert habenAmazon Kendra, finden Sie weitere Informationen unter[Voraussetzungen](#prerequisites-teams).
------
#### [ Console ]
**So stellen Sie eine Verbindung Amazon Kendra zu Microsoft Teams her**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Microsoft Teams-Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie **Microsoft Teams Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Mandanten-ID** — Geben Sie Ihre Microsoft 365-Mandanten-ID ein. Sie finden Ihre Mandanten-ID in den Eigenschaften Ihres Azure Active Directory-Portals oder in Ihrer OAuth Anwendung.
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Microsoft Teams-Authentifizierungsdaten zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Microsoft Teams-' wird Ihrem geheimen Namen automatisch hinzugefügt.
1. Für **Client ID** und **Client Secret**: Geben Sie die in Microsoft Teams konfigurierten Authentifizierungsdaten im Azure-Portal ein.
1. Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.
1. **Zahlungsmodell** — Sie können ein Lizenz- und Zahlungsmodell für Ihr Microsoft Teams-Konto wählen. Die Zahlungsmodelle des Modells A sind auf Lizenz- und Zahlungsmodelle beschränkt, für die die Einhaltung der Sicherheitsvorschriften erforderlich ist. Die Zahlungsmodelle des Modells B eignen sich für Lizenz- und Zahlungsmodelle, für die keine Sicherheitsvorschriften erforderlich sind.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. **Inhalte synchronisieren** — Wählen Sie die Inhaltstypen aus, die gecrawlt werden sollen. Sie können wählen, ob Chat-, Teams- und Kalenderinhalte gecrawlt werden sollen.
1. **Zusätzliche Konfiguration** — Geben Sie bestimmte Start- und Enddaten des Kalenders, Benutzer-E-Mails, Teamnamen und Kanalnamen, Anlagen und an. OneNotes
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Frequenz** aus, wie oft der Inhalt Ihrer Datenquelle synchronisiert und der Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Standard-Datenquellenfelder** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**So stellen Sie eine Verbindung Amazon Kendra zu Microsoft Teams her**
Sie müssen mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API eine JSON-Datei des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `MSTEAMS` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Mandanten-ID** — Sie finden Ihre Mandanten-ID in den Eigenschaften Ihres Azure Active Directory-Portals oder in Ihrer OAuth Anwendung.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Microsoft Teams-Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"clientId": "client ID",
"clientSecret": "client secret"
}
```
+ **IAMrole** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis zu gewähren und die erforderliche Öffentlichkeit APIs für den Microsoft Teams-Connector und Amazon Kendra anzurufen. Weitere Informationen finden Sie unter [IAMRollen für Microsoft Teams-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Dokument-/Inhaltstypen** — Geben Sie an, ob Chat-Nachrichten und -Anlagen, Kanalbeiträge und -anhänge, Kanal-Wikis, Kalenderinhalte, Besprechungs-Chats sowie Dateien und Notizen gecrawlt werden sollen.
+ **Kalenderinhalt** — Geben Sie ein Start- und Enddatum sowie eine Uhrzeit für das Crawlen von Kalenderinhalten an.
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob bestimmte Inhalte in Microsoft Teams ein- oder ausgeschlossen werden sollen. Sie können Teamnamen, Kanalnamen, Dateinamen und Dateitypen, Benutzer-E-Mails, OneNote Abschnitte und OneNote Seiten ein- oder ausschließen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Inklusionsfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Microsoft Teams-Datenquellenfelder Ihren Amazon Kendra Indexfeldern zuzuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger zu konfigurierender JSON-Schlüssel finden Sie unter [Microsoft Teams-Vorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-msteams-schema).
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer Microsoft Teams-Datenquelle finden Sie unter:
+ [Durchsuchen Sie die Microsoft Teams-Datenquelle Ihres Unternehmens intelligent mit dem Amazon Kendra Connector für Microsoft Teams](https://aws.amazon.com/blogs/machine-learning/intelligently-search-your-organizations-microsoft-teams-data-source-with-the-amazon-kendra-connector-for-microsoft-teams/)
## Hinweise
+ Wenn Zugriffskontrolllisten (ACLs) aktiviert sind, ist die Option „Nur neue oder geänderte Inhalte synchronisieren“ aufgrund von Einschränkungen der Microsoft Teams-API nicht verfügbar. Wir empfehlen, stattdessen die Modi „Vollständige Synchronisierung“ oder „Neue, geänderte oder gelöschte Inhalte“ zu verwenden oder sie zu deaktivieren, ACLs falls Sie diesen Synchronisierungsmodus verwenden müssen.
# Microsoft Yammer
**Anmerkung**
Der Microsoft Yammer-Connector wird für Bestandskunden bis zum 31. Mai 2026 weiterhin vollständig unterstützt. Dieser Konnektor ist zwar nicht mehr für neue Benutzer verfügbar, aktuelle Benutzer können ihn jedoch weiterhin ohne Unterbrechung verwenden. Wir entwickeln unser Konnektor-Portfolio kontinuierlich weiter, um besser skalierbare und anpassbare Lösungen anbieten zu können. Für future Integrationen empfehlen wir, sich mit dem Amazon Kendra Custom Connector Framework [1] vertraut zu machen, das ein breiteres Spektrum von Unternehmensanwendungsfällen mit verbesserter Flexibilität unterstützt.
Microsoft Yammer ist ein Tool für die Zusammenarbeit in Unternehmen für Messaging, Besprechungen und Filesharing. Wenn Sie ein Microsoft Yammer-Benutzer sind, können Sie Amazon Kendra damit Ihre Microsoft Yammer-Datenquelle indizieren.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer Microsoft Yammer-Datenquelle herstellen.
Informationen zur Problembehandlung Ihres Amazon Kendra Microsoft Yammer-Datenquellenconnectors finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
## Unterstützte Features
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Microsoft Yammer-Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihrem Microsoft Yammer und AWS Ihren Konten vor.
**Stellen Sie in Microsoft Yammer sicher, dass Sie über Folgendes verfügen:**
+ Es wurde ein Microsoft Yammer-Administratorkonto in Office 365 erstellt.
+ Haben Ihren Microsoft Yammer-Benutzernamen und Ihr Passwort notiert.
+ Haben Sie Ihre Microsoft 365-Mandanten-ID notiert. Sie finden Ihre Mandanten-ID in den Eigenschaften Ihres Azure Active Directory-Portals oder in Ihrer OAuth Anwendung.
+ Hat eine OAuth Anwendung im Azure-Portal konfiguriert und die Client-ID und den geheimen Client-Schlüssel oder die Kundenanmeldedaten notiert. Weitere Informationen finden Sie im [Microsoft-Tutorial](https://learn.microsoft.com/en-us/power-apps/developer/data-platform/walkthrough-register-app-azure-active-directory) und im [Beispiel für registrierte Apps](https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application).
**Anmerkung**
Wenn Sie eine App im Azure-Portal erstellen oder registrieren, stellt die geheime ID den tatsächlichen geheimen Wert dar. Sie müssen den tatsächlichen geheimen Wert sofort bei der Erstellung des Geheimnisses und der App notieren oder speichern. Sie können auf Ihr Geheimnis zugreifen, indem Sie den Namen Ihrer Anwendung im Azure-Portal auswählen und dann zur Menüoption für Zertifikate und Geheimnisse navigieren.
Sie können auf Ihre Client-ID zugreifen, indem Sie den Namen Ihrer Anwendung im Azure-Portal auswählen und dann zur Übersichtsseite navigieren. Die Anwendungs-ID (Client) ist die Client-ID.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ Aktiviert, dass jedes Dokument in Microsoft Yammer und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, eindeutig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Ihre Microsoft Yammer-Authentifizierungsanmeldedaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Microsoft Yammer-Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Microsoft Yammer-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Microsoft Yammer-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Wenn Sie Microsoft Yammer für noch nicht konfiguriert habenAmazon Kendra, finden Sie weitere Informationen unter[Voraussetzungen](#prerequisites-yammer).
------
#### [ Console ]
**So stellen Sie eine Verbindung Amazon Kendra zu Microsoft Yammer her**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Microsoft Yammer-Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Microsoft Yammer-Connector** mit dem Tag „V2.0".
1. Geben Sie auf der Seite **„Datenquellendetails angeben**“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Microsoft Yammer-Authentifizierungsanmeldeinformationen zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das Fenster **AWS Secrets Manager-Secret erstellen** ein:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Microsoft Yammer-' wird Ihrem geheimen Namen automatisch hinzugefügt.
1. Für **Username**, **Password** — Geben Sie Ihren Microsoft Yammer-Benutzernamen und Ihr Passwort ein.
1. Für **Client ID**, **Client Secret** — Geben Sie die in Microsoft Yammer konfigurierten Authentifizierungsdaten im Azure-Portal ein.
1. Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. **Seit dem Datum** — Geben Sie das Datum an, an dem mit dem Crawlen Ihrer Daten in Microsoft Yammer begonnen werden soll.
1. **Inhalte synchronisieren** — Wählen Sie den Inhaltstyp aus, der gecrawlt werden soll. Zum Beispiel öffentliche Nachrichten, private Nachrichten und Anlagen.
1. **Zusätzliche Konfiguration** — Geben Sie bestimmte Community-Namen an, die Sie crawlen möchten, und verwenden Sie außerdem Muster mit regulären Ausdrücken, um bestimmte Inhalte ein- oder auszuschließen.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Frequenz** aus, wie oft der Inhalt Ihrer Datenquelle synchronisiert und der Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Standard-Datenquellenfelder** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**So stellen Sie eine Verbindung Amazon Kendra zu Microsoft Yammer her**
Sie müssen mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API eine JSON-Datei des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `YAMMER` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Microsoft Yammer-Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"username": "user name",
"password": "password",
"clientId": "client ID",
"clientSecret": "client secret"
}
```
+ **IAMrole** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis zu gewähren und die erforderliche Öffentlichkeit APIs für den Microsoft Yammer-Connector und aufzurufen. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für Microsoft Yammer-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Dokument-/Inhaltstypen** — Geben Sie an, ob Community-Inhalte, Nachrichten und Anlagen sowie private Nachrichten gecrawlt werden sollen.
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob bestimmte Inhalte ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Microsoft Yammer-Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger zu konfigurierender JSON-Schlüssel finden Sie unter [Microsoft Yammer-Vorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-yammer).
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer Microsoft Yammer-Datenquelle finden Sie unter:
+ [Ankündigung des Yammer-Connectors für Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/announcing-the-yammer-connector-for-amazon-kendra/)
# MySQL
**Anmerkung**
Der MySQL-Konnektor wird für Bestandskunden bis zum 31. Mai 2026 weiterhin vollständig unterstützt. Dieser Konnektor ist zwar nicht mehr für neue Benutzer verfügbar, aktuelle Benutzer können ihn jedoch weiterhin ohne Unterbrechung verwenden. Wir entwickeln unser Konnektor-Portfolio kontinuierlich weiter, um besser skalierbare und anpassbare Lösungen anbieten zu können. Für future Integrationen empfehlen wir, sich mit dem Amazon Kendra Custom Connector Framework [1] vertraut zu machen, das ein breiteres Spektrum von Unternehmensanwendungsfällen mit verbesserter Flexibilität unterstützt.
MySQList ein relationales Open-Source-Datenbankverwaltungssystem. Wenn Sie ein MySQL Benutzer sind, können Sie Amazon Kendra damit Ihre MySQL Datenquelle indizieren. Der Amazon Kendra MySQL Datenquellenconnector unterstützt MySQL 8.0. 21.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer MySQL Datenquelle herstellen.
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra MySQL Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-mysql)
+ [
## Voraussetzungen
](#prerequisites-mysql)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-mysql)
+ [
## Hinweise
](#mysql-notes)
## Unterstützte Features
+ Feldzuordnungen
+ Filterung des Benutzerkontextes
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre MySQL Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren Konten MySQL und AWS Konten vor.
**Stellen Sie in MySQL Folgendes sicher:**
+ Notieren Sie sich Ihren Datenbankbenutzernamen und Ihr Passwort.
**Wichtig**
Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Die URL, der Port und die Instanz Ihres Datenbank-Hosts wurden kopiert.
+ Vergewissert, dass jedes Dokument in MySQL und zwischen anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen pro Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Wir haben Ihre MySQL Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre MySQL Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer MySQL Datenquelle herzustellen, müssen Sie Details zu Ihren MySQL Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben, Amazon Kendra finden Sie MySQL weitere Informationen unter[Voraussetzungen](#prerequisites-mysql).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen MySQL**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **MySQLConnector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **MySQLConnector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. Geben Sie unter **Quelle** die folgenden Informationen ein:
1. **Host** — Geben Sie den Datenbank-Hostnamen ein.
1. **Port** — Geben Sie den Datenbankport ein.
1. **Instanz** — Geben Sie die Datenbankinstanz ein.
1. **Speicherort für SSL-Zertifikate aktivieren** — Geben Sie hier den Amazon S3 Pfad zu Ihrer SSL-Zertifikatsdatei ein.
1. Geben Sie im Feld **Authentifizierung** die folgenden Informationen ein:
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre MySQL Authentifizierungsdaten zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra- MySQL -' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Für **Datenbankbenutzername** und **Passwort** — Geben Sie die Werte der Authentifizierungsdaten ein, die Sie aus Ihrer Datenbank kopiert haben.
1. Wählen Sie **Speichern**.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Wählen Sie unter **Synchronisierungsbereich** aus den folgenden Optionen aus:
+ **SQL-Abfrage** – Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Primärschlüsselspalte** – Geben Sie den Primärschlüssel für die Datenbanktabelle an. Dadurch wird eine Tabelle in Ihrer Datenbank identifiziert.
+ **Titelspalte** – Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein.
+ **Hauptspalte** — Geben Sie den Namen der Textspalte des Dokuments in Ihrer Datenbanktabelle ein.
1. Wählen Sie **unter Zusätzliche Konfiguration — *optional*** aus den folgenden Optionen, um bestimmte Inhalte zu synchronisieren, anstatt alle Dateien zu synchronisieren:
+ **Spalten zur Erkennung von Änderungen** — Geben Sie die Namen der Spalten ein, anhand derer Inhaltsänderungen erkannt Amazon Kendra werden sollen. Amazon Kendraindexiert den Inhalt neu, wenn sich eine dieser Spalten ändert.
+ ** IDsSpalte Benutzer** — Geben Sie den Namen der Spalte ein, die den Benutzer enthält, dem der Zugriff auf IDs den Inhalt gewährt werden soll.
+ **Gruppenspalte** – Geben Sie den Namen der Spalte ein, die Gruppen enthält, denen Zugriff auf Inhalte gewährt werden soll.
+ ** URLsQuellspalte** — Geben Sie den Namen der Spalte ein, die die URLs zu indizierende Quelle enthält.
+ **Spalte mit Zeitstempeln** — Geben Sie den Namen der Spalte ein, die Zeitstempel enthält. Amazon Kendraverwendet Zeitstempelinformationen, um Änderungen an Ihren Inhalten zu erkennen und nur geänderte Inhalte zu synchronisieren.
+ **Zeitzonenspalte** – Geben Sie den Namen der Spalte ein, die Zeitzonen für den Inhalt enthält, der durchsucht werden soll.
+ **Zeitstempelformat** – Geben Sie den Namen der Spalte ein, die Zeitstempelformate enthält, die verwendet werden sollen, um Inhaltsänderungen zu erkennen und Ihre Inhalte erneut zu synchronisieren.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Im **Synchronisierungslaufplan** für **Frequenz** — Wie oft Amazon Kendra wird mit Ihrer Datenquelle synchronisiert?
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den generierten Standarddatenquellenfeldern — **Dokument IDs**, **Dokumenttitel** und **Quelle URLs** — aus, die Sie dem Index zuordnen möchten. Amazon Kendra
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen MySQL**
Mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API müssen Sie Folgendes angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `JDBC` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Datenbanktyp** — Sie müssen den Datenbanktyp als `mySql` angeben.
+ **SQL-Abfrage** — Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen an. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem MySQL Konto erstellt haben. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"user name": "database user name",
"password": "password"
}
```
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (falls zutreffend) wiederzuverwenden.
+ **IAMRolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen Öffentlichkeit APIs für den MySQL Connector und zu erteilen. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für MySQL Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Sie können mithilfe von Benutzern, Gruppen IDs, Quellen, Zeitstempeln und Zeitzonen angeben URLs, ob bestimmte Inhalte eingeschlossen werden sollen.
+ **Benutzerkontextfilterung und Zugriffskontrolle** — Amazon Kendra durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre MySQL Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
------
## Hinweise
+ Gelöschte Datenbankzeilen werden nicht nachverfolgt, wenn nach Amazon Kendra aktualisiertem Inhalt gesucht wird.
+ Die Größe von Feldnamen und Werten in einer Zeile Ihrer Datenbank darf 400 KB nicht überschreiten.
+ Wenn Ihre Datenbankdatenquelle eine große Datenmenge enthält und Sie nicht möchtenAmazon Kendra, dass Ihr gesamter Datenbankinhalt nach der ersten Synchronisierung indexiert wird, können Sie wählen, ob nur neue, geänderte oder gelöschte Dokumente synchronisiert werden sollen.
+ Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Es hat sich bewährt, das Hinzufügen von Tabellen mit sensiblen Daten oder personenbezogenen Daten (PII) zu vermeiden.
# Oracle Database
**Anmerkung**
Der Oracle Database-Konnektor wird für Bestandskunden bis zum 31. Mai 2026 weiterhin vollständig unterstützt. Dieser Konnektor ist zwar nicht mehr für neue Benutzer verfügbar, aktuelle Benutzer können ihn jedoch weiterhin ohne Unterbrechung verwenden. Wir entwickeln unser Konnektor-Portfolio kontinuierlich weiter, um besser skalierbare und anpassbare Lösungen anbieten zu können. Für future Integrationen empfehlen wir, sich mit dem Amazon Kendra Custom Connector Framework [1] vertraut zu machen, das ein breiteres Spektrum von Unternehmensanwendungsfällen mit verbesserter Flexibilität unterstützt.
Oracle Database ist ein Datenbankmanagementsystem. Wenn Sie ein Oracle Database Benutzer sind, können Sie Amazon Kendra damit Ihre Oracle Database Datenquelle indizieren. Der Amazon Kendra Oracle Database Datenquellen-Connector unterstützt Oracle Database 18c, 19c und 21c.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die API eine Verbindung zu Ihrer Oracle Database Datenquelle herstellen. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Oracle Database Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-oracle-database)
+ [
## Voraussetzungen
](#prerequisites-oracle-database)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-oracle-database)
+ [
## Hinweise
](#oracle-database-notes)
## Unterstützte Features
+ Feldzuordnungen
+ Filterung des Benutzerkontextes
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Oracle Database Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren Konten Oracle Database und AWS Konten vor.
**Stellen Sie in Oracle Database Folgendes sicher:**
+ Notieren Sie sich Ihren Datenbankbenutzernamen und Ihr Passwort.
**Wichtig**
Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Die URL, der Port und die Instanz Ihres Datenbank-Hosts wurden kopiert.
+ Vergewissert, dass jedes Dokument in Oracle Database und zwischen anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Wir haben Ihre Oracle Database Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Oracle Database Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Oracle Database Datenquelle herzustellen, müssen Sie Details zu Ihren Oracle Database Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben, Amazon Kendra finden Sie Oracle Database weitere Informationen unter[Voraussetzungen](#prerequisites-oracle-database).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen Oracle Database**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Oracle DatabaseConnector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Oracle DatabaseConnector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. Geben Sie unter **Quelle** die folgenden Informationen ein:
1. **Host** — Geben Sie den Datenbank-Hostnamen ein.
1. **Port** — Geben Sie den Datenbankport ein.
1. **Instanz** — Geben Sie die Datenbankinstanz ein.
1. **Speicherort für SSL-Zertifikate aktivieren** — Geben Sie hier den Amazon S3 Pfad zu Ihrer SSL-Zertifikatsdatei ein.
1. Geben Sie im Feld **Authentifizierung** die folgenden Informationen ein:
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Oracle Database Authentifizierungsdaten zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra- Oracle Database -' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Für **Datenbankbenutzername** und **Passwort** — Geben Sie die Werte der Authentifizierungsdaten ein, die Sie aus Ihrer Datenbank kopiert haben.
1. Wählen Sie **Speichern**.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Wählen Sie unter **Synchronisierungsbereich** aus den folgenden Optionen aus:
+ **SQL-Abfrage** – Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Primärschlüsselspalte** – Geben Sie den Primärschlüssel für die Datenbanktabelle an. Dadurch wird eine Tabelle in Ihrer Datenbank identifiziert.
+ **Titelspalte** – Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein.
+ **Hauptspalte** — Geben Sie den Namen der Textspalte des Dokuments in Ihrer Datenbanktabelle ein.
1. Wählen Sie **unter Zusätzliche Konfiguration — *optional*** aus den folgenden Optionen, um bestimmte Inhalte zu synchronisieren, anstatt alle Dateien zu synchronisieren:
+ **Spalten zur Erkennung von Änderungen** — Geben Sie die Namen der Spalten ein, anhand derer Inhaltsänderungen erkannt Amazon Kendra werden sollen. Amazon Kendraindexiert den Inhalt neu, wenn sich eine dieser Spalten ändert.
+ ** IDsBenutzerspalte** — Geben Sie den Namen der Spalte ein, die den Benutzer enthält, dem der Zugriff auf IDs den Inhalt gewährt werden soll.
+ **Gruppenspalte** – Geben Sie den Namen der Spalte ein, die Gruppen enthält, denen Zugriff auf Inhalte gewährt werden soll.
+ ** URLsQuellspalte** — Geben Sie den Namen der Spalte ein, die die URLs zu indizierende Quelle enthält.
+ **Spalte mit Zeitstempeln** — Geben Sie den Namen der Spalte ein, die Zeitstempel enthält. Amazon Kendraverwendet Zeitstempelinformationen, um Änderungen an Ihren Inhalten zu erkennen und nur geänderte Inhalte zu synchronisieren.
+ **Zeitzonenspalte** – Geben Sie den Namen der Spalte ein, die Zeitzonen für den Inhalt enthält, der durchsucht werden soll.
+ **Zeitstempelformat** – Geben Sie den Namen der Spalte ein, die Zeitstempelformate enthält, die verwendet werden sollen, um Inhaltsänderungen zu erkennen und Ihre Inhalte erneut zu synchronisieren.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Im **Synchronisierungslaufplan** für **Frequenz** — Wie oft Amazon Kendra wird mit Ihrer Datenquelle synchronisiert?
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den generierten Standarddatenquellenfeldern — **Dokument IDs**, **Dokumenttitel** und **Quelle URLs** — aus, die Sie dem Index zuordnen möchten. Amazon Kendra
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen Oracle Database**
Mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API müssen Sie Folgendes angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `JDBC` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Datenbanktyp** — Sie müssen den Datenbanktyp als `oracle` angeben.
+ **SQL-Abfrage** — Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen an. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem Oracle Database Konto erstellt haben. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"user name": "database user name",
"password": "password"
}
```
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (falls zutreffend) wiederzuverwenden.
+ **IAMRolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen Öffentlichkeit APIs für den Oracle Database Connector und zu erteilen. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für Oracle Database Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Sie können mithilfe von Benutzern, Gruppen IDs, Quellen, Zeitstempeln und Zeitzonen angeben URLs, ob bestimmte Inhalte eingeschlossen werden sollen.
+ **Benutzerkontextfilterung und Zugriffskontrolle** — Amazon Kendra durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Oracle Database Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter[Oracle-Datenbank-Vorlagenschema](ds-schemas.md#ds-oracle-database-schema).
------
## Hinweise
+ Gelöschte Datenbankzeilen werden nicht nachverfolgt, wenn nach Amazon Kendra aktualisiertem Inhalt gesucht wird.
+ Die Größe von Feldnamen und Werten in einer Zeile Ihrer Datenbank darf 400 KB nicht überschreiten.
+ Wenn Ihre Datenbankdatenquelle eine große Datenmenge enthält und Sie nicht möchtenAmazon Kendra, dass Ihr gesamter Datenbankinhalt nach der ersten Synchronisierung indexiert wird, können Sie wählen, ob nur neue, geänderte oder gelöschte Dokumente synchronisiert werden sollen.
+ Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Es hat sich bewährt, das Hinzufügen von Tabellen mit sensiblen Daten oder personenbezogenen Daten (PII) zu vermeiden.
# PostgreSQL
**Anmerkung**
Der PostgreSQL-Konnektor wird für Bestandskunden bis zum 31. Mai 2026 weiterhin vollständig unterstützt. Dieser Konnektor ist zwar nicht mehr für neue Benutzer verfügbar, aktuelle Benutzer können ihn jedoch weiterhin ohne Unterbrechung verwenden. Wir entwickeln unser Konnektor-Portfolio kontinuierlich weiter, um besser skalierbare und anpassbare Lösungen anbieten zu können. Für future Integrationen empfehlen wir, sich mit dem Amazon Kendra Custom Connector Framework [1] vertraut zu machen, das ein breiteres Spektrum von Unternehmensanwendungsfällen mit verbesserter Flexibilität unterstützt.
PostgreSQL ist ein Open-Source-Datenbankmanagementsystem. Wenn Sie ein PostgreSQL Benutzer sind, können Sie Amazon Kendra damit Ihre PostgreSQL Datenquelle indizieren. Der Amazon Kendra PostgreSQL Datenquellenconnector unterstützt PostgreSQL 9.6.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die API eine Verbindung zu Ihrer PostgreSQL Datenquelle herstellen. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra PostgreSQL Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-postgresql)
+ [
## Voraussetzungen
](#prerequisites-postgresql)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-postgresql)
+ [
## Hinweise
](#postgresql-notes)
## Unterstützte Features
+ Feldzuordnungen
+ Filterung des Benutzerkontextes
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre PostgreSQL Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren Konten PostgreSQL und AWS Konten vor.
**Stellen Sie in PostgreSQL Folgendes sicher:**
+ Notieren Sie sich Ihren Datenbankbenutzernamen und Ihr Passwort.
**Wichtig**
Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Die URL, der Port und die Instanz Ihres Datenbank-Hosts wurden kopiert.
+ Vergewissert, dass jedes Dokument in PostgreSQL und zwischen anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen pro Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Wir haben Ihre PostgreSQL Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre PostgreSQL Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer PostgreSQL Datenquelle herzustellen, müssen Sie Details zu Ihren PostgreSQL Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben, Amazon Kendra finden Sie PostgreSQL weitere Informationen unter[Voraussetzungen](#prerequisites-postgresql).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen PostgreSQL**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **PostgreSQLConnector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **PostgreSQLConnector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. Geben Sie unter **Quelle** die folgenden Informationen ein:
1. **Host** — Geben Sie den Datenbank-Hostnamen ein.
1. **Port** — Geben Sie den Datenbankport ein.
1. **Instanz** — Geben Sie die Datenbankinstanz ein.
1. **Speicherort für SSL-Zertifikate aktivieren** — Geben Sie hier den Amazon S3 Pfad zu Ihrer SSL-Zertifikatsdatei ein.
1. Geben Sie im Feld **Authentifizierung** die folgenden Informationen ein:
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre PostgreSQL Authentifizierungsdaten zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra- PostgreSQL -' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Für **Datenbankbenutzername** und **Passwort** — Geben Sie die Werte der Authentifizierungsdaten ein, die Sie aus Ihrer Datenbank kopiert haben.
1. Wählen Sie **Speichern**.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Wählen Sie unter **Synchronisierungsbereich** aus den folgenden Optionen aus:
+ **SQL-Abfrage** – Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen ein. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Primärschlüsselspalte** – Geben Sie den Primärschlüssel für die Datenbanktabelle an. Dadurch wird eine Tabelle in Ihrer Datenbank identifiziert.
+ **Titelspalte** – Geben Sie den Namen der Titelspalte des Dokuments in Ihrer Datenbanktabelle ein.
+ **Hauptspalte** — Geben Sie den Namen der Textspalte des Dokuments in Ihrer Datenbanktabelle ein.
1. Wählen Sie **unter Zusätzliche Konfiguration — *optional*** aus den folgenden Optionen, um bestimmte Inhalte zu synchronisieren, anstatt alle Dateien zu synchronisieren:
+ **Spalten zur Erkennung von Änderungen** — Geben Sie die Namen der Spalten ein, anhand derer Inhaltsänderungen erkannt Amazon Kendra werden sollen. Amazon Kendraindexiert den Inhalt neu, wenn sich eine dieser Spalten ändert.
+ ** IDsSpalte „Benutzer“** — Geben Sie den Namen der Spalte ein, die den Benutzer enthält, dem der Zugriff auf IDs den Inhalt gewährt werden soll.
+ **Gruppenspalte** – Geben Sie den Namen der Spalte ein, die Gruppen enthält, denen Zugriff auf Inhalte gewährt werden soll.
+ ** URLsQuellspalte** — Geben Sie den Namen der Spalte ein, die die URLs zu indizierende Quelle enthält.
+ **Spalte mit Zeitstempeln** — Geben Sie den Namen der Spalte ein, die Zeitstempel enthält. Amazon Kendraverwendet Zeitstempelinformationen, um Änderungen an Ihren Inhalten zu erkennen und nur geänderte Inhalte zu synchronisieren.
+ **Zeitzonenspalte** – Geben Sie den Namen der Spalte ein, die Zeitzonen für den Inhalt enthält, der durchsucht werden soll.
+ **Zeitstempelformat** – Geben Sie den Namen der Spalte ein, die Zeitstempelformate enthält, die verwendet werden sollen, um Inhaltsänderungen zu erkennen und Ihre Inhalte erneut zu synchronisieren.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Im **Synchronisierungslaufplan** für **Frequenz** — Wie oft Amazon Kendra wird mit Ihrer Datenquelle synchronisiert?
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den generierten Standarddatenquellenfeldern — **Dokument IDs**, **Dokumenttitel** und **Quelle URLs** — aus, die Sie dem Index zuordnen möchten. Amazon Kendra
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen PostgreSQL**
Mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API müssen Sie Folgendes angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `JDBC` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Datenbanktyp** — Sie müssen den Datenbanktyp als `postgresql` angeben.
+ **SQL-Abfrage** — Geben Sie SQL-Abfrageanweisungen wie SELECT- und JOIN-Operationen an. SQL-Abfragen dürfen maximal 32 KB groß sein. Amazon Kendra durchsucht den gesamten Datenbankinhalt, der Ihrer Abfrage entspricht.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem PostgreSQL Konto erstellt haben. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"user name": "database user name",
"password": "password"
}
```
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (falls zutreffend) wiederzuverwenden.
+ **IAMRolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen Öffentlichkeit APIs für den PostgreSQL Connector und zu erteilen. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für PostgreSQL Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Sie können mithilfe von Benutzern, Gruppen IDs, Quellen, Zeitstempeln und Zeitzonen angeben URLs, ob bestimmte Inhalte eingeschlossen werden sollen.
+ **Benutzerkontextfilterung und Zugriffskontrolle** — Amazon Kendra durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre PostgreSQL Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter[PostgreSQL-Vorlagenschema](ds-schemas.md#ds-postgresql-schema).
------
## Hinweise
+ Gelöschte Datenbankzeilen werden nicht nachverfolgt, wenn nach Amazon Kendra aktualisierten Inhalten gesucht wird.
+ Die Größe von Feldnamen und Werten in einer Zeile Ihrer Datenbank darf 400 KB nicht überschreiten.
+ Wenn Ihre Datenbankdatenquelle eine große Datenmenge enthält und Sie nicht möchtenAmazon Kendra, dass Ihr gesamter Datenbankinhalt nach der ersten Synchronisierung indexiert wird, können Sie wählen, ob nur neue, geänderte oder gelöschte Dokumente synchronisiert werden sollen.
+ Es hat sich bewährt, nur lesbare Amazon Kendra Datenbankanmeldeinformationen zur Verfügung zu stellen.
+ Es hat sich bewährt, das Hinzufügen von Tabellen mit sensiblen Daten oder personenbezogenen Daten (PII) zu vermeiden.
# Quip
**Anmerkung**
Der Quip-Konnektor wird für Bestandskunden bis zum 31. Mai 2026 weiterhin vollständig unterstützt. Dieser Konnektor ist zwar nicht mehr für neue Benutzer verfügbar, aktuelle Benutzer können ihn jedoch weiterhin ohne Unterbrechung verwenden. Wir entwickeln unser Konnektor-Portfolio kontinuierlich weiter, um besser skalierbare und anpassbare Lösungen anbieten zu können. Für future Integrationen empfehlen wir, sich mit dem Amazon Kendra Custom Connector Framework [1] vertraut zu machen, das ein breiteres Spektrum von Unternehmensanwendungsfällen mit verbesserter Flexibilität unterstützt.
Quip ist eine Produktivitätssoftware für die Zusammenarbeit, die Funktionen für die Erstellung von Dokumenten in Echtzeit bietet. Sie können Amazon Kendra es verwenden, um Ihre Quip-Ordner, Dateien, Dateikommentare, Chatrooms und Anlagen zu indizieren.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die API eine Verbindung zu Ihrer Quip-Datenquelle herstellen. [QuipConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QuipConfiguration.html)
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Quip-Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-quip)
+ [
## Voraussetzungen
](#prerequisites-quip)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-quip)
+ [
## Weitere Informationen
](#quip-learn-more)
## Unterstützte Features
Amazon KendraDer Quip-Datenquellenconnector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Quip-Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihrem Quip und AWS Ihren Konten vor.
**Stellen Sie in Quip Folgendes sicher:**
+ Sie haben ein Quip-Konto mit Administratorberechtigungen.
+ Sie haben Quip-Authentifizierungsinformationen erstellt, die ein persönliches Zugriffstoken enthalten. Das Token wird als Ihre Anmeldedaten verwendet und geheim gespeichert. AWS Secrets Manager Weitere Informationen finden Sie in der [Quip-Dokumentation zur Authentifizierung](https://quip.com/dev/admin/documentation/current#section/Authentication).
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ Sie haben Ihre Quip-Site-Domain kopiert. *https://quip-company.quipdomain.com/browse*Wo *quipdomain* ist zum Beispiel die Domäne.
+ Vergewissert, dass jedes Dokument in Quip und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Wir haben Ihre Quip-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Quip-Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Quip-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Quip-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Wenn Sie Quip für Amazon Kendra noch nicht konfiguriert haben, finden Sie weitere Informationen unter. [Voraussetzungen](#prerequisites-quip)
------
#### [ Console ]
**So stellen Sie eine Verbindung Amazon Kendra zu Quip her**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Quip-Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Quip-Connector** mit dem Tag „V2.0".
1. Geben Sie auf der Seite **„Datenquellendetails angeben**“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Quip-Domainname — Geben Sie den Quip** ein, den Sie aus Ihrem Quip-Konto kopiert haben.
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Quip-Authentifizierungsdaten zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Quip-' wird Ihrem geheimen Namen automatisch hinzugefügt.
1. **Quip-Token — Geben Sie das für Quip** Personal Access konfigurierte Quip ein.
1. Fügen Sie Ihr Geheimnis hinzu und speichern Sie es.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. **Quip-Ordner IDs zum Crawlen hinzufügen — Der Quip-Ordner, den IDs Sie crawlen** möchten.
**Anmerkung**
Um einen Stammordner einschließlich aller darin enthaltenen Unterordner und Dokumente zu crawlen, fügen Sie die Stammordner-ID hinzu. Um bestimmte Unterordner zu crawlen, fügen Sie den jeweiligen Unterordner hinzu. IDs
1. **Zusätzliche Konfiguration (Inhaltstypen)** — Geben Sie die Inhaltstypen ein, die Sie crawlen möchten.
1. **Regex-Muster — Reguläre Ausdrucksmuster** zum Ein- oder Ausschließen bestimmter Dateien. Sie können bis zu 100 Muster hinzufügen.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Häufigkeit** aus, wie oft Ihre Datenquelleninhalte synchronisiert und Ihr Index aktualisiert werden soll
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den generierten Standard-Datenquellenfeldern aus, die Sie dem Index zuordnen möchtenAmazon Kendra.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra zu Quip herzustellen**
Mithilfe der [QuipConfiguration ](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QuipConfiguration.html)API müssen Sie Folgendes angeben:
+ **Quip-Site-Domain** — *https://quip-company.quipdomain.com/browse* Wo *quipdomain* ist zum Beispiel die Domain?
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Quip-Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"accessToken": "token"
}
```
+ **IAMrole** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis zu gewähren und die erforderliche Öffentlichkeit APIs für den Quip-Connector und aufzurufen. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für Quip-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie dies `VpcConfiguration` als Teil der Datenquellenkonfiguration an. Siehe [Konfiguration Amazon Kendra für die Verwendung einer VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob bestimmte Dateien ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Ordner** — Geben Sie die Quip-Ordner und Unterordner an, die Sie indizieren möchten
**Anmerkung**
Um einen Stammordner einschließlich aller darin enthaltenen Unterordner und Dokumente zu crawlen, geben Sie die Stammordner-ID ein. Um bestimmte Unterordner zu crawlen, fügen Sie den jeweiligen Unterordner hinzu. IDs
+ **Anlagen, Chatrooms, Dateikommentare** — Wählen Sie aus, ob das Crawlen von Anhängen, Chatroom-Inhalten und Dateikommentaren eingeschlossen werden soll.
+ **Benutzerkontextfilterung und Zugriffskontrolle** — Amazon Kendra durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Quip-Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer Quip-Datenquelle finden Sie unter:
+ [Suchen Sie mithilfe der intelligenten Suche mithilfe des Quip-Konnektors nach Wissen in Quip-Dokumenten für Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/search-for-knowledge-in-quip-documents-with-intelligent-search-using-the-quip-connector-for-amazon-kendra/)
# Salesforce
Salesforce ist ein Customer Relationship Management (CRM)-Tool zur Verwaltung von Support-, Vertriebs- und Marketingteams. Sie können Amazon Kendra damit Ihre Salesforce-Standardobjekte und sogar benutzerdefinierte Objekte indizieren.
Sie können entweder über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/), die API oder die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer Salesforce-Datenquelle herstellen. [SalesforceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SalesforceConfiguration.html)
Amazon Kendrahat zwei Versionen des Salesforce-Connectors. Zu den unterstützten Funktionen jeder Version gehören:
**Salesforce-Konnektor V1.0//API [SalesforceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SalesforceConfiguration.html)**
+ Feldzuordnungen
+ Kontrolle des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
**Salesforce-Konnektor V2.0//API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)**
+ Feldzuordnungen
+ Kontrolle des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
**Anmerkung**
Salesforce Connector V1.0/ SalesforceConfiguration API endete 2023. Wir empfehlen, zu Salesforce Connector V2.0/ API zu migrieren oder diese zu verwenden. TemplateConfiguration
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Salesforce-Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
# Salesforce-Konnektor V1.0
](data-source-v1-salesforce.md)
+ [
# Salesforce-Konnektor V2.0
](data-source-v2-salesforce.md)
# Salesforce-Konnektor V1.0
Salesforce ist ein Customer Relationship Management (CRM)-Tool zur Verwaltung von Support-, Vertriebs- und Marketingteams. Sie können Amazon Kendra damit Ihre Salesforce-Standardobjekte und sogar benutzerdefinierte Objekte indizieren.
**Wichtig**
Amazon Kendraverwendet die Salesforce-API-Version 48. Die Salesforce-API begrenzt die Anzahl der Anfragen, die Sie pro Tag stellen können. Wenn Salesforce diese Anfragen überschreitet, versucht es erneut, bis es fortfahren kann.
**Anmerkung**
Salesforce Connector SalesforceConfiguration V1.0/API endete 2023. Wir empfehlen, zu Salesforce Connector V2.0/ API zu migrieren oder diese zu verwenden. TemplateConfiguration
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Salesforce-Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-v1-salesforce)
+ [
## Voraussetzungen
](#prerequisites-v1-salesforce)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-v1-salesforce)
## Unterstützte Features
Amazon KendraDer Salesforce-Datenquellen-Connector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
## Voraussetzungen
Bevor Sie Ihre Salesforce-Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihrem Salesforce und Ihren AWS Accounts vor.
**Stellen Sie in Salesforce sicher, dass Sie über Folgendes verfügen:**
+ Sie haben ein Salesforce-Konto erstellt und den Benutzernamen und das Passwort notiert, die Sie für die Verbindung mit Salesforce verwenden.
+ Sie haben ein Salesforce Connected App-Konto mit OAuth aktiviertem Konto erstellt und den Verbraucherschlüssel (Client-ID) und das Verbrauchergeheimnis (Kundengeheimnis) kopiert, die Ihrer Salesforce Connected-Anwendung zugewiesen sind. Die Client-ID und der geheime Kundenschlüssel werden als Ihre in einem AWS Secrets Manager Secret gespeicherten Authentifizierungsdaten verwendet. Weitere Informationen finden Sie [in der Salesforce-Dokumentation zu verbundenen Anwendungen](https://help.salesforce.com/s/articleView?id=sf.connected_app_overview.htm&type=5).
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ Das Salesforce-Sicherheitstoken wurde kopiert, das dem Konto zugeordnet ist, das für die Verbindung mit Salesforce verwendet wurde.
+ Die URL der Salesforce-Instanz, die Sie indexieren möchten, wurde kopiert. Dabei handelt es sich in der Regel um *https://.salesforce.com/*. Der Server muss eine mit Salesforce verbundene Anwendung ausführen.
+ Ihrem Salesforce-Server wurden Anmeldeinformationen für einen Benutzer mit Lesezugriff auf Salesforce hinzugefügt, indem Sie das ReadOnly Profil geklont und anschließend die Berechtigungen „Alle Daten anzeigen“ und „Artikel verwalten“ hinzugefügt haben. Diese Anmeldeinformationen identifizieren den Benutzer, der die Verbindung herstellt, und die verbundene Salesforce-Anwendung, Amazon Kendra mit der eine Verbindung hergestellt wird.
+ Aktiviert, dass jedes Dokument in Salesforce und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen pro Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Ihre Salesforce-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Salesforce-Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Salesforce-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Salesforce-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie Salesforce noch nicht konfiguriert haben, Amazon Kendra sehen Sie nach[Voraussetzungen](#prerequisites-v1-salesforce).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra zu Salesforce herzustellen**
1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Salesforce Connector V1.0** und dann **Connector hinzufügen** aus.
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. **Datenquellenname** — Geben Sie einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. **Standardsprache** — Eine Sprache, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. **Neues Tag hinzufügen** — Stichwörter, mit denen du deine Ressourcen durchsuchen und filtern oder deine gemeinsamen Kosten verfolgen kannst.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Salesforce-URL** — Geben Sie die Instanz-URL für die Salesforce-Site ein, die Sie indexieren möchten.
1. Wählen Sie unter **Authentifizierungstyp** zwischen „Bestehend“ und **„****Neu**“, um Ihre Salesforce-Authentifizierungsdaten zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Salesforce-' wird Ihrem geheimen Namen automatisch hinzugefügt.
1. Geben Sie für **Benutzername**, **Passwort**, **Sicherheitstoken**, **Verbraucherschlüssel, **Verbrauchergeheimnis**** und **Authentifizierungs-URL die Werte für die Authentifizierungsdaten** ein, die Sie in Ihrem Salesforce-Konto erstellt haben.
1. Wählen Sie Authentifizierung **speichern** aus.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Für **Crawl-Anlagen** — Wählen Sie diese Option, um alle angehängten Objekte, Artikel und Feeds zu crawlen.
1. Wählen Sie für **Standardobjekte**, **Knowledge-Artikel** und **Chatter-Feeds** die Salesforce-Entitäten oder Inhaltstypen aus, die Sie crawlen möchten.
**Anmerkung**
Sie müssen Konfigurationsinformationen für die Indexierung mindestens eines der Standardobjekte, Knowledge-Artikel oder Chatter-Feeds angeben. Wenn Sie **Knowledge-Artikel** crawlen möchten, müssen Sie die Typen der zu indexierenden Knowledge-Artikel und den Namen der Artikel angeben und festlegen, ob die Standardfelder aller Knowledge-Artikel oder nur die Felder eines benutzerdefinierten Artikeltyps indexiert werden sollen. Wenn Sie benutzerdefinierte Artikel indexieren möchten, müssen Sie den internen Namen des Artikeltyps angeben. Sie können bis zu 10 Artikeltypen angeben.
1. **Häufigkeit** — Wie oft Amazon Kendra wird mit Ihrer Datenquelle synchronisiert.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Für den **Artikel Standardwissen**, **Standardobjektanhänge** und **Zusätzliche vorgeschlagene Feldzuordnungen** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
**Anmerkung**
Eine Indexzuordnung zu `_document_body` ist erforderlich. Sie können die Zuordnung zwischen dem `Salesforce ID` Feld und dem Amazon Kendra `_document_id ` Feld nicht ändern.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra zu Salesforce herzustellen**
Sie müssen die folgende [SalesforceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SalesforceConfiguration.html)API angeben:
+ **Server-URL** — Die Instanz-URL für die Salesforce-Site, die Sie indizieren möchten.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Salesforce-Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"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"
}
```
+ **IAMRolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und das Aufrufen der erforderlichen Öffentlichkeit APIs für den Salesforce-Connector und Amazon Kendra zu erteilen. Weitere Informationen finden Sie unter [IAMRollen für Salesforce-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
+ Sie müssen Konfigurationsinformationen für die Indexierung mindestens eines der Standardobjekte, Knowledge-Artikel oder Chatter-Feeds angeben.
+ **Standardobjekte** — Wenn Sie **Standardobjekte** crawlen möchten, müssen Sie den Namen des Standardobjekts und den Namen des Felds in der Standardobjekttabelle angeben, das den Dokumentinhalt enthält.
+ **Knowledge-Artikel** — Wenn Sie **Knowledge-Artikel** crawlen möchten, müssen Sie die Typen der zu indizierenden Wissensartikel, den Status der zu indizierenden Wissensartikel und angeben, ob die Standardfelder aller Wissensartikel oder nur die Felder eines benutzerdefinierten Artikeltyps indexiert werden sollen.
+ **Chatter-Feeds** — Wenn Sie **Chatter-Feeds** crawlen möchten, müssen Sie den Namen der Spalte in der FeedItem Salesforce-Tabelle angeben, die den zu indizierenden Inhalt enthält.
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob bestimmte Dateianhänge ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Salesforce-Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
+ **Benutzerkontextfilterung und Zugriffskontrolle** Amazon Kendra — durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
------
# Salesforce-Konnektor V2.0
Salesforce ist ein Customer Relationship Management (CRM)-Tool zur Verwaltung von Support-, Vertriebs- und Marketingteams. Sie können Amazon Kendra damit Ihre Salesforce-Standardobjekte und sogar benutzerdefinierte Objekte indizieren.
Der Amazon Kendra Salesforce-Datenquellen-Connector unterstützt die folgenden Salesforce-Editionen: Developer Edition und Enterprise Edition.
**Anmerkung**
Salesforce Connector V1.0/ SalesforceConfiguration API endete 2023. Wir empfehlen, zu Salesforce Connector V2.0/ API zu migrieren oder diese zu verwenden. TemplateConfiguration
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Salesforce-Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-v2-salesforce)
+ [
## Voraussetzungen
](#prerequisites-v2-salesforce)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-v2-salesforce)
+ [
## Weitere Informationen
](#salesforce-v2-learn-more)
+ [
## Hinweise
](#salesforce-notes)
## Unterstützte Features
Amazon KendraDer Salesforce-Datenquellen-Connector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Salesforce-Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihrem Salesforce und AWS Ihren Accounts vor.
**Stellen Sie in Salesforce sicher, dass Sie über Folgendes verfügen:**
+ Sie haben ein Salesforce-Administratorkonto erstellt und sich den Benutzernamen und das Passwort notiert, die Sie für die Verbindung mit Salesforce verwenden.
+ Das Salesforce-Sicherheitstoken wurde kopiert, das dem Konto zugeordnet ist, das für die Verbindung mit Salesforce verwendet wurde.
+ Sie haben ein Salesforce Connected App-Konto mit OAuth aktiviertem Konto erstellt und den Verbraucherschlüssel (Client-ID) und das Verbrauchergeheimnis (Kundengeheimnis) kopiert, die Ihrer Salesforce Connected-Anwendung zugewiesen sind. Die Client-ID und der geheime Kundenschlüssel werden als Ihre in einem AWS Secrets Manager Secret gespeicherten Authentifizierungsdaten verwendet. Weitere Informationen finden Sie [in der Salesforce-Dokumentation zu verbundenen Anwendungen](https://help.salesforce.com/s/articleView?id=sf.connected_app_overview.htm&type=5).
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ Die URL der Salesforce-Instanz, die Sie indizieren möchten, wurde kopiert. Dabei handelt es sich in der Regel um *https://.salesforce.com/*. Der Server muss eine mit Salesforce verbundene Anwendung ausführen.
+ Ihrem Salesforce-Server wurden Anmeldeinformationen für einen Benutzer mit Lesezugriff auf Salesforce hinzugefügt, indem Sie das ReadOnly Profil geklont und anschließend die Berechtigungen „Alle Daten anzeigen“ und „Artikel verwalten“ hinzugefügt haben. Diese Anmeldeinformationen identifizieren den Benutzer, der die Verbindung herstellt, und die verbundene Salesforce-Anwendung, Amazon Kendra mit der eine Verbindung hergestellt wird.
+ Aktiviert, dass jedes Dokument in Salesforce und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen pro Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Ihre Salesforce-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Salesforce-Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Salesforce-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Salesforce-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie Salesforce noch nicht konfiguriert haben, Amazon Kendra sehen Sie nach[Voraussetzungen](#prerequisites-v2-salesforce).
------
#### [ Console ]
**So stellen Sie eine Verbindung Amazon Kendra zu Salesforce** her:
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Salesforce-Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie **Salesforce-Connector** mit dem Tag „V2.0" aus.
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Salesforce-URL** — Geben Sie die Instanz-URL für die Salesforce-Site ein, die Sie indexieren möchten.
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. Geben Sie ein vorhandenes Geheimnis ein, oder wenn Sie ein neues Geheimnis erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. **Authentifizierung** — Geben Sie die folgenden Informationen in das **Fenster AWS Secrets Manager Geheimes Konto erstellen ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Salesforce-' wird Ihrem geheimen Namen automatisch hinzugefügt.
1. Geben Sie für **Benutzername**, **Passwort**, **Sicherheitstoken**, **Verbraucherschlüssel, **Verbrauchergeheimnis**** und **Authentifizierungs-URL die Werte für die Authentifizierungsdaten** ein, die Sie generiert und von Ihrem Salesforce-Konto heruntergeladen haben.
**Anmerkung**
Wenn Sie die Salesforce Developer Edition verwenden, verwenden Sie `https://login.salesforce.com/services/oauth2/token` oder die Anmelde-URL „Meine Domäne“ (z. B.* https://MyCompany.my.salesforce.com*) als **Authentifizierungs-URL**. Wenn Sie Salesforce Sandbox Edition verwenden, verwenden Sie `https://test.salesforce.com/services/oauth2/token ` oder die Anmelde-URL „Meine Domäne“ (z. B.* MyDomainName--SandboxName.sandbox.my.salesforce.com*) als **Authentifizierungs-URL**.
1. Wählen Sie **Authentifizierung speichern** aus.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und sich dafür entscheiden, Ihre ACL zu verwenden, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Für **Crawl-Anlagen** — Wählen Sie diese Option, um alle angehängten Salesforce-Objekte zu crawlen.
1. Für **Standardobjekte**, **Standardobjekte mit Anlagen** und **Standardobjekte ohne Anlage** und **Knowledge-Artikel**: Wählen Sie Salesforce-Entitäten oder Inhaltstypen aus, die Sie crawlen möchten.
1. Sie müssen Konfigurationsinformationen für die Indexierung mindestens eines der Standardobjekte, Knowledge-Artikel oder Chatter-Feeds angeben. Wenn Sie Knowledge-Artikel crawlen möchten, müssen Sie die Typen von **Wissensartikeln** angeben, die indexiert werden sollen. Sie können zwischen veröffentlichten, archivierten, Entwürfen und Anhängen wählen.
**Regex-Filter** — Geben Sie ein Regex-Muster an, um bestimmte Katalogelemente einzubeziehen.
1. **Für** zusätzliche Konfigurationen:
+ **ACL-Informationen** Alle Zugriffskontrolllisten sind standardmäßig enthalten. Wenn Sie die Auswahl einer Zugriffskontrollliste aufheben, werden alle Dateien in dieser Kategorie öffentlich zugänglich gemacht.
+ **Regex-Muster — Fügen Sie Muster** für reguläre Ausdrücke hinzu, um bestimmte Dateien ein- oder auszuschließen. Sie können bis zu 100 Muster hinzufügen.
**Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Für den **Artikel Standardwissen**, **Standardobjektanhänge** und **Zusätzliche vorgeschlagene Feldzuordnungen** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
**Anmerkung**
Eine Indexzuordnung zu `_document_body` ist erforderlich. Sie können die Zuordnung zwischen dem `Salesforce ID` Feld und dem Amazon Kendra `_document_id ` Feld nicht ändern. Sie können jedes Salesforce-Feld den Amazon Kendra reserved/default Kendra-Indexfeldern für den Dokumenttitel oder den Hauptteil des Dokuments zuordnen.
Wenn Sie ein Salesforce-Feld den Feldern Dokumenttitel und Dokumenttext von Amazon Kendra zuordnen, verwendet Amazon Kendra Daten aus den Feldern Dokumenttitel und Textkörper in den Suchantworten.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra zu Salesforce herzustellen**
Sie müssen mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API ein JSON des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `SALESFORCEV2` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Host-URL** — Geben Sie die Host-URL der Salesforce-Instanz an.
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Salesforce-Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"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"
}
```
+ **IAMRolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und das Aufrufen der erforderlichen Öffentlichkeit APIs für den Salesforce-Connector und Amazon Kendra zu erteilen. Weitere Informationen finden Sie unter [IAMRollen für Salesforce-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Sie können angeben, ob bestimmte Dokumente, Konten, Kampagnen, Kundenvorgänge, Kontakte, Leads, Opportunities, Lösungen, Aufgaben, Gruppen, Chatter und benutzerdefinierte Entitätsdateien ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und sich dafür entscheiden, Ihre ACL zu verwenden, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
+ **Feldzuordnungen** — Wählen Sie, ob Sie Ihre Salesforce-Datenquellenfelder Ihren Indexfeldern zuordnen möchten. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
**Anmerkung**
Eine Indexzuordnung zu `_document_body` ist erforderlich. Sie können die Zuordnung zwischen dem `Salesforce ID` Feld und dem Amazon Kendra `_document_id ` Feld nicht ändern. Sie können jedes Salesforce-Feld den Amazon Kendra reserved/default Kendra-Indexfeldern für den Dokumenttitel oder den Hauptteil des Dokuments zuordnen.
Wenn Sie ein Salesforce-Feld den Feldern Dokumenttitel und Dokumenttext von Amazon Kendra zuordnen, verwendet Amazon Kendra Daten aus den Feldern Dokumenttitel und Textkörper in den Suchantworten.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [Salesforce-Vorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-salesforce-schema).
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer Salesforce-Datenquelle finden Sie unter:
+ [Ankündigung des aktualisierten Salesforce-Connectors (V2) für Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/announcing-the-updated-salesforce-connector-v2-for-amazon-kendra/)
## Hinweise
+ Wenn Zugriffskontrolllisten (ACLs) aktiviert sind, ist die Option „Nur neue oder geänderte Inhalte synchronisieren“ aufgrund von Einschränkungen der Salesforce-API nicht verfügbar. Wir empfehlen, stattdessen die Modi „Vollständige Synchronisierung“ oder „Neue, geänderte oder gelöschte Inhaltssynchronisierung“ zu verwenden oder sie zu deaktivieren, ACLs falls Sie diesen Synchronisierungsmodus verwenden müssen.
# ServiceNow
ServiceNow bietet ein cloudbasiertes Servicemanagementsystem zur Erstellung und Verwaltung von Workflows auf Organisationsebene, z. B. für IT-Services, Ticketsysteme und Support. Sie können Amazon Kendra es verwenden, um Ihre ServiceNow Kataloge, Wissensartikel, Vorfälle und deren Anlagen zu indizieren.
Sie können entweder über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/), die API oder die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API eine Verbindung zu Ihrer ServiceNow Datenquelle herstellen. [ServiceNowConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ServiceNowConfiguration.html)
Amazon Kendrahat zwei Versionen des ServiceNow Connectors. Zu den unterstützten Funktionen jeder Version gehören:
**ServiceNow Konnektor V1.0//API [ServiceNowConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ServiceNowConfiguration.html)**
+ Feldzuordnungen
+ ServiceNow Instanzversionen: London, Andere
+ Einschluss- und Ausschlussfilter
**ServiceNow Konnektor V2.0/API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)**
+ Feldzuordnungen
+ Kontrolle des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ ServiceNow Instanzversionen: Rom, Sandiego, Tokio, Andere
+ Virtual Private Cloud (VPC)
**Anmerkung**
ServiceNow Connector V1.0/ ServiceNowConfiguration API endete 2023. Wir empfehlen, zu ServiceNow Connector V2.0/ API zu migrieren oder diesen zu verwenden. TemplateConfiguration
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra ServiceNow Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
# ServiceNow Konnektor V1.0
](data-source-v1-servicenow.md)
+ [
# ServiceNow Anschluss V2.0
](data-source-v2-servicenow.md)
+ [
# Angeben von Dokumenten, die mit einer Abfrage indexiert werden sollen
](servicenow-query.md)
# ServiceNow Konnektor V1.0
ServiceNow bietet ein cloudbasiertes Servicemanagementsystem zur Erstellung und Verwaltung von Workflows auf Organisationsebene, z. B. für IT-Services, Ticketsysteme und Support. Sie können Amazon Kendra es verwenden, um Ihre ServiceNow Kataloge, Wissensartikel und deren Anlagen zu indizieren.
**Anmerkung**
ServiceNow Connector V1.0/ ServiceNowConfiguration API endete 2023. Wir empfehlen, zu ServiceNow Connector V2.0/ API zu migrieren oder diesen zu verwenden. TemplateConfiguration
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra ServiceNow Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-v1-servicenow)
+ [
## Voraussetzungen
](#prerequisites-v1-servicenow)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-v1-servicenow)
+ [
## Weitere Informationen
](#servicenow-v1-learn-more)
## Unterstützte Features
Amazon KendraServiceNow Ein Datenquellenconnector unterstützt die folgenden Funktionen:
+ ServiceNow Instanzversionen: London, Andere
+ Muster von Inklusionen/Ausschlüssen: Servicekataloge, Wissensartikel und deren Anlagen
## Voraussetzungen
Bevor Sie Ihre ServiceNow Datenquelle Amazon Kendra zum Indizieren verwenden können, müssen Sie diese Änderungen in Ihren Konten und Konten vornehmen. ServiceNow AWS
**Stellen Sie sicher ServiceNow, dass Sie Folgendes haben:**
+ Sie haben ein ServiceNow Administratorkonto erstellt und eine ServiceNow Instanz erstellt.
+ Der Host Ihrer ServiceNow Instanz-URL wurde kopiert. Wenn die URL der Instanz beispielsweise lautet*https://your-domain.service-now.com*, lautet das Format für die Host-URL, die Sie eingeben*your-domain.service-now.com*.
+ Haben Sie Ihre Basisauthentifizierungsdaten notiert, die einen Benutzernamen und ein Passwort enthalten, Amazon Kendra um eine Verbindung zu Ihrer ServiceNow Instance herzustellen.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ **Optional: Es** wurde ein OAuth 2.0-Anmeldeinformationstoken konfiguriert, das einen Benutzernamen, ein Passwort, eine Client-ID Amazon Kendra und einen geheimen Clientschlüssel identifizieren und generieren kann. Der Benutzername und das Passwort müssen den Zugriff auf die ServiceNow Wissensdatenbank und den Servicekatalog ermöglichen. Weitere Informationen finden Sie in [der ServiceNow Dokumentation zur OAuth 2.0-Authentifizierung](https://www.servicenow.com/docs/bundle/utah-platform-security/page/integrate/single-sign-on/concept/c_Authentication.html).
+ Die folgenden Berechtigungen wurden hinzugefügt:
+ kb\$1category
+ kb\$1knowledge
+ kb\$1knowledge\$1base
+ kb\$1uc\$1kann\$1mtom nicht\$1lesen
+ kb\$1uc\$1can\$1read\$1mtom
+ sc\$1catalog
+ sc\$1category
+ sc\$1cat\$1item
+ sys\$1attachment
+ sys\$1anhang\$1doc
+ sys\$1user\$1role
+ Vergewissert, dass jedes Dokument in ServiceNow und zwischen anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Wir haben Ihre ServiceNow Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre ServiceNow Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Amazon KendraUm eine Verbindung mit Ihrer ServiceNow Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer ServiceNow Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben, Amazon Kendra finden Sie ServiceNow weitere Informationen unter[Voraussetzungen](#prerequisites-v1-servicenow).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen ServiceNow**
1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **ServiceNowConnector V1.0** und dann **Datenquelle hinzufügen** aus.
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **ServiceNow host** — Geben Sie die ServiceNow Host-URL ein.
1. **ServiceNow Version** — Wählen Sie Ihre ServiceNow Version aus.
1. Wählen Sie je nach Anwendungsfall zwischen **Standardauthentifizierung** und **OAuth 2.0-Authentifizierung**.
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre ServiceNow Authentifizierungsdaten zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra- ServiceNow -' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Wenn Sie die Standardauthentifizierung verwenden — Geben Sie den **geheimen Namen**, den **Benutzernamen** und das **Passwort** für Ihr Konto ein. ServiceNow
Wenn Sie die OAuth2 Authentifizierung verwenden — Geben Sie den **geheimen Namen**, den **Benutzernamen**, das **Passwort**, die **Client-ID** und das geheime **Kundengeheimnis ein, die Sie in Ihrem Konto erstellt** haben. ServiceNow
1. Wählen Sie **Speichern und Secret hinzufügen** aus.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. **Wissensartikel einbeziehen** — Wählen Sie diese Option, um Wissensartikel zu indizieren.
1. **Art der Wissensartikel** — Wählen Sie je nach Anwendungsfall zwischen **Nur öffentliche Artikel** **einbeziehen und Artikel anhand einer ServiceNow Filterabfrage** einbeziehen. Wenn Sie **Artikel basierend auf einer ServiceNow Filterabfrage einbeziehen** auswählen, müssen Sie eine aus Ihrem ServiceNow Konto kopierte **Filterabfrage** eingeben.
1. Anlagen zu **Wissensartikeln einbeziehen — Wählen Sie diese Option, um Anlagen** zu Wissensartikeln zu indizieren. Sie können auch bestimmte Dateitypen für die Indizierung auswählen.
1. **Katalogelemente einbeziehen** — Wählen Sie diese Option, um Katalogelemente zu indizieren.
1. Anlagen zu **Katalogelementen einbeziehen — Wählen Sie diese Option, um die Anhänge** von Katalogelementen zu indizieren. Sie können auch bestimmte Dateitypen für die Indizierung auswählen.
1. **Häufigkeit** — Wie oft Amazon Kendra wird die Synchronisierung mit Ihrer Datenquelle durchgeführt?
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Knowledge-Artikel** und **Servicekatalog** — Wählen Sie aus den Amazon Kendra generierten Standard-Datenquellenfeldern und weiteren vorgeschlagenen Feldzuordnungen aus, die Sie Ihrem Index zuordnen möchten.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen ServiceNow**
Mithilfe der [ServiceNowConfiguration API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ServiceNowConfiguration.html) müssen Sie Folgendes angeben:
+ **Datenquellen-URL** — Geben Sie die ServiceNow URL an. Der Host-Endpunkt sollte wie folgt aussehen:*your-domain.service-now.com*.
+ **Hostinstanz der Datenquelle** — Geben Sie die Version der ServiceNow Host-Instanz entweder als `LONDON` oder `OTHERS` an.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem ServiceNow Konto erstellt haben.
Wenn Sie die Standardauthentifizierung verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"username": "user name",
"password": "password"
}
```
Wenn Sie die OAuth2 Authentifizierung verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"username": "user name",
"password": "password",
"clientId": "client id",
"clientSecret": "client secret"
}
```
+ **IAMrole** — Geben Sie an`RoleArn`, wann Sie aufrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen öffentlichen Daten APIs für den ServiceNow Connector und Amazon Kendra zu erteilen. Weitere Informationen finden Sie unter [IAMRollen für ServiceNow Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre ServiceNow Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob bestimmte Dateianhänge von Katalogen und Wissensartikeln ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Indizierungsparameter** — Sie können auch angeben, ob Sie:
+ Indexieren Sie Wissensartikel und Servicekataloge oder beides. Wenn Sie Wissensartikel und Servicekatalogelemente indizieren möchten, müssen Sie den Namen des Felds angeben, das dem ServiceNow Inhaltsfeld des Indexdokuments im Amazon Kendra Index zugeordnet ist.
+ Indizieren Sie Anlagen zu Wissensartikeln und Katalogelementen.
+ Verwenden Sie eine ServiceNow Abfrage, die Dokumente aus einer oder mehreren Wissensdatenbanken auswählt. Die Wissensdatenbanken können öffentlich oder privat sein. Weitere Informationen finden Sie unter [Angeben von Dokumenten für die Indexierung mit einer Abfrage](https://docs.aws.amazon.com/kendra/latest/dg/servicenow-query.html).
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer ServiceNow Datenquelle finden Sie unter:
+ [Erste Schritte mit dem Amazon Kendra ServiceNow Online Connector](https://aws.amazon.com/blogs/machine-learning/getting-started-with-amazon-kendra-servicenow-online-connector/)
# ServiceNow Anschluss V2.0
ServiceNow bietet ein cloudbasiertes Servicemanagementsystem zur Erstellung und Verwaltung von Workflows auf Organisationsebene, z. B. für IT-Services, Ticketsysteme und Support. Sie können Amazon Kendra es verwenden, um Ihre ServiceNow Kataloge, Wissensartikel, Vorfälle und deren Anlagen zu indizieren.
Informationen zur Problembehandlung Ihres Amazon Kendra ServiceNow Datenquellen-Connectors finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [
## Unterstützte Features
](#supported-features-v2-servicenow)
+ [
## Voraussetzungen
](#prerequisites-v2-servicenow)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-v2-servicenow)
+ [
## Weitere Informationen
](#servicenow-learn-more)
## Unterstützte Features
Amazon KendraServiceNow Ein Datenquellenconnector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ ServiceNow Instanzversionen: Rom, Sandiego, Tokio, Andere
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre ServiceNow Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihren AWS Konten ServiceNow und Konten vor.
**Stellen Sie sicher ServiceNow, dass Sie Folgendes haben:**
+ Sie haben eine Personal- oder Enterprise-Developer-Instance erstellt und verfügen über eine ServiceNow-Instance mit Administratorrolle.
+ Der Host Ihrer ServiceNow Instanz-URL wurde kopiert. Das Format für die Host-URL, die Sie eingeben, ist*your-domain.service-now.com*. Sie benötigen Ihre ServiceNow -Instance-URL, um eine Verbindung mit Amazon Kendra herzustellen.
+ Notiert Ihre grundlegenden Authentifizierungsdaten, bestehend aus einem Benutzernamen und einem Passwort, um eine Verbindung Amazon Kendra zu Ihrer ServiceNow Instance herstellen zu können.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ **Optional:** Konfigurierte OAuth 2.0-Client-Anmeldeinformationen, die Amazon Kendra anhand eines Benutzernamens, eines Kennworts und einer generierten Client-ID sowie eines geheimen Client-Schlüssels identifiziert werden können. Weitere Informationen finden Sie in [der ServiceNow Dokumentation zur OAuth 2.0-Authentifizierung](https://www.servicenow.com/docs/bundle/utah-platform-security/page/integrate/single-sign-on/concept/c_Authentication.html).
+ Die folgenden Berechtigungen wurden hinzugefügt:
+ kb\$1category
+ kb\$1knowledge
+ kb\$1knowledge\$1base
+ kb\$1uc\$1kann\$1mtom nicht\$1lesen
+ kb\$1uc\$1can\$1read\$1mtom
+ sc\$1catalog
+ sc\$1category
+ sc\$1cat\$1item
+ sys\$1attachment
+ sys\$1anhang\$1doc
+ sys\$1user\$1role
+ Vergewissert, dass jedes Dokument in ServiceNow und zwischen anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Wir haben Ihre ServiceNow Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre ServiceNow Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Amazon KendraUm eine Verbindung mit Ihrer ServiceNow Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer ServiceNow Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert haben, Amazon Kendra finden Sie ServiceNow weitere Informationen unter[Voraussetzungen](#prerequisites-v2-servicenow).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra herzustellen ServiceNow**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **ServiceNow Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **ServiceNow Connector** mit dem Tag „V2.0".
1. **Geben Sie auf der Seite „Datenquellendetails** angeben“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **ServiceNow host** — Geben Sie die ServiceNow Host-URL ein. Das Format für die Host-URL, die Sie eingeben, ist*your-domain.service-now.com*.
1. **ServiceNow Version** — Wählen Sie Ihre ServiceNow Instanzversion aus. Sie können zwischen Rom, Sandiego, Tokio oder anderen wählen.
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **Authentifizierung** — Wählen Sie zwischen **Standardauthentifizierung und **OAuth 2.0-Authentifizierung****.
1. **AWSSecrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Authentifizierungsdaten zu speichern. ServiceNow Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet. Geben Sie die folgenden Informationen in das Fenster ein:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra- ServiceNow -' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Wenn Sie die Standardauthentifizierung verwenden — Geben Sie den **geheimen Namen**, den **Benutzernamen** und das **Passwort** für Ihr Konto ein. ServiceNow
**Wenn Sie die OAuth2 0.0-Authentifizierung verwenden, geben Sie den **geheimen Namen**, den **Benutzernamen**, das **Passwort, die **Client-ID und das geheime Client-Geheimnis** ein**, die Sie in Ihrem Konto erstellt haben.** ServiceNow
1. Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) der Suchergebnisse zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Wählen Sie unter **Wissensartikel** aus den folgenden Optionen aus:
+ **Wissensartikel** — Wählen Sie diese Option, um Wissensartikel zu indizieren.
+ Anlagen zu **Wissensartikeln — Wählen Sie diese Option, um die Anhänge** von Wissensartikeln zu indizieren.
+ **Art der Wissensartikel** — Wählen Sie **je nach **Anwendungsfall zwischen Nur öffentliche Artikel** und Knowledge-Artikel basierend auf einer ServiceNow Filterabfrage**. Wenn Sie **Artikel basierend auf einer ServiceNow Filterabfrage einbeziehen** auswählen, müssen Sie eine aus Ihrem ServiceNow Konto kopierte **Filterabfrage** eingeben. Zu den Filterabfragen gehören beispielsweise:*workflow\$1state=draft^EQ*,*kb\$1knowledge\$1base=dfc19531bf2021003f07e2c1ac0739ab^text ISNOTEMPTY^EQ*,*article\$1type=text^active=true^EQ*.
**Wichtig**
Wenn Sie **nur öffentliche Artikel crawlen möchten, werden nur Wissensartikel** Amazon Kendra gecrawlt, denen eine öffentliche Zugriffsrolle zugewiesen wurde. ServiceNow
+ **Artikel basierend auf dem Kurzbeschreibungsfilter einbeziehen** — Geben Sie Muster für reguläre Ausdrücke an, um bestimmte Artikel ein- oder auszuschließen.
1. Für **Servicekatalogelemente**:
+ **Servicekatalogelemente** — Wählen Sie diese Option, um Servicekatalogelemente zu indizieren.
+ Anlagen von **Servicekatalogelementen — Wählen Sie diese Option, um die Anhänge** von Servicekatalogelementen zu indizieren.
+ **Aktive Servicekatalogelemente** — Wählen Sie diese Option, um aktive Servicekatalogelemente zu indizieren.
+ **Inaktive Servicekatalogelemente** — Wählen Sie diese Option, um inaktive Servicekatalogelemente zu indizieren.
+ **Filterabfrage** — Wählen Sie aus, ob Servicekatalogelemente auf der Grundlage eines in Ihrer ServiceNow Instanz definierten Filters aufgenommen werden sollen. Zu den Beispielfilterabfragen gehören:*short\$1descriptionLIKEAccess^category=2809952237b1300054b6a3549dbe5dd4^EQ*,*nameSTARTSWITHService^active=true^EQ*.
+ **Servicekatalogelemente basierend auf dem Kurzbeschreibungsfilter einbeziehen** — Geben Sie ein Regex-Muster an, um bestimmte Katalogelemente einzubeziehen.
1. Für **Vorfälle**:
+ **Vorfälle** — Wählen Sie diese Option, um Service-Vorfälle zu indizieren.
+ **Vorfallsanhänge** — Wählen Sie diese Option, um Vorfallanhänge zu indizieren.
+ **Aktive Vorfälle** — Wählen Sie diese Option, um aktive Vorfälle zu indizieren.
+ **Inaktive Vorfälle** — Wählen Sie diese Option, um inaktive Vorfälle zu indizieren.
+ **Aktiver Vorfalltyp** — Wählen Sie je nach Anwendungsfall zwischen **Alle Incidents****, Open Incidents****, Offen — nicht zugewiesene Incidents** **und Behobene Incidents**.
+ **Filterabfrage** — Wählen Sie aus, ob Vorfälle auf der Grundlage eines in Ihrer Instanz definierten Filters eingeschlossen werden sollen. ServiceNow Zu den Beispielfilterabfragen gehören:*short\$1descriptionLIKETest^urgency=3^state=1^EQ*,*priority=2^category=software^EQ *.
+ **Vorfälle basierend auf dem Kurzbeschreibungsfilter einbeziehen** — Geben Sie ein Regex-Muster an, um bestimmte Vorfälle einzubeziehen.
1. **Für zusätzliche Konfigurationen:**
+ **ACL-Informationen** — Zugriffskontrolllisten für die von Ihnen ausgewählten Entitäten sind standardmäßig enthalten. Wenn Sie die Auswahl einer Zugriffskontrollliste aufheben, werden alle Dateien in dieser Kategorie öffentlich zugänglich gemacht. ACL-Optionen werden für nicht ausgewählte Entitäten automatisch deaktiviert. Für öffentliche Artikel wird ACL nicht angewendet.
+ Für **Maximale Dateigröße** — Geben Sie die Dateigrößenbeschränkung an MBs , die Amazon Kendra crawlt. Amazon Kendra crawlt nur die Dateien innerhalb der von Ihnen definierten Größenbeschränkung. Die Standarddateigröße ist 50 MB. Die maximale Dateigröße sollte größer als 0 MB und kleiner oder gleich 50 MB sein.
+ **Regex-Muster für Anlagen — Fügen Sie Muster** für reguläre Ausdrücke hinzu, um bestimmte angehängte Dateien von Katalogen, Wissensartikeln und Vorfällen ein- oder auszuschließen. Sie können bis zu 100 Muster hinzufügen.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Frequenz** aus, wie oft der Inhalt Ihrer Datenquelle synchronisiert und der Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Standardfeldzuordnungen** — Wählen Sie aus den Amazon Kendra generierten Standard-Datenquellenfeldern aus, die Sie Ihrem Index zuordnen möchten.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra herzustellen ServiceNow**
Sie müssen mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API einen JSON-Wert des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `SERVICENOWV2` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Host-URL** — Geben Sie die Version der ServiceNow Host-Instanz an. Beispiel, *your-domain.service-now.com*.
+ **Authentifizierungstyp** — Geben Sie den Authentifizierungstyp an, den Sie verwenden, unabhängig davon, ob `basicAuth` oder `OAuth2` für Ihre ServiceNow Instance.
+ **ServiceNow Instanzversion** — Geben Sie die ServiceNow Instanz an, die Sie verwenden, ob`Tokyo`, `Sandiego``Rome`, oder. `Others`
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten enthält, die Sie in Ihrem ServiceNow Konto erstellt haben.
Wenn Sie die Standardauthentifizierung verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"username": "user name",
"password": "password"
}
```
+ Wenn Sie OAuth2 Client-Anmeldeinformationen verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"username": "user name",
"password": "password",
"clientId": "client id",
"clientSecret": "client secret"
}
```
+ **IAMrole** — Geben Sie an`RoleArn`, wann Sie aufrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für den Aufruf der erforderlichen öffentlichen Daten APIs für den ServiceNow Connector und Amazon Kendra zu erteilen. Weitere Informationen finden Sie unter [IAMRollen für ServiceNow Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Inklusions- und Ausschlussfilter** — Sie können anhand der Dateinamen und Dateitypen von Wissensartikeln, Servicekatalogen und Vorfällen angeben, ob bestimmte angehängte Dateien ein- oder ausgeschlossen werden sollen.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Bestimmte zu indizierende Dokumente** — Sie können eine ServiceNow Abfrage verwenden, um die gewünschten Dokumente aus einer oder mehreren Wissensdatenbanken, einschließlich privater Wissensdatenbanken, anzugeben. Der Zugriff auf die Wissensdatenbanken wird durch den Benutzer bestimmt, den Sie für die Verbindung mit der ServiceNow Instanz verwenden. Weitere Informationen finden Sie unter [Angeben von Dokumenten für die Indexierung mit einer Abfrage](https://docs.aws.amazon.com//kendra/latest/dg/servicenow-query.html).
+ **Indizierungsparameter** — Sie können auch angeben, ob Sie:
+ Indexieren Sie Wissensartikel, Servicekataloge und Vorfälle oder alle diese. Wenn Sie Wissensartikel, Servicekatalogelemente und Vorfälle indizieren möchten, müssen Sie den Namen des ServiceNow Felds angeben, das dem Inhaltsfeld des Indexdokuments im Amazon Kendra Index zugeordnet ist.
+ Indexieren Sie Anlagen zu Wissensartikeln, Servicekatalogeinträgen und Vorfällen.
+ Fügen Sie Wissensartikel, Servicekatalogelemente und Vorfälle auf der Grundlage des `short description` Filtermusters hinzu.
+ Wählen Sie aus, ob aktive und inaktive Servicekatalogelemente und Vorfälle gefiltert werden sollen.
+ Wählen Sie, ob Vorfälle nach Art des Vorfalls gefiltert werden sollen.
+ Wählen Sie aus, für welche Entitäten die ACL gecrawlt werden soll.
+ Sie können eine ServiceNow Abfrage verwenden, um die gewünschten Dokumente aus einer oder mehreren Wissensdatenbanken, einschließlich privater Wissensdatenbanken, anzugeben. Der Zugriff auf die Wissensdatenbanken wird durch den Benutzer bestimmt, den Sie für die Verbindung mit der ServiceNow Instanz verwenden. Weitere Informationen finden Sie unter [Angeben von Dokumenten für die Indexierung mit einer Abfrage](https://docs.aws.amazon.com//kendra/latest/dg/servicenow-query.html).
+ **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) der Suchergebnisse zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre ServiceNow Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [ServiceNow Vorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-servicenow-schema).
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer ServiceNow Datenquelle finden Sie unter:
+ [Erste Schritte mit der Amazon Kendra Ankündigung des aktualisierten ServiceNow Connectors (V2) für Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/announcing-the-updated-servicenow-connector-v2-for-amazon-kendra/)
# Angeben von Dokumenten, die mit einer Abfrage indexiert werden sollen
Sie können eine ServiceNow Abfrage verwenden, um die Dokumente anzugeben, die Sie in einen Amazon Kendra Index aufnehmen möchten. Wenn Sie eine Abfrage verwenden, können Sie mehrere Wissensdatenbanken angeben, einschließlich privater Wissensdatenbanken. Der Zugriff auf die Wissensdatenbanken wird durch den Benutzer bestimmt, den Sie für die Verbindung mit der ServiceNow Instanz verwenden.
Um eine Abfrage zu erstellen, verwenden Sie den ServiceNow Query Builder. Sie können den Builder verwenden, um die Abfrage zu erstellen und zu testen, ob die Abfrage die richtige Liste von Dokumenten zurückgibt.
**Um eine Abfrage mit der ServiceNow Konsole zu erstellen**
1. Loggen Sie sich in die ServiceNow Konsole ein.
1. Wählen Sie im linken Menü „**Wissen**“, dann „**Artikel**“ und anschließend „**Alle**“ aus.
1. Wählen Sie oben auf der Seite das Filtersymbol aus.
1. Verwenden Sie den Query Builder, um die Abfrage zu erstellen.
1. Wenn die Abfrage abgeschlossen ist, klicken Sie mit der rechten Maustaste auf die Abfrage und wählen Sie **Abfrage kopieren**, um die Abfrage aus dem Abfrage-Generator zu kopieren. Speichern Sie diese Abfrage, um sie in zu verwendenAmazon Kendra.
![\[Query builder interface showing Knowledge base filters with options to run, save, and copy query.\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/images/ServiceNowQuery.png)
Achten Sie darauf, dass Sie beim Kopieren der Abfrage keinen Abfrageparameter ändern. Wenn einer der Abfrageparameter nicht erkannt wird, ServiceNow behandelt den Parameter als leer und verwendet ihn nicht zum Filtern der Ergebnisse.
# Slack
Slack ist eine Kommunikations-App für Unternehmen, mit der Benutzer Nachrichten und Anhänge über verschiedene öffentliche und private Kanäle versenden können. Du kannst ihn verwendenAmazon Kendra, um deine öffentlichen und privaten Slack-Channels, Bot- und Archivierungsnachrichten, Dateien und Anhänge, Direkt- und Gruppennachrichten zu indizieren. Du kannst auch bestimmte Inhalte zum Filtern auswählen.
**Anmerkung**
Amazon Kendraunterstützt jetzt einen aktualisierten Slack-Connector.
Die Konsole wurde automatisch für dich aktualisiert. Alle neuen Konnektoren, die Sie in der Konsole erstellen, verwenden die aktualisierte Architektur. Wenn Sie die API verwenden, müssen Sie jetzt das [https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)Objekt anstelle des `SlackConfiguration` Objekts verwenden, um Ihren Connector zu konfigurieren.
Konnektoren, die mit der älteren Konsolen- und API-Architektur konfiguriert wurden, funktionieren weiterhin wie konfiguriert. Sie können sie jedoch nicht bearbeiten oder aktualisieren. Wenn Sie Ihre Connectorkonfiguration bearbeiten oder aktualisieren möchten, müssen Sie einen neuen Connector erstellen.
Wir empfehlen, Ihren Connector-Workflow auf die aktualisierte Version zu migrieren. Die Support für Konnektoren, die mit der älteren Architektur konfiguriert wurden, soll bis Juni 2024 eingestellt werden.
Du kannst über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) oder die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API eine Verbindung zu deiner Slack-Datenquelle herstellen.
Informationen zur Fehlerbehebung bei deinem Amazon Kendra Slack-Datenquellen-Connector findest du unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-slack)
+ [
## Voraussetzungen
](#prerequisites-slack)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-slack)
+ [
## Weitere Informationen
](#slack-learn-more)
## Unterstützte Features
Amazon KendraDer Datenquellen-Connector von Slack unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor du deine Slack-Datenquelle Amazon Kendra zum Indizieren verwenden kannst, nimm diese Änderungen in deinem Slack und deinen Accounts vor. AWS
**Stelle in Slack sicher, dass du:**
+ Du hast ein OAuth Slack-Bot-Benutzertoken oder ein Slack-Benutzertoken konfiguriert. OAuth Du kannst eines der beiden Tokens wählen, um eine Verbindung Amazon Kendra zu deiner Slack-Datenquelle herzustellen. Ein Token ist erforderlich, um es als deine Authentifizierungsdaten zu verwenden. Weitere Informationen finden Sie in der [Slack-Dokumentation zu Zugriffstoken](https://api.slack.com/authentication/token-types).
**Anmerkung**
Wenn du das Bot-Token als Teil deiner Slack-Anmeldeinformationen verwendest, kannst du Direktnachrichten und Gruppennachrichten nicht indizieren und du musst das Bot-Token zu dem Channel hinzufügen, den du indexieren möchtest.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon ab**, Anmeldedaten und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (falls zutreffend) wiederzuverwenden.
+ Du hast deine Slack-Workspace-Team-ID aus der URL deiner Slack-Workspace-Hauptseite notiert. *https://app.slack.com/client/T0123456789/... *Wo *T0123456789* ist zum Beispiel die Team-ID.
+ Die folgenden Oauth-Bereiche/Berechtigungen wurden hinzugefügt:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kendra/latest/dg/data-source-slack.html)
+ Aktiviert, dass jedes Dokument in Slack und in anderen Datenquellen, die du für denselben Index verwenden möchtest, einzigartig ist. Jede Datenquelle, die du für einen Index verwenden möchtest, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen pro Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Du hast deine Slack-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls du die API verwendest, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir empfehlen **nicht**, dass du Anmeldeinformationen und Geheimnisse für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (falls zutreffend) wiederverwendest.
Wenn du noch keine IAM Rolle oder keinen Schlüssel hast, kannst du die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn du deine Slack-Datenquelle mit verbindest. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu deiner Slack-Datenquelle herzustellen, musst du die erforderlichen Details zu deiner Slack-Datenquelle angeben, damit du auf deine Daten zugreifen Amazon Kendra kannst. Wenn du Slack noch nicht für Amazon Kendra konfiguriert hast, siehe. [Voraussetzungen](#prerequisites-slack)
------
#### [ Console ]
**Um eine Verbindung zu Amazon Kendra Slack herzustellen**
1. Melde dich bei der an AWS-Managementkonsole und öffne die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wähle auf der Seite **Datenquelle hinzufügen** die Option **Slack-Konnektor** und dann **Konnektor hinzufügen** aus. Wenn du Version 2 verwendest (falls zutreffend), wähle den **Slack-Connector** mit dem Tag „V2.0".
1. Gib auf der Seite **„Datenquellendetails angeben**“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. Für **Slack-Workspace-Team-ID** — Die Team-ID deines Slack-Workspace. Du findest deine Team-ID in der URL der Hauptseite deines Slack-Workspace. *https://app.slack.com/client/T0123456789/...*Wo *T0123456789* ist zum Beispiel die Team-ID.
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **AWS Secrets Managergeheim** — Wähle ein vorhandenes Geheimnis oder erstelle ein neues Secrets Manager Geheimnis, um deine Slack-Authentifizierungsdaten zu speichern. Wenn du dich dafür entscheidest, ein neues Geheimnis zu erstellen, öffnet sich ein AWS Secrets Manager geheimes Fenster.
1. Geben Sie die folgenden Informationen in das **Fenster Create an AWS Secrets Manager Secret ein**:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Slack-' wird automatisch zu deinem geheimen Namen hinzugefügt.
1. Für **Slack-Token** — Gib die Werte für die Authentifizierungsdaten ein, die du für Slack konfiguriert hast.
1. Speichere dein Geheimnis und füge es hinzu.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. **Inhaltstyp auswählen** — Wähle die Slack-Entitäten oder Inhaltstypen aus, die du crawlen möchtest. Du kannst aus allen Kanälen, öffentlichen Channels, privaten Channels, Gruppennachrichten und privaten Nachrichten wählen.
1. **Startdatum für das Crawlen auswählen — Gib das Datum** ein, an dem du mit dem Crawlen deiner Inhalte beginnen möchtest.
1. Für **zusätzliche Konfigurationen**: Wählen Sie aus, ob Bot-Nachrichten und archivierte Nachrichten eingeschlossen werden sollen, und verwenden Sie Muster mit regulären Ausdrücken, um bestimmte Inhalte ein- oder auszuschließen.
**Anmerkung**
Wenn du dich dafür entscheidest, sowohl Kanal IDs - als auch Kanalnamen einzubeziehen, priorisiert der Amazon Kendra Slack-Connector die Kanäle vor IDs den Kanalnamen.
Wenn du dich dafür entschieden hast, bestimmte private Nachrichten und Gruppennachrichten einzubeziehen, ignoriert der Amazon Kendra Slack-Connector alle privaten Nachrichten und Gruppennachrichten und crawlt nur die von dir angegebenen privaten Nachrichten und Gruppennachrichten.
1. **Synchronisierungsmodus** — Wähle aus, wie du deinen Index aktualisieren möchtest, wenn sich der Inhalt deiner Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Frequenz** aus, wie oft der Inhalt Ihrer Datenquelle synchronisiert und der Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Standard-Datenquellenfelder** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra zu Slack herzustellen**
Du musst mithilfe der [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API ein JSON des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-slack) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `SLACK` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Team-ID des Slack-Workspace** — Die Slack-Team-ID, die du von der URL deiner Slack-Hauptseite kopiert hast.
+ **Seit dem Datum — Das Datum**, an dem mit dem Crawlen deiner Daten aus deinem Slack-Workspace-Team begonnen werden soll. Das Datum muss diesem Format folgen:. yyyy-mm-dd
+ **Synchronisierungsmodus** — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:
+ `FORCED_FULL_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ `CHANGE_LOG`um jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Gib den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses an, das die Authentifizierungsdaten für dein Slack-Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"slackToken": "token"
}
```
+ **IAMrole** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis zu gewähren und die erforderliche Öffentlichkeit APIs für den Slack-Connector anzurufen und. Amazon Kendra Weitere Informationen findest du unter [IAMRollen für Slack-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Du kannst auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Spezifische Kanäle** — Filtern Sie nach öffentlichen oder privaten Kanälen und geben Sie bestimmte Kanäle anhand ihrer ID an.
+ **Arten von Kanälen und Nachrichten** — Gibt an, ob deine öffentlichen und privaten Kanäle, deine Gruppen- und Direktnachrichten sowie dein Bot und deine archivierten Nachrichten indexiert werden Amazon Kendra sollen. Wenn du ein Bot-Token als Teil deiner Slack-Authentifizierungsdaten verwendest, musst du das Bot-Token dem Kanal hinzufügen, den du indexieren möchtest. Du kannst Direktnachrichten und Gruppennachrichten nicht mit einem Bot-Token indizieren.
+ **Rückblick** — Du kannst einen `lookBack` Parameter so konfigurieren, dass der Slack-Connector aktualisierte oder gelöschte Inhalte bis zu einer bestimmten Anzahl von Stunden vor deiner letzten Connector-Synchronisierung crawlt.
+ **Inklusions- und Ausschlussfilter — Gib** an, ob bestimmte Slack-Inhalte ein- oder ausgeschlossen werden sollen. Wenn du ein Bot-Token als Teil deiner Slack-Authentifizierungsdaten verwendest, musst du das Bot-Token zu dem Channel hinzufügen, den du indexieren möchtest. Du kannst Direktnachrichten und Gruppennachrichten nicht mit einem Bot-Token indizieren.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Inklusionsfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Feldzuordnungen** — Wähle, ob du deine Slack-Datenquellenfelder deinen Indexfeldern zuordnen möchtest. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für deine Dokumente ist erforderlich, um deine Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [SlackVorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-slack).
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit deiner Slack-Datenquelle findest du unter:
+ [Entdecke das Wissen in Slack-Workspaces mit intelligenter Suche mithilfe des Slack-Connectors Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/unravel-the-knowledge-in-slack-workspaces-with-intelligent-search-using-the-amazon-kendra-slack-connector/)
# Zendesk
Zendesk ist ein Kundenbeziehungsmanagementsystem, das Unternehmen dabei unterstützt, Interaktionen mit dem Kundensupport zu automatisieren und zu verbessern. Sie können es verwenden, Amazon Kendra um Ihre Zendesk-Supporttickets, Ticketkommentare, Ticketanhänge, Help-Center-Artikel, Artikelkommentare, Anlagen zu Artikelkommentaren, Leitfadenthemen, Community-Posts und Kommentare zu Community-Posts zu indexieren.
Sie können nach dem Namen der Organisation filtern, wenn Sie Tickets indizieren möchten, die sich nur innerhalb einer bestimmten Organisation befinden. Sie können auch ein Crawldatum festlegen, an dem Sie mit dem Crawlen von Daten aus Zendesk beginnen möchten.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die API eine Verbindung zu Ihrer Zendesk-Datenquelle herstellen. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Zendesk-Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-zendesk)
+ [
## Voraussetzungen
](#prerequisites-zendesk)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-zendesk)
+ [
## Weitere Informationen
](#zendesk-learn-more)
+ [
## Hinweise
](#zendesk-notes)
## Unterstützte Features
Amazon KendraDer Zendesk-Datenquellen-Connector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Änderungsprotokoll, vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Zendesk-Datenquelle Amazon Kendra zum Indizieren verwenden können, müssen Sie diese Änderungen in Ihrem Zendesk und Ihren Konten vornehmen. AWS
**Stellen Sie in Zendesk sicher, dass Sie über Folgendes verfügen:**
+ Sie haben ein Administratorkonto für die Zendesk Suite (Professional/Enterprise) erstellt.
+ Ich habe Ihre Zendesk-Host-URL notiert. Beispiel, *https://\$1sub-domain\$1.zendesk.com/*.
**Anmerkung**
(On-Premise/Server) Amazon Kendra überprüft, ob die in der Datei enthaltenen Endpunktinformationen mit den Endpunktinformationen übereinstimmen, die in AWS Secrets Manager den Konfigurationsdetails Ihrer Datenquelle angegeben sind. Dies trägt zum Schutz vor dem [Problem des verwirrten Stellvertreters](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html) bei, bei dem es sich um ein Sicherheitsproblem handelt, bei dem ein Benutzer nicht berechtigt ist, eine Aktion auszuführen, sondern ihn Amazon Kendra als Proxy verwendet, um auf das konfigurierte Geheimnis zuzugreifen und die Aktion auszuführen. Wenn Sie Ihre Endpunktinformationen später ändern, müssen Sie ein neues Geheimnis erstellen, um diese Informationen zu synchronisieren.
+ Richten Sie die OAuth 2.0-Authentifizierung mit dem Ablauf der Autorisierungscode-Gewährung ein:
1. Navigieren Sie im Admin Center zu Apps und Integrationen > APIs > Zendesk-API.
1. Wählen Sie den Tab OAuth Kunden aus und klicken Sie auf „ OAuth Kunde hinzufügen“.
1. Konfigurieren Sie die OAuth Kundendetails: Legen Sie den Kundennamen und die Beschreibung fest, legen Sie die Kundenart auf „Vertraulich“ fest, fügen Sie eine entsprechende Weiterleitung hinzu URLs (z. B. https://localhost/callback zum Testen), speichern und speichern Sie die generierte Client-ID und das Client-Geheimnis sicher.
1. Stellen Sie sicher, dass der OAuth Client über den erforderlichen Lese- und Schreibbereich verfügt (oder über „Lese- und Schreibzugriff“, wenn Sie Schreibzugriff benötigen).
1. Generieren Sie ein Zugriffstoken mithilfe des Autorisierungscode-Grant-Ablaufs:
+ Navigieren Sie in einem Browser zu: `https://{subdomain}.zendesk.com/oauth/authorizations/new?response_type=code&client_id={your_client_id}&redirect_uri={your_redirect_uri}&scope=read`
+ Authentifizieren und autorisieren Sie die Anwendung, wenn Sie dazu aufgefordert werden.
+ Nach der Autorisierung leitet Zendesk mit einem Codeparameter (z. B. dem Autorisierungscode) zur redirect\$1uri weiter. https://localhost/callback?code=\$1authorization\$1code\$1). Copy
+ Tauschen Sie den Autorisierungscode gegen ein Zugriffstoken aus, indem Sie eine POST-Anfrage an den Token-Endpunkt von Zendesk senden:
```
curl -X POST https://{subdomain}.zendesk.com/oauth/tokens \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=authorization_code&code={authorization_code}&client_id={your_client_id}&client_secret={your_client_secret}&redirect_uri={your_redirect_uri}&scope=read"
```
+ Zendesk antwortet mit einem JSON-Objekt, das das access\$1token enthält. Extrahieren Sie dieses Zugriffstoken und speichern Sie es sicher.
1. Speichern Sie das generierte Zugriffstoken sicher. Dieses Zugriffstoken wird für die Kendra-Integration verwendet.
+
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ **Optional: Es** wurde ein SSL-Zertifikat installiert, Amazon Kendra um eine Verbindung herzustellen.
+ Aktiviert, dass jedes Dokument in Zendesk und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen pro Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
**Anmerkung**
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
+ Sie haben Ihre Zendesk-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir raten **davon** ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Zendesk-Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
## Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu Ihrer Zendesk-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Zendesk-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Wenn Sie Zendesk noch nicht für Amazon Kendra konfiguriert haben, finden Sie weitere Informationen unter. [Voraussetzungen](#prerequisites-zendesk)
------
#### [ Console ]
**So stellen Sie eine Verbindung Amazon Kendra zu Zendesk her**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. Wählen Sie im linken Navigationsbereich **Indizes** und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
**Anmerkung**
Sie können Ihre Einstellungen für die **Benutzerzugriffskontrolle** unter **Indexeinstellungen** konfigurieren oder bearbeiten.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Zendesk-Connector** und dann **Connector hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie **Zendesk Connector mit dem Tag** „V2.0".
1. Geben Sie auf der Seite **„Datenquellendetails angeben**“ die folgenden Informationen ein:
1. Geben Sie im Feld **Name und Beschreibung** für **Datenquellenname** einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. In **Standardsprache** — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
1. Unter **Tags** für **Neues Tag hinzufügen** — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Zendesk-URL** — Geben Sie Ihre Zendesk-URL ein. Beispiel, *https://\$1sub-domain\$1.zendesk.com/*.
1. **Autorisierung** — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Zendesk-Authentifizierungsdaten zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. Erstellen Sie ein neues Geheimnis mit der folgenden Struktur:
```
{
"hostUrl": "https://yoursubdomain.zendesk.com/",
"accessToken": "your_access_token"
}
```
**Anmerkung**
Für Kendra Kendra-Integration sollte der geheime Name mit 'AmazonKendra-Zendesk' beginnen, gefolgt von der von Ihnen gewählten Kennung (z. B. '-Zendesk-'AmazonKendra). MyConnector
1. Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.
1. **Virtual Private Cloud (VPC)** — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie **Subnetze** und **VPC-Sicherheitsgruppen** hinzufügen.
1. **Identity Crawler** — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) der Suchergebnisse zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie **Neue Rolle erstellen**, um Fehler zu vermeiden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. **Inhalt auswählen** — Wählen Sie die Inhaltstypen aus, die Sie crawlen möchten, von Tickets bis hin zu Help-Center-Artikeln, Community-Themen und mehr.
1. **Name der Organisation** — Geben Sie die Namen der Zendesk-Organisation ein, um Inhalte zu filtern.
1. **Startdatum der Synchronisierung** — Geben Sie das Datum ein, ab dem Sie mit dem Crawlen Ihrer Inhalte beginnen möchten.
1. **Regex-Muster — Fügen Sie Muster** für reguläre Ausdrücke hinzu, um bestimmte Dateien ein- oder auszuschließen. Sie können bis zu 100 Muster hinzufügen.
1. **Synchronisierungsmodus** — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
+ Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
+ Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. **Zeitplan für In-Sync-Ausführung** für **Häufigkeit** — Wählen Sie aus, wie oft Ihre Datenquelleninhalte synchronisiert und Ihr Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Standard-Datenquellenfelder** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie auf der Seite **Überprüfen und erstellen**, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann **Datenquelle hinzufügen** aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite **Datenquellen** angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
------
#### [ API ]
**Um eine Verbindung Amazon Kendra zu Zendesk herzustellen**
Sie müssen mithilfe der [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API ein JSON des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) angeben. Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `ZENDESK` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Host-URL** — Geben Sie Ihre Zendesk-Host-URL als Teil der Verbindungskonfiguration oder der Repository-Endpunktdetails an. Beispiel, * https://yoursubdomain.zendesk.com*.
+ **Änderungsprotokoll** — Gibt an, ob der Änderungsprotokollmechanismus der Zendesk-Datenquelle verwendet werden Amazon Kendra soll, um festzustellen, ob ein Dokument im Index aktualisiert werden muss.
**Anmerkung**
Verwenden Sie das Änderungsprotokoll, wenn Sie nicht alle Dokumente scannen Amazon Kendra möchten. Wenn Ihr Änderungsprotokoll umfangreich ist, dauert das Scannen der Dokumente in der Zendesk-Datenquelle möglicherweise Amazon Kendra weniger Zeit als das Verarbeiten des Änderungsprotokolls. Wenn Sie Ihre Zendesk-Datenquelle zum ersten Mal mit Ihrem Index synchronisieren, werden alle Dokumente gescannt.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Zendesk-Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"hostUrl": "https://yoursubdomain.zendesk.com",
"clientId": "client ID",
"clientSecret": "Zendesk client secret",
"userName": "Zendesk user name",
"password": "Zendesk password"
}
```
+ **IAMRolle** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis zu erteilen und die erforderliche Öffentlichkeit APIs für den Zendesk-Connector anzurufen und. Amazon Kendra Weitere Informationen finden Sie unter [IAMRollen für Zendesk-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Dokument-/Inhaltstypen** — Geben Sie an, ob gecrawlt werden soll:
+ Supporttickets, Ticketkommentare, and/or Ticketkommentaranhänge
+ Help-Center-Artikel, Artikelanhänge und Artikelkommentare
+ Leitfäden für Community-Themen, Beiträge oder Kommentare
+ **Inklusions- und Ausschlussfilter** — Gib an, ob bestimmte Slack-Inhalte ein- oder ausgeschlossen werden sollen. Wenn du ein Bot-Token als Teil deiner Slack-Authentifizierungsdaten verwendest, musst du das Bot-Token zu dem Channel hinzufügen, den du indexieren möchtest. Du kannst Direktnachrichten und Gruppennachrichten nicht mit einem Bot-Token indizieren.
**Anmerkung**
Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Inklusionsfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.
+ **Benutzerkontextfilterung und Zugriffskontrolle** — Amazon Kendra durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Zendesk-Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Anmerkung**
Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter [Zendesk-Vorlagenschema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-zendesk).
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer Zendesk-Datenquelle finden Sie unter:
+ [Entdecken Sie mit Amazon Kendra der intelligenten Suche Erkenntnisse von Zendesk](https://aws.amazon.com/blogs/machine-learning/discover-insights-from-zendesk-with-amazon-kendra-intelligent-search/)
## Hinweise
+ Wenn Zugriffskontrolllisten (ACLs) aktiviert sind, ist die Option „Nur neue oder geänderte Inhalte synchronisieren“ aufgrund von Einschränkungen der Zendesk-API nicht verfügbar. Wir empfehlen, stattdessen die Modi „Vollständige Synchronisierung“ oder „Neue, geänderte oder gelöschte Inhalte“ zu verwenden oder sie zu deaktivieren, ACLs falls Sie diesen Synchronisierungsmodus verwenden müssen.
# Zuordnen von Datenquellenfeldern
Amazon Kendra Datenquellen-Konnektoren können Dokument- oder Inhaltsfelder aus Ihrer Datenquelle Feldern in Ihrem Amazon Kendra Index zuordnen. Standardmäßig ist jeder Connector für das Crawlen bestimmter Datenquellenfelder konzipiert. Standarddatenquellenfelder und ihre Eigenschaften können nicht geändert oder angepasst werden. In der Amazon Kendra Konsole sind Standardfelder und Standardfeldeigenschaften, die nicht bearbeitet werden können, ausgegraut.
Amazon Kendra Mithilfe von Konnektoren können Sie auch benutzerdefinierte Dokument- oder Inhaltsfelder aus Ihrer Datenquelle benutzerdefinierten Feldern in Ihrem Index zuordnen. Wenn Sie in Ihrer Datenquelle beispielsweise ein Feld mit dem Namen „Abteilung“ haben, das Abteilungsinformationen für ein Dokument enthält, können Sie es einem Indexfeld namens „Abteilung“ zuordnen. Auf diese Weise können Sie das Feld bei der Abfrage von Dokumenten verwenden.
Sie können auch Amazon Kendra reservierte oder allgemeine Felder zuordnen, wie `_created_at` z. Wenn Ihre Datenquelle ein Feld namens „creation\$1date“ hat, können Sie dieses dem entsprechenden Amazon Kendra reservierten Feld namens zuordnen. `_created_at` Weitere Informationen zu Amazon Kendra reservierten Feldern finden Sie unter [Dokumentattribute](https://docs.aws.amazon.com/kendra/latest/dg/hiw-document-attributes.html) oder -felder.
Sie können Felder für die meisten Datenquellen zuordnen. Sie können Feldzuordnungen für die folgenden Datenquellen erstellen:
+ Adobe Experience Manager
+ Alfresco
+ Aurora (MySQL)
+ Aurora (PostgreSQL)
+ Amazon FSx (Windows)
+ Amazon FSx (NetApp ONTAP)
+ Amazon RDS/Aurora
+ Amazon RDS (Microsoft SQL Server)
+ Amazon RDS (MySQL)
+ Amazon RDS (Oracle)
+ Amazon RDS (PostgreSQL)
+ Amazon Kendra Webcrawler
+ WorkDocs
+ Box (Kasten)
+ Zusammenfluss
+ Dropbox
+ Drupal
+ GitHub
+ Google Workspace-Laufwerke
+ Gmail
+ IBM DB2
+ Jira
+ Microsoft Exchange
+ Microsoft OneDrive
+ Microsoft SharePoint
+ Microsoft Teams
+ Microsoft SQL Server
+ Microsoft Yammer
+ MySQL
+ Oracle-Datenbank
+ PostgreSQL
+ Quip
+ Salesforce
+ ServiceNow
+ Slack
+ Zendesk
Wenn Sie Ihre Dokumente in einem S3-Bucket oder einer S3-Datenquelle speichern, geben Sie Ihre Felder mithilfe einer JSON-Metadatendatei an. Weitere Informationen finden Sie unter [S3-Datenquellenconnector](https://docs.aws.amazon.com/kendra/latest/dg/data-source-s3.html).
Die Zuordnung Ihrer Datenquellenfelder zu einem Indexfeld erfolgt in drei Schritten:
1. Erstellen Sie einen Index. Weitere Informationen finden Sie unter [Index erstellen](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html).
1. Aktualisieren Sie den Index, um Felder hinzuzufügen.
1. Erstellen Sie eine Datenquelle und fügen Sie Feldzuordnungen hinzu, um reservierte Felder und alle benutzerdefinierten Felder Amazon Kendra Indexfeldern zuzuordnen.
Um den Index zu aktualisieren, um benutzerdefinierte Felder hinzuzufügen, verwenden Sie die Konsole, um die Feldzuordnungen der Datenquellen zu bearbeiten und ein benutzerdefiniertes Feld hinzuzufügen, oder verwenden Sie die API. [UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html) Sie können Ihrem Index insgesamt 500 benutzerdefinierte Felder hinzufügen.
Wenn bei Datenbankdatenquellen der Name der Datenbankspalte mit dem Namen eines reservierten Felds übereinstimmt, werden das Feld und die Spalte automatisch zugeordnet.
Mit der [UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)API fügen Sie reservierte und benutzerdefinierte Felder hinzu mit`DocumentMetadataConfigurationUpdates`.
Im folgenden JSON-Beispiel wird `DocumentMetadataConfigurationUpdates` verwendet, um dem Index ein Feld namens „Department“ hinzuzufügen.
```
"DocumentmetadataConfigurationUpdates": [
{
"Name": "Department",
"Type": "STRING_VALUE"
}
]
```
Wenn Sie das Feld erstellen, haben Sie die Möglichkeit festzulegen, wie das Feld für die Suche verwendet wird. Sie können aus den folgenden Optionen auswählen:
+ **Anzeigbar** — Bestimmt, ob das Feld in der Abfrageantwort zurückgegeben wird. Der Standardwert ist `true`.
+ **Facetable** — Gibt an, dass das Feld zur Erstellung von Facetten verwendet werden kann. Der Standardwert ist `false`.
+ **Durchsuchbar** — Bestimmt, ob das Feld bei der Suche verwendet wird. Die Standardeinstellung bei Zeichenfolgenfeldern ist `true` und bei Zahlen- und Datumsfeldern `false`.
+ **Sortierbar** — Gibt an, dass das Feld verwendet werden kann, um die Antwort aus einer Abfrage zu sortieren. Kann nur für Datums-, Zahlen- und Zeichenfolgenfelder festgelegt werden. Kann nicht für Zeichenkettenlistenfelder festgelegt werden.
Das folgende JSON-Beispiel verwendet`DocumentMetadataConfigurationUpdates`, um dem Index ein Feld namens „Department“ hinzuzufügen und es als facetable zu kennzeichnen.
```
"DocumentMetadataConfigurationUpdates": [
{
"Name": "Department",
"Type": "STRING_VALUE",
"Search": {
"Facetable": true
}
}
]
```
## Verwendung Amazon Kendra reservierter oder allgemeiner Dokumentfelder
Mit der [UpdateIndex API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html) können Sie reservierte oder allgemeine Felder erstellen, indem Sie den Namen des Amazon Kendra reservierten Indexfeldes verwenden `DocumentMetadataConfigurationUpdates` und angeben, um ihn Ihrem entsprechenden attribute/field Dokumentnamen zuzuordnen. Sie können auch benutzerdefinierte Felder erstellen. Wenn Sie einen Datenquellenconnector verwenden, enthalten die meisten Feldzuordnungen, die die Felder Ihres Datenquellendokuments Amazon Kendra Indexfeldern zuordnen. Wenn Sie die Konsole verwenden, aktualisieren Sie Felder, indem Sie Ihre Datenquelle auswählen, die Aktion Bearbeiten auswählen und dann mit dem Abschnitt Feldzuordnungen zur Konfiguration der Datenquelle fortfahren.
Sie können das `Search` Objekt so konfigurieren, dass ein Feld entweder als anzeigbar, facettierbar, durchsuchbar oder sortierbar festgelegt wird. Sie können das `Relevance` Objekt so konfigurieren, dass die Rangfolge, die Boost-Dauer oder der Zeitraum eines Felds so festgelegt werden, dass sie auf Boosting, Aktualität, Wichtigkeitswert und Wichtigkeitswerte angewendet werden, die bestimmten Feldwerten zugeordnet sind. Wenn Sie die Konsole verwenden, können Sie die Sucheinstellungen für ein Feld festlegen, indem Sie im Navigationsmenü die Option Facette auswählen. Um die Relevanzoptimierung einzustellen, wählen Sie im Navigationsmenü die Option zum Durchsuchen Ihres Index aus, geben Sie eine Abfrage ein und verwenden Sie die Optionen im Seitenbereich, um die Suchrelevanz zu optimieren. Sie können den Feldtyp nicht mehr ändern, nachdem Sie das Feld erstellt haben.
Amazon Kendra hat die folgenden reservierten oder allgemeinen Dokumentfelder, die Sie verwenden können:
+ `_authors`—Eine Liste mit einem oder mehreren Autoren, die für den Inhalt des Dokuments verantwortlich sind.
+ `_category`— Eine Kategorie, die ein Dokument einer bestimmten Gruppe zuordnet.
+ `_created_at`— Datum und Uhrzeit im ISO 8601-Format, an dem das Dokument erstellt wurde. Beispiel: 2012-03-25T12:30:10\$101:00 ist das ISO-8601-Datums-/Uhrzeitformat für den 25. März 2012 um 12:30 Uhr (plus 10 Sekunden) in mitteleuropäischer Zeit (CET).
+ `_data_source_id`— Der Bezeichner der Datenquelle, die das Dokument enthält.
+ `_document_body`— Der Inhalt des Dokuments.
+ `_document_id`— Eine eindeutige Kennung für das Dokument.
+ `_document_title`— Der Titel des Dokuments.
+ `_excerpt_page_number`— Die Seitenzahl in einer PDF-Datei, auf der der Dokumentauszug erscheint. Wenn Ihr Index vor dem 8. September 2020 erstellt wurde, müssen Sie Ihre Dokumente erneut indizieren, bevor Sie dieses Attribut verwenden können.
+ `_faq_id`— Wenn es sich um ein Dokument vom Typ Frage-Antwort (FAQ) handelt, eine eindeutige Kennung für die häufig gestellten Fragen.
+ `_file_type`— Der Dateityp des Dokuments, z. B. PDF oder Dokument.
+ `_last_updated_at`— Datum und Uhrzeit der letzten Aktualisierung des Dokuments im Format ISO 8601. Beispiel: 2012-03-25T12:30:10\$101:00 ist das ISO-8601-Datums-/Uhrzeitformat für den 25. März 2012 um 12:30 Uhr (plus 10 Sekunden) in mitteleuropäischer Zeit (CET).
+ `_source_uri`— Die URI, unter der das Dokument verfügbar ist. z. B. der URI des Dokuments auf einer Unternehmenswebsite
+ `_version`— Ein Bezeichner für die spezifische Version eines Dokuments.
+ `_view_count`— Wie oft das Dokument angesehen wurde.
+ `_language_code`(String) — Der Code für eine Sprache, die für das Dokument gilt. Dies ist standardmäßig Englisch, wenn Sie keine Sprache angeben. Weitere Informationen zu den unterstützten Sprachen, einschließlich ihrer Codes, finden Sie unter [Dokumente in anderen Sprachen als Englisch hinzufügen](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-languages.html).
Bei benutzerdefinierten Feldern erstellen Sie diese Felder `DocumentMetadataConfigurationUpdates` mithilfe der `UpdateIndex` API, genau wie bei der Erstellung eines reservierten oder gemeinsamen Felds. Sie müssen den entsprechenden Datentyp für Ihr benutzerdefiniertes Feld festlegen. Wenn Sie die Konsole verwenden, aktualisieren Sie Felder, indem Sie Ihre Datenquelle auswählen, die Aktion Bearbeiten auswählen und dann mit dem Abschnitt Feldzuordnungen zur Konfiguration der Datenquelle fortfahren. Einige Datenquellen unterstützen das Hinzufügen neuer Felder oder benutzerdefinierter Felder nicht. Sie können den Feldtyp nicht mehr ändern, nachdem Sie das Feld erstellt haben.
Die folgenden Typen können Sie für benutzerdefinierte Felder festlegen:
+ Date
+ Zahl
+ Zeichenfolge
+ Zeichenfolgenliste
Wenn Sie dem Index mithilfe der [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API Dokumente hinzugefügt haben, `Attributes` listet es Ihre Dokumente auf und Sie erstellen Felder mithilfe des `DocumentAttribute` Objekts. fields/attributes
Für Dokumente, die aus einer Amazon S3 Datenquelle indexiert wurden, erstellen Sie Felder mithilfe einer [JSON-Metadatendatei](https://docs.aws.amazon.com/kendra/latest/dg/s3-metadata.html), die die Feldinformationen enthält.
Wenn Sie eine unterstützte Datenbank als Datenquelle verwenden, können Sie Ihre Felder mithilfe der Option [Feldzuordnungen](https://docs.aws.amazon.com/kendra/latest/dg/data-source-database.html#data-source-procedure-database) konfigurieren.
# Dokumente in anderen Sprachen als Englisch hinzufügen
Sie können Dokumente in mehreren Sprachen indexieren. Wenn Sie keine Sprache angeben, werden Dokumente standardmäßig auf Englisch Amazon Kendra indexiert. Sie fügen den Sprachcode für ein Dokument als Feld in die Metadaten des Dokuments ein. Weitere Informationen zum [Feld für ein Dokument finden Sie unter `_language_code` Feldzuordnungen](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html) und [Benutzerdefinierte Attribute](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html).
Sie können den Sprachcode für alle Ihre Dokumente in Ihrer Datenquelle angeben, wenn Sie anrufen. [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html) Wenn für ein Dokument kein Sprachcode in einem Metadatenfeld angegeben ist, wird das Dokument mit dem Sprachcode indexiert, der für alle Dokumente auf Datenquellenebene angegeben wurde. In der Konsole können Sie Dokumente in einer unterstützten Sprache nur auf Datenquellenebene indizieren. Gehen Sie zu **Datenquellen** und dann zur Seite **Datenquellendetails angeben**, und wählen Sie im Dropdownmenü Sprache eine **Sprache** aus.
Sie können auch Dokumente in einer unterstützten Sprache suchen oder abfragen. Weitere Informationen finden Sie unter [Suchen in Sprachen](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-languages).
Die folgenden Sprachen und ihre Codes werden unterstützt (Englisch oder `en` wird standardmäßig unterstützt, wenn Sie keine Sprache angeben). Diese Tabelle enthält Sprachen, die die vollständige semantische Suche Amazon Kendra unterstützen, sowie Sprachen, die nur den einfachen Schlüsselwortabgleich unterstützen. Sprachen, die die vollständige semantische Suche unterstützen, sind in der folgenden Tabelle mit einem Sternchen gekennzeichnet und fett gedruckt. Englisch (Standardsprache) wird auch bei der vollständigen semantischen Suche unterstützt.
| **Name der Sprache** | **Sprachcode** |
| --- | --- |
| Arabisch | ar |
| Armenisch | hy |
| Baskisch | eu |
| Bengalisch | bn |
| Bulgarisch | bg |
| Katalanisch | ca |
| Chinesisch — vereinfacht und traditionell\$1 | zh |
| Tschechisch | cs |
| Dänisch | da |
| Niederländisch | nl |
| Finnisch | fi |
| Französisch — beinhaltet Französisch (Kanada) \$1 | fr |
| Galizisch | gl |
| Deutsch\$1 | de |
| Griechisch | el |
| Hindi | hi |
| Ungarisch | hu |
| Indonesisch | id |
| Irisch | ga |
| Italienisch | it |
| Japanisch\$1 | ja |
| Koreanisch\$1 | ko |
| Lettisch | lv |
| Litauisch | lt |
| Norwegisch | no |
| Persisch | fa |
| Portugiesisch | pt |
| Portugiesisch (Brasilien) \$1 | pt-BR |
| Rumänisch | ro |
| Russisch | ru |
| Sorani | ckb |
| Spanisch — beinhaltet Spanisch (Mexiko) \$1 | es |
| Schwedisch | sv |
| Türkisch | tr |
*\$1Die semantische Suche wird für die Sprache unterstützt.*
Für Sprachen, die die semantische Suche unterstützen, werden die folgenden Funktionen unterstützt.
+ Dokumentenrelevanz, die über den einfachen Stichwortabgleich hinausgeht.
+ FAQs geht über den einfachen Stichwort-Abgleich hinaus.
+ Extrahieren von Antworten aus Dokumenten auf der Grundlage Amazon Kendra des Leseverständnisses.
+ Konfidenzbereiche (sehr hoch, hoch, mittel und niedrig) der Suchergebnisse.
Für Sprachen, die keine semantische Suche unterstützen, wird der einfache Stichwortabgleich aus Gründen der Relevanz von Dokumenten und unterstützt. FAQs
[Synonyme](https://docs.aws.amazon.com/kendra/latest/dg/index-synonyms.html) (einschließlich benutzerdefinierter Synonyme), [schrittweises Lernen und Feedback](https://docs.aws.amazon.com/kendra/latest/dg/submitting-feedback.html) sowie [Abfragevorschläge](https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html) werden nur für Englisch (Standardsprache) unterstützt.
# Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC
Amazon Kendra kann eine Verbindung zu einer Virtual Private Cloud (VPC) herstellen, mit der Sie Inhalte indizieren können Amazon Virtual Private Cloud , die in Datenquellen gespeichert sind, die in Ihrer privaten Cloud ausgeführt werden. Wenn Sie einen Datenquellen-Konnektor erstellen, können Sie Sicherheitsgruppen- und Subnetz-IDs für das Subnetz angeben, das Ihre Datenquelle enthält. Amazon Kendra Erstellt mit diesen Informationen eine elastic network interface, die für die sichere Kommunikation mit Ihrer Datenquelle in Ihrer VPC verwendet wird.
Um einen Amazon Kendra Datenquellen-Connector mit einzurichten Amazon VPC, können Sie entweder den AWS-Managementkonsole oder den [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html)API-Vorgang verwenden. Wenn Sie die Konsole verwenden, verbinden Sie während der Konnektor-Konfiguration eine VPC.
**Anmerkung**
Die Amazon VPC Funktion ist optional, wenn Sie einen Amazon Kendra Datenquellenconnector einrichten. Wenn auf Ihre Datenquelle über das öffentliche Internet zugegriffen werden kann, müssen Sie die Amazon VPC Funktion nicht aktivieren. Nicht alle Datenquellen-Konnektoren von unterstützen Amazon VPC.
Wenn Ihre Datenquelle nicht im öffentlichen Internet läuft Amazon VPC und nicht über das öffentliche Internet zugänglich ist, verbinden Sie Ihre Datenquelle zunächst über ein virtuelles privates Netzwerk (VPN) mit Ihrer VPC. Anschließend können Sie Ihre Datenquelle mit verbinden, Amazon Kendra indem Sie eine Kombination aus Amazon VPC und AWS Virtual Private Network verwenden. Weitere Informationen zum Einrichten eines VPN finden Sie in der [Site-to-Site VPN -Dokumentation](https://docs.aws.amazon.com/vpn/).
**Topics**
+ [
# Konfiguration der Amazon VPC Unterstützung für Amazon Kendra Konnektoren
](connector-vpc-steps.md)
+ [
# Richten Sie eine Amazon Kendra Datenquelle ein, zu der eine Verbindung hergestellt werden soll Amazon VPC
](connector-vpc-setup.md)
+ [
# Verbindung zu einer Datenbank in einer VPC herstellen
](vpc-example.md)
+ [
# Behebung VPC VPC-Verbindungsproblemen
](vpc-connector-troubleshoot.md)
# Konfiguration der Amazon VPC Unterstützung für Amazon Kendra Konnektoren
Gehen Sie wie folgt vor, um die Konfiguration Amazon VPC für die Verwendung mit Ihren Amazon Kendra Anschlüssen vorzunehmen.
**Topics**
+ [
## Schritt 1. Erstellen Sie Amazon VPC Subnetze für Amazon Kendra
](#connector-vpc-prerequisites-1)
+ [
## Schritt 2. Erstellen Sie Amazon VPC Sicherheitsgruppen für Amazon Kendra
](#connector-vpc-prerequisites-2)
+ [
## Schritt 3. Konfigurieren Sie Ihre externe Datenquelle und Amazon VPC
](#connector-vpc-prerequisites-3)
## Schritt 1. Erstellen Sie Amazon VPC Subnetze für Amazon Kendra
Erstellen Sie ein vorhandenes Amazon VPC Subnetz, über das Sie auf Ihre Datenquelle zugreifen Amazon Kendra können, oder wählen Sie ein vorhandenes aus. Die vorbereiteten Subnetze müssen sich in einer der folgenden Zonen AWS-Regionen und in einer der Availability Zones befinden:
+ USA West (Oregon)/us-west-2—usw2-az1, usw2-az2, usw2-az3
+ USA Ost (Nord-Virginia)/us-east-1—use1-az1, use1-az2, use1-az4
+ USA Ost (Ohio) /us-east-2—use2-az1, use2-az2, use2-az3
+ Asien-Pazifik (Tokio) /ap-northeast-1—apne1-az1, apne1-az2, apne1-az4
+ Asien-Pazifik (Mumbai) /ap-south-1—aps1-az1, aps1-az2, aps1-az3
+ Asien-Pazifik (Singapur) /ap-southeast-1—apse1-az1, apse1-az2, apse1-az3
+ Asien-Pazifik (Sydney)/ap-southeast-2—apse2-az1, apse2-az2, apse2-az3
+ Kanada (Zentral) /ca-central-1—cac1-az1, cac1-az2, cac1-az4
+ Europa (Irland) /eu-west-1—euw1-az1, uew1-az2, euw1-az3
+ Europa (London) /eu-west-2—euw2-az1, euw2-az2, euw2-az3
Ihre Datenquelle muss von den Subnetzen aus zugänglich sein, die Sie für den Amazon Kendra -Konnektor bereitgestellt haben.
Weitere Informationen zur Konfiguration von Amazon VPC Subnetzen finden Sie unter [Subnetze für Sie Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/configure-subnets.html) im *Amazon VPC-Benutzerhandbuch*.
Wenn Sie die Verbindung zwischen zwei oder mehr Subnetzen weiterleiten Amazon Kendra müssen, können Sie mehrere Subnetze vorbereiten. Ein Beispiel ist, dass das Subnetz, das Ihre Datenquelle enthält, keine IP-Adressen mehr hat. In diesem Fall können Sie ein zusätzliches Subnetz bereitstellen, das über ausreichend IP-Adressen verfügt und Amazon Kendra mit dem ersten Subnetz verbunden ist. Wenn Sie mehrere Subnetze auflisten, müssen die Subnetze miteinander kommunizieren können.
## Schritt 2. Erstellen Sie Amazon VPC Sicherheitsgruppen für Amazon Kendra
Um Ihren Amazon Kendra Datenquellen-Connector zu verbinden Amazon VPC, müssen Sie eine oder mehrere Sicherheitsgruppen aus Ihrer VPC für die Zuweisung vorbereiten. Amazon Kendra Die Sicherheitsgruppen werden der Elastic-Network-Schnittstelle zugeordnet, die von Amazon Kendra erstellt wurde. Diese Netzwerkschnittstelle steuert den ein- und ausgehenden Datenverkehr zu und von dem Amazon Kendra beim Zugriff auf die Subnetze. Amazon VPC
Stellen Sie sicher, dass die Regeln Ihrer Sicherheitsgruppe für ausgehenden Datenverkehr zulassen, dass der Datenverkehr von den Amazon Kendra -Datenquellen-Konnektoren auf die Subnetze und die Datenquelle zugreifen kann, mit der Sie synchronisieren möchten. Sagen wir beispielsweise, Sie verwenden einen MySQL-Konnektor für die Synchronisierung aus einer MySQL-Datenbank. Wenn Sie den Standardport verwenden, müssen die Sicherheitsgruppen den Zugriff auf Port 3306 auf dem Host ermöglichen Amazon Kendra , auf dem die Datenbank ausgeführt wird.
Wir empfehlen, dass Sie eine Standardsicherheitsgruppe mit den folgenden Werten für Amazon Kendra die Verwendung konfigurieren:
+ **Regeln für eingehenden Datenverkehr** – Wenn Sie dieses Feld leer lassen, wird der gesamte eingehende Verkehr blockiert.
+ **Regeln für ausgehenden** Datenverkehr — Fügen Sie eine Regel hinzu, um den gesamten ausgehenden Datenverkehr zuzulassen, sodass die Synchronisierungsanforderungen aus Ihrer Datenquelle initiiert werden Amazon Kendra können.
+ **IP-Version** — IPv4
+ **Typ** – Gesamter Datenverkehr
+ **Protokoll** – Gesamter Datenverkehr
+ **Portbereich** – Alle
+ **Ziel** — 0.0.0.0/0
Weitere Informationen zur Konfiguration von Amazon VPC Sicherheitsgruppen finden Sie unter [Sicherheitsgruppenregeln](https://docs.aws.amazon.com/vpc/latest/userguide/security-group-rules.html) im *Amazon VPC-Benutzerhandbuch*.
## Schritt 3. Konfigurieren Sie Ihre externe Datenquelle und Amazon VPC
Stellen Sie sicher, dass Ihre externe Datenquelle über die richtigen Berechtigungen, Konfigurationen und Netzwerkeinstellungen für Amazon Kendra den Zugriff verfügt. Detaillierte Anleitungen zur Konfiguration Ihrer Datenquellen finden Sie im Abschnitt mit den Voraussetzungen auf jeder Konnektor-Seite.
Überprüfen Sie außerdem Ihre Amazon VPC Einstellungen und stellen Sie sicher, dass Ihre externe Datenquelle von dem Subnetz aus erreichbar ist, dem Sie sie zuweisen möchten Amazon Kendra. Zu diesem Zweck empfehlen wir, dass Sie eine Amazon EC2 Instanz im selben Subnetz mit denselben Sicherheitsgruppen erstellen und den Zugriff auf Ihre Datenquelle von dieser Amazon EC2 Instanz aus testen. Weitere Informationen finden Sie unter [Amazon VPC Verbindungsprobleme beheben](https://docs.aws.amazon.com/kendra/latest/dg/vpc-connector-troubleshoot.html).
# Richten Sie eine Amazon Kendra Datenquelle ein, zu der eine Verbindung hergestellt werden soll Amazon VPC
Wenn Sie eine neue Datenquelle hinzufügen Amazon Kendra, können Sie die Amazon VPC Funktion verwenden, sofern der ausgewählte Datenquellenconnector diese Funktion unterstützt.
Sie können eine neue Amazon Kendra Datenquelle mit Amazon VPC aktivierter Option einrichten, indem Sie die AWS-Managementkonsole oder die Amazon Kendra API verwenden. Verwenden Sie insbesondere die API-Operation [https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html) und dann den Parameter `VpcConfiguration`, um die folgenden Informationen bereitzustellen:
+ `SubnetIds`— Eine Liste von Identifikatoren von Subnetzen Amazon VPC
+ `SecurityGroupIds`— Eine Liste von Kennungen von Sicherheitsgruppen Amazon VPC
Wenn Sie die Konsole verwenden, geben Sie die erforderlichen Amazon VPC Informationen bei der Konfiguration des Connectors an. Um die Amazon-VPC-Funktion für einen Konnektor über die Konsole zu aktivieren, wählen Sie zunächst eine Amazon VPC aus. Dann geben Sie die IDs der Amazon-VPC-Subnetze und die IDs der Amazon-VPC-Sicherheitsgruppen an. Sie können die Amazon-VPC-Subnetze und Amazon-VPC-Sicherheitsgruppen auswählen, die Sie unter [Konfigurieren von Amazon VPC](https://docs.aws.amazon.com/kendra/latest/dg/connector-vpc-steps.html) erstellt haben, oder vorhandene verwenden.
**Topics**
+ [
## Amazon VPC Identifikatoren anzeigen
](#viewing-vpc-identifiers)
+ [
## Überprüfen Sie Ihre Datenquellenrolle IAM
](#vpc-iam-roles)
## Amazon VPC Identifikatoren anzeigen
Die Identifikatoren für Subnetze und Sicherheitsgruppen werden in der Konsole konfiguriert. Amazon VPC Gehen Sie wie folgt vor, um die IDs anzuzeigen.
**So zeigen Sie Subnetz-IDs an**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon VPC-Konsole unter [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/).
1. Wählen Sie im Navigationsbereich **Subnetze** aus.
1. Wählen Sie aus der Liste **Subnetze** das Subnetz aus, das Ihren Datenbankserver enthält.
1. Notieren Sie sich auf der Registerkarte **Details** die ID im Feld **Subnetz-ID**.
**So zeigen Sie Sicherheitsgruppen-IDs an**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon VPC-Konsole unter [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/).
1. Wählen Sie im Navigationsbereich **Sicherheitsgruppen** aus.
1. Wählen Sie in der Liste der Sicherheitsgruppen die Gruppe aus, für die Sie die ID benötigen.
1. Notieren Sie sich auf der Registerkarte **Details** die ID im Feld **Sicherheitsgruppen-ID**.
## Überprüfen Sie Ihre Datenquellenrolle IAM
Stellen Sie sicher, dass Ihre Rolle als Datenquelle AWS Identity and Access Management IAM(Connector) Berechtigungen für den Zugriff auf Ihre enthält Amazon VPC.
Wenn Sie die Konsole verwenden, um eine neue Rolle für Ihre IAM Rolle zu erstellen, Amazon Kendra werden Ihrer IAM Rolle automatisch in Ihrem Namen die richtigen Berechtigungen hinzugefügt. Wenn Sie die API oder eine bestehende IAM Rolle verwenden, überprüfen Sie, ob Ihre Rolle Zugriffsberechtigungen enthält Amazon VPC. Informationen dazu, ob Sie über die richtigen Berechtigungen verfügen, finden Sie unter [IAM Rollen für VPC](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-vpc).
Sie können eine vorhandene Datenquelle ändern, um ein anderes Amazon VPC -Subnetz zu verwenden. Überprüfen Sie jedoch die IAM Rolle Ihrer Datenquelle und ändern Sie sie gegebenenfalls entsprechend der Änderung, damit der Amazon Kendra Datenquellen-Connector ordnungsgemäß funktioniert.
# Verbindung zu einer Datenbank in einer VPC herstellen
Das folgende Beispiel zeigt, wie eine MySQL Datenbank, die in einer Virtual Private Cloud (VPC) läuft, verbunden wird. Das Beispiel geht davon aus, dass Sie mit Ihrer Standard-VPC beginnen und dass Sie eine MySQL Datenbank erstellen müssen. Wenn Sie bereits über eine VPC verfügen, stellen Sie sicher, dass sie wie abgebildet konfiguriert ist. Wenn Sie über eine MySQL Datenbank verfügen, können Sie diese verwenden, anstatt eine neue zu erstellen.
**Topics**
+ [
## Schritt 1: Konfiguration einer VPC
](#vpc-example-1)
+ [
## Schritt 2: Sicherheitsgruppen erstellen und konfigurieren
](#vpc-example-2)
+ [
## Schritt 3: Erstellen Sie eine Datenbank
](#vpc-example-3)
+ [
## Schritt 4: Erstellen Sie einen Datenquellen-Connector
](#vpc-example-4)
## Schritt 1: Konfiguration einer VPC
Konfigurieren Sie Ihre VPC so, dass Sie über ein privates Subnetz und eine Sicherheitsgruppe für den Amazon Kendra Zugriff auf eine MySQL Datenbank verfügen, die im Subnetz läuft. Die in der VPC-Konfiguration bereitgestellten Subnetze müssen sich in der Region USA West (Oregon), der Region USA Ost (Nord-Virginia) oder der Region Europa (Irland) befinden.
**So konfigurieren Sie eine VPC mit Amazon VPC**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon VPC-Konsole unter [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/).
1. Wählen Sie im Navigationsbereich **Routen-Tabellen** und anschließend **Routentabelle erstellen** aus.
1. Geben Sie in das Feld **Name** ein**Private subnet route table**. Wählen Sie in der **VPC-Dropdownliste** Ihre VPC aus und wählen Sie dann Routentabelle **erstellen** aus. Wählen Sie **Schließen**, um zur Liste der Routentabellen zurückzukehren.
1. Wählen Sie im Navigationsbereich **NAT-Gateways** und dann **Create NAT-Gateway** aus.
1. Wählen Sie aus der Dropdownliste **Subnetz** das Subnetz aus, das das öffentliche Subnetz ist. Notieren Sie sich die Subnetz-ID.
1. **Wenn Sie keine Elastic IP-Adresse haben, wählen Sie **Create New EIP**, **Create a NAT Gateway** und dann Close aus.**
1. Wählen Sie im Navigationsbereich die Option **Route-Tabellen** aus.
1. Wählen Sie aus der Routentabellenliste die **Routingtabelle für private Subnetze** aus, die Sie in Schritt 3 erstellt haben. Wählen Sie **unter Aktionen** die Option **Routen bearbeiten** aus.
1. Wählen Sie **Route hinzufügen** aus. Geben Sie für das Ziel ein, **0.0.0.0/0** um den gesamten ausgehenden Datenverkehr ins Internet zuzulassen. Wählen Sie für **Target** die Option **NAT Gateway** und dann das Gateway aus, das Sie in Schritt 4 erstellt haben. Wählen **Sie Änderungen speichern** und dann **Schließen** aus.
1. Wählen Sie **unter Aktionen** die Option **Subnetzzuordnungen bearbeiten** aus.
1. Wählen Sie die Subnetze aus, die privat sein sollen. Wählen Sie nicht das Subnetz mit dem NAT-Gateway, das Sie zuvor angegeben haben. Wählen Sie **Verknüpfungen speichern**, wenn Sie fertig sind.
## Schritt 2: Sicherheitsgruppen erstellen und konfigurieren
Als Nächstes konfigurieren Sie Sicherheitsgruppen für Ihre Datenbank.
**Um Sicherheitsgruppen zu erstellen und zu konfigurieren**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon VPC-Konsole unter [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/).
1. Notieren Sie sich den IPv4 CIDR in der Beschreibung Ihrer VPC.
1. Wählen Sie im Navigationsbereich **Sicherheitsgruppen** und dann **Sicherheitsgruppe erstellen** aus.
1. Geben Sie für **Security group name** (Name der Sicherheitsgruppe) **DataSourceInboundSecurityGroup** ein. Geben Sie eine Beschreibung ein und wählen Sie dann Ihre VPC aus der Liste aus. Wählen Sie **Sicherheitsgruppe erstellen** und dann **Schließen** aus.
1. Wählen Sie die Registerkarte **Inbound rules** (Regeln für eingehenden Datenverkehr) aus.
1. Wählen Sie **Regeln für eingehenden Datenverkehr bearbeiten** und anschließend Regel **hinzufügen**
1. Geben Sie für eine Datenbank die Portnummer für den **Portbereich** ein. Zum Beispiel für MySQL es ist**3306**, und für HTTPS ist es**443**. Geben Sie als **Quelle** das Classless Inter-Domain Routing (CIDR) Ihrer VPC ein. **Wählen Sie **Regeln speichern und dann Schließen** aus.**
Die Sicherheitsgruppe ermöglicht es jedem innerhalb der VPC, eine Verbindung zur Datenbank herzustellen, und sie ermöglicht ausgehende Verbindungen zum Internet.
## Schritt 3: Erstellen Sie eine Datenbank
Erstellen Sie eine Datenbank für Ihre Dokumente, oder Sie können Ihre bestehende Datenbank verwenden.
Anweisungen zum Erstellen einer MySQL Datenbank finden Sie unter [https://docs.aws.amazon.com/kendra/latest/dg/data-source-mysql.html](https://docs.aws.amazon.com/kendra/latest/dg/data-source-mysql.html).
## Schritt 4: Erstellen Sie einen Datenquellen-Connector
Nachdem Sie Ihre VPC konfiguriert und Ihre Datenbank erstellt haben, können Sie einen Datenquellenconnector für die Datenbank erstellen. Informationen zu Datenbank-Connectors, die dies Amazon Kendra unterstützen, finden Sie unter [Unterstützte Konnektoren](https://docs.aws.amazon.com/kendra/latest/dg/data-sources.html).
Stellen Sie für Ihre Datenbank sicher, dass Sie Ihre VPC, die privaten Subnetze, die Sie in Ihrer VPC erstellt haben, und die Sicherheitsgruppe, die Sie in Ihrer VPC erstellt haben, konfigurieren.
# Behebung VPC VPC-Verbindungsproblemen
Wenn Sie Probleme mit Ihrer Virtual Private Cloud (VPC) -Verbindung haben, überprüfen Sie, ob Ihre IAM Berechtigungen, Sicherheitsgruppeneinstellungen und die Routing-Tabellen des Subnetzes korrekt konfiguriert sind.
Eine mögliche Ursache für eine fehlgeschlagene Datenquellen-Connector-Synchronisierung ist, dass die Datenquelle von dem Subnetz aus, dem Sie sie zugewiesen haben, möglicherweise nicht erreichbar ist. Amazon Kendra Um dieses Problem zu beheben, empfehlen wir, dass Sie eine Amazon EC2 Instanz mit denselben Amazon VPC Einstellungen erstellen. Versuchen Sie dann, mithilfe von REST-API-Aufrufen oder anderen Methoden (basierend auf dem spezifischen Typ Ihrer Datenquelle) von dieser Amazon EC2 Instanz aus auf die Datenquelle zuzugreifen.
Wenn Sie von der Amazon EC2 Instanz, die Sie erstellen, erfolgreich auf die Datenquelle zugreifen, bedeutet dies, dass Ihre Datenquelle von diesem Subnetz aus erreichbar ist. Daher hängt Ihr Synchronisierungsproblem nicht damit zusammen, dass auf Ihre Datenquelle von nicht zugegriffen werden kann. Amazon VPC
Wenn Sie nicht über Ihre VPC-Konfiguration auf Ihre Amazon EC2 Instance zugreifen und sie mit der von Ihnen erstellten Amazon EC2 Instance validieren können, müssen Sie weitere Problembehebungen durchführen. Wenn Sie beispielsweise einen Amazon S3 Connector haben, dessen Synchronisierung aufgrund von Verbindungsproblemen fehlgeschlagen ist, können Sie eine Amazon EC2 Instanz mit derselben Amazon VPC Konfiguration einrichten, die Sie Ihrem Amazon S3 Connector zugewiesen haben. Verwenden Sie dann diese Amazon EC2 EC2-Instance, um zu testen, ob Ihre richtig eingerichtet Amazon VPC wurde.
Im Folgenden finden Sie ein Beispiel für die Einrichtung einer Amazon EC2 Instance zur Fehlerbehebung bei Ihrer Amazon VPC Verbindung mit einer Amazon S3 Datenquelle.
**Topics**
+ [
## Schritt 1: Starten Sie eine Amazon EC2 Instanz
](#vpc-connector-troubleshoot-1)
+ [
## Schritt 2: Connect zur Amazon EC2 Instanz herstellen
](#vpc-connector-troubleshoot-2)
+ [
## Schritt 3: Testen Sie den Zugriff Amazon S3
](#vpc-connector-troubleshoot-3)
## Schritt 1: Starten Sie eine Amazon EC2 Instanz
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon EC2 EC2-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Wählen Sie **Instance starten** aus.
1. Wählen Sie **Netzwerkeinstellungen** und dann **Bearbeiten** und gehen Sie dann wie folgt vor:
1. Wählen Sie dieselbe VPC und dasselbe **Subnetz** aus, denen Sie sie zugewiesen haben. Amazon Kendra
1. Für **Firewall (Sicherheitsgruppen)** wählen Sie **Eine vorhandene Sicherheitsgruppe auswählen** aus. Wählen Sie dann die Sicherheitsgruppe aus, der Sie sie zugewiesen haben. Amazon Kendra
**Anmerkung**
Die Sicherheitsgruppe sollte ausgehenden Datenverkehr zulassen Amazon S3.
1. **Stellen Sie die **Option Öffentliche IP automatisch zuweisen auf Deaktivieren** ein.**
1. Gehen Sie **unter Erweiterte Details** wie folgt vor:
+ Wählen Sie **unter IAM-Instanzprofil** die Option **Neues IAM-Profil erstellen aus, um ein Instanzprofil** zu erstellen und an Ihre IAM Instance anzuhängen. Stellen Sie sicher, dass das Profil über Zugriffsberechtigungen verfügt. Amazon S3 Weitere Informationen finden Sie unter [Wie kann ich meiner Amazon EC2 Instance Zugriff auf einen Amazon S3 Bucket gewähren?](https://repost.aws/knowledge-center/ec2-instance-access-s3-bucket) in AWS re:Post.
+ Behalten Sie alle anderen Einstellungen als Standard bei.
1. Überprüfen und starten Sie die Amazon EC2 Instanz.
## Schritt 2: Connect zur Amazon EC2 Instanz herstellen
Nachdem Ihre Amazon EC2 Instance ausgeführt wurde, rufen Sie Ihre Instance-Detailseite auf und stellen Sie eine Verbindung zu Ihrer Instance her. Verwenden Sie dazu die Schritte unter Verbindung mit [Ihren Instances herstellen, ohne dass eine öffentliche IPv4-Adresse erforderlich ist. Verwenden Sie dazu den EC2 Instance Connect Endpoint](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connect-with-ec2-instance-connect-endpoint.html) im *Amazon EC2 Benutzerhandbuch für Linux-Instances*.
## Schritt 3: Testen Sie den Zugriff Amazon S3
Nachdem Sie eine Verbindung zu Ihrem Amazon EC2 Instance-Terminal hergestellt haben, führen Sie einen AWS CLI Befehl aus, um die Verbindung von diesem privaten Subnetz zu Ihrem Amazon S3 Bucket zu testen.
Um den Amazon S3 Zugriff zu testen, geben Sie den folgenden AWS CLI Befehl in das AWS CLI Feld ein: `aws s3 ls`
Überprüfen Sie nach der Ausführung des AWS CLI Befehls Folgendes:
+ Wenn Sie die erforderlichen IAM Berechtigungen korrekt eingerichtet haben und Ihr Amazon S3 Setup korrekt ist, sollte eine Liste Ihrer Amazon S3 Buckets angezeigt werden.
+ Wenn Sie beispielsweise Berechtigungsfehler sehen`Access Denied`, ist es wahrscheinlich, dass Ihre VPC-Konfiguration korrekt ist, aber etwas mit Ihren IAM Berechtigungen oder Amazon S3 Ihrer Bucket-Richtlinie nicht stimmt.
Wenn für den Befehl ein Timeout auftritt, ist es wahrscheinlich, dass es bei Ihrer Verbindung zu einem Timeout kommt, weil Ihre VPC-Setup falsch ist und die Amazon EC2 EC2-Instance nicht von Ihrem Subnetz aus auf Amazon S3 zugreifen kann. Konfigurieren Sie Ihre VPC neu und versuchen Sie es erneut.