View a markdown version of this page

Mit JDBC eine Verbindung zu Ihrer Datenbank herstellen - Amazon Connect Connect-Entscheidungen
Was ist eine JDBC-Verbindung und wann sollten Sie sie verwenden?VoraussetzungenErstellen Sie einen Customer-Managed KMS-SchlüsselAWS Secrets Manager konfigurierenVerbinden Sie Ihre Datenbank mit Amazon Connect DecisionsBewährte Methoden

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Mit JDBC eine Verbindung zu Ihrer Datenbank herstellen

Dieser Leitfaden führt Sie durch die Verbindung Ihrer Datenbank mit Amazon Connect Decisions mithilfe von Java Database Connectivity (JDBC). Sie richten eine sichere Verschlüsselung für Ihre Datenbankanmeldedaten ein und stellen eine Verbindung her, über die Amazon Connect Decisions auf Ihre Daten zugreifen kann.

Was ist eine JDBC-Verbindung und wann sollten Sie sie verwenden?

Durch die JDBC-Verbindung kann Amazon Connect Decisions eine Verbindung zu Ihrer vorhandenen Datenbank herstellen, um Daten zu lesen, anstatt dass Sie CSV-Dateien exportieren und hochladen oder Ihre eigenen Extractions-, Transformations-, Load- (ETL) -Pipelines für S3 einrichten müssen. Dieser Ansatz ist ideal, wenn:

  • Ihre Daten sind bereits in einer Glue-compatible relationalen AWS-Datenbank gespeichert. Kompatible Datenbanken und Versionen finden Sie in diesem Handbuch.

  • Sie möchten Datenzugriff in Echtzeit oder nahezu in Echtzeit ohne manuelle Dateiexporte

  • Ihr Datenvolumen ist groß und wird häufig aktualisiert

  • Sie ziehen es vor, Ihre Daten an ihrem aktuellen Standort zu behalten, anstatt sie zu duplizieren

  • Wenn Sie mit kleineren Datensätzen arbeiten oder dateibasierte Uploads bevorzugen, ist der standardmäßige CSV-Upload-Prozess für Ihre Bedürfnisse möglicherweise einfacher. Weitere Informationen zu diesem Prozess finden Sie im Data Onboarding-Benutzerhandbuch.

Voraussetzungen

Stellen Sie vor Beginn sicher, dass Sie über Folgendes verfügen:

  • Ein AWS-Konto mit Berechtigungen zum Erstellen von KMS-Schlüsseln und Secrets Manager Manager-Ressourcen

  • Ihre AWS-Konto-ID und die Region, in der Amazon Connect Decisions tätig sein wird

  • Verbindungsdetails zur Datenbank: Hostname, Port, Datenbankname und Anmeldeinformationen

  • Administratorzugriff auf Ihre Datenbank zur Überprüfung der Konnektivität

  • Ihre Datenbank ist so konfiguriert, dass sie Verbindungen von AWS-Services akzeptiert

Erstellen Sie einen Customer-Managed KMS-Schlüssel

Bevor Sie Ihre Datenbank mit Amazon Connect Decisions verbinden, müssen Sie die Verschlüsselung Ihrer Datenbankanmeldedaten einrichten. AWS Key Management Service (KMS) bietet diese Sicherheitsebene und stellt sicher, dass Ihre Verbindungsdetails geschützt bleiben.

Erstellen Sie Ihren KMS-Schlüssel

  1. Navigieren Sie zur AWS KMS KMS-Konsole

    • Öffnen Sie die AWS-Managementkonsole in Ihrem Browser

    • Geben Sie in der Suchleiste oben „KMS“ ein und wählen Sie aus den Ergebnissen „Key Management Service“ aus

    • Dadurch wird das KMS-Dashboard geöffnet, in dem Sie die Verschlüsselungsschlüssel verwalten

  2. Initiieren Sie die Schlüsselerstellung

    • Suchen Sie im KMS-Dashboard oben rechts nach der Schaltfläche Schlüssel erstellen und klicken Sie darauf

    • Dadurch wird der Assistent zur Schlüsselerstellung gestartet, der Sie durch den Einrichtungsprozess führt

  3. Konfigurieren Sie den Schlüsseltyp und die Verwendung

    • Wählen Sie auf der Seite „Schlüssel konfigurieren“ den Schlüsseltyp Symmetrisch aus (dies ist die Standardoption und die empfohlene Option)

    • Lassen Sie unter Schlüsselverwendung die Option „Verschlüsseln und Entschlüsseln“ ausgewählt

  4. Legen Sie die Details zur Schlüsselidentifikation fest

    • Geben Sie im Feld „Alias“ einen aussagekräftigen Namen für Ihren Schlüssel ein, z. B. aws-supply-chain-database-key

    • Fügen Sie im Feld „Beschreibung“ einen Kontext wie „Verschlüsselungsschlüssel für Amazon Connect Decisions-Datenbankanmeldedaten“ hinzu

    • Fügen Sie optional Tags hinzu, um Ihre AWS-Ressourcen zu organisieren und nachzuverfolgen (z. B. Key: „Project“, Value: „Amazon Connect Decisions“)

  5. Definieren Sie wichtige Administratorberechtigungen

    • Wählen Sie die IAM-Benutzer oder -Rollen aus, die in der Lage sein sollen, diesen Schlüssel zu verwalten (Richtlinien erstellen, löschen, ändern)

    • Fügen Sie mindestens Ihre eigene Admin-Rolle hinzu, um sicherzustellen, dass Sie den Schlüssel später bei Bedarf ändern können

    • Diese Administratoren können den Schlüssel verwalten, haben aber nicht automatisch die Erlaubnis, ihn zu verwenden encryption/decryption

    • Wählen Sie im Bereich „Löschen von Schlüsseln“ die Option Schlüsseladministratoren erlauben, diesen Schlüssel zu löschen. (Dies ist die Standardoption und die empfohlene Option)

  6. Definieren Sie die Berechtigungen zur Verwendung von Schlüsseln

    • Auf dieser Seite finden Sie Optionen zur Auswahl von IAM-Benutzern und -Rollen, die den Schlüssel verwenden können

    • Überspringen Sie hier die Auswahl bestimmter Benutzer. Im nächsten Schritt konfigurieren Sie die Serviceberechtigungen

  7. Konfigurieren Sie die wichtigsten Richtlinien für die Amazon Connect Decisions-Dienste

    • Es wird ein Richtlinien-Editor mit Standard-JSON angezeigt

    • Fügen Sie im KMS-Schlüsselrichtlinien-Editor die folgende Anweisung an Ihr vorhandenes Array „Statement“ an

    • Diese Richtlinie gewährt Ihrem Konto die volle Kontrolle und ermöglicht es den Diensten von Amazon Connect Decisions (Secrets Manager und Glue), Ihre Datenbankanmeldeinformationen zu entschlüsseln.

    {
  "Sid": "Allow GDIS service to decrypt",
  "Effect": "Allow",
  "Principal": {
    "Service": "scn.amazonaws.com"
  },
  "Action": [
    "kms:Decrypt",
    "kms:DescribeKey",
    "kms:CreateGrant",
    "kms:GenerateDataKeyWithoutPlaintext"
  ],
  "Resource": "*"
}

  8. Überprüfen und abschließen

    • Überprüfen Sie alle Ihre Konfigurationseinstellungen auf der Übersichtsseite

    • Vergewissern Sie sich, dass Ihr Alias, Ihre Beschreibung und Ihre Richtlinie korrekt sind

    • Klicken Sie auf Fertig stellen, um den Schlüssel zu erstellen

    • Nach der Erstellung kehren Sie zum KMS-Dashboard zurück, wo Ihr neuer Schlüssel in der Liste erscheint

Was ist zu erwarten

Die Schlüsselerstellung erfolgt sofort. Nach der Erstellung wird Ihr neuer Schlüssel in der KMS-Konsole mit dem Status „Aktiviert“ aufgeführt. Der Schlüssel ist jetzt bereit, Ihre Datenbankanmeldedaten in Secrets Manager zu verschlüsseln.

AWS Secrets Manager konfigurieren

Nachdem Sie über einen KMS-Schlüssel verfügen, erstellen Sie einen geheimen Schlüssel in AWS Secrets Manager, um Ihre Datenbankanmeldedaten sicher zu speichern, und konfigurieren dann eine Ressourcenrichtlinie, die Amazon Connect Decisions den Zugriff auf dieses Geheimnis ermöglicht.

Erstellen Sie Ihr Geheimnis

  1. Navigieren Sie zu AWS Secrets Manager

    • Geben Sie in der Suchleiste der AWS-Managementkonsole „Secrets Manager“ ein

    • Wählen Sie „Secrets Manager“ aus den Ergebnissen aus, um das Service-Dashboard zu öffnen

  2. Fangen Sie an, ein neues Geheimnis zu erstellen

    • Klicken Sie auf die Schaltfläche Neues Geheimnis speichern

    • Wählen Sie auf der Seite „Geheimtyp auswählen“ die Option Anderer Geheimtyp aus (dies gibt Ihnen Flexibilität bei der Strukturierung Ihrer Anmeldeinformationen)

  3. Geben Sie Ihre Datenbankanmeldedaten ein

    • Fügen Sie im Abschnitt Schlüssel-Wert-Paare Ihre Datenbankverbindungsdetails als Zeichenfolgen hinzu:

    Key: username, Value: your database username
Key: password, Value: your database password
Key: host, Value: your database hostname (e.g., database.example.com)
Key: port, Value: your database port (e.g., 3306 for MySQL)
Key: database, Value: your database name

  4. Wählen Sie Ihren Verschlüsselungsschlüssel

    • Wählen Sie unter „Verschlüsselungsschlüssel“ die Option Wählen Sie einen AWS-KMS-Schlüssel

    • Wählen Sie aus der Dropdownliste den KMS-Schlüssel aus, den Sie in Schritt 1 erstellt haben (z. B.aws-supply-chain-database-key)

    • Dadurch wird sichergestellt, dass Ihre Anmeldeinformationen mit Ihrem vom Kunden verwalteten Schlüssel verschlüsselt sind

  5. Nennen Sie Ihr Geheimnis

    • Geben Sie einen aussagekräftigen Namen für Ihr Geheimnis ein, z. B. aws-supply-chain-production-database

    • Fügen Sie optional eine Beschreibung wie „Datenbankanmeldedaten für die Produktionsumgebung von Amazon Connect Decisions“ hinzu

    • Fügen Sie bei Bedarf Tags für die Organisation hinzu (z. B. Schlüssel: „Umgebung“, Wert: „Produktion“)

  6. Fügen Sie Ressourcenberechtigungen hinzu

    • Klicken Sie auf „Berechtigungen bearbeiten“. Fügen Sie im Richtlinien-Editor die folgende Richtlinie ein. Diese Richtlinie ermöglicht es den Diensten von Amazon Connect Decisions, Ihr Geheimnis zu lesen.

    {
  "Version" : "2012-10-17",
  "Statement" : [ {
    "Effect" : "Allow",
    "Principal" : {
      "Service" : "scn.amazonaws.com"
    },
    "Action" : [ "secretsmanager:GetSecretValue", "secretsmanager:DescribeSecret" ],
    "Resource" : "<COPY-THE-SECRET-ARN-HERE-AFTER-CREATING>"
  } ]
}

  7. Speichern Sie die Richtlinie

    • Klicken Sie auf Speichern, um die Ressourcenrichtlinie anzuwenden

    • Die Richtlinie ist jetzt aktiv und ermöglicht Amazon Connect Decisions, Ihre Datenbankanmeldedaten abzurufen.

  8. Rotation konfigurieren (optional)

    • Bei diesem Setup können Sie die automatische Rotation überspringen, indem Sie Automatische Rotation deaktivieren auswählen

    • Sie können die Rotation später aktivieren, wenn Ihre Sicherheitsrichtlinien dies erfordern

  9. Überprüfen und erstellen

    • Überprüfe all deine geheimen Daten

    • Klicken Sie auf Speichern, um das Geheimnis zu erstellen

    • Sie werden zum Secrets Manager Manager-Dashboard zurückgeleitet

  10. Speichere deinen geheimen ARN

    • Finde dein neu erstelltes Geheimnis in der Geheimnisliste

    • Klicken Sie auf den geheimen Namen, um die zugehörige Detailseite zu öffnen

    • Oben siehst du den Secret ARN

    • Kopieren und speichern Sie diesen ARN

    • Das ARN-Format sieht wie folgt aus: arn:aws:secretsmanager:us-east-1:123456789012:secret:aws-supply-chain-production-database-AbCdEf

  11. Ressourcenberechtigungen bearbeiten

    • Klicken Sie auf „Berechtigungen bearbeiten“

    • Fügen Sie den kopierten geheimen ARN ein und <COPY-THE-SECRET-ARN-HERE-AFTER-CREATING> ersetzen Sie ihn durch Ihren kopierten ARN

    • Klicken Sie auf Speichern, um die Richtlinie anzuhängen

Was ist zu erwarten

Ihr Geheimnis ist jetzt sicher gespeichert und mit Ihrem KMS-Schlüssel verschlüsselt. Die Dienste von Amazon Connect Decisions sind berechtigt, die Anmeldeinformationen abzurufen, wenn eine Datenbankverbindung hergestellt wird, aber die Anmeldeinformationen bleiben im Ruhezustand und bei der Übertragung verschlüsselt.

Verbinden Sie Ihre Datenbank mit Amazon Connect Decisions

Nachdem Ihr KMS-Schlüssel und Ihr KMS-Geheimnis konfiguriert sind, können Sie die JDBC-Verbindung in Amazon Connect Decisions einrichten.

Konfigurieren Sie Ihre JDBC-Verbindung

  1. Navigieren Sie zu Amazon Connect Decisions > Data Management

    • Melden Sie sich bei Ihrer Amazon Connect Decisions-Instance an

    • Wählen Sie in der Hauptnavigation „Datenmanagement“

    • Navigieren Sie in der Tab-Navigation zu „Verbindungen“

    • Wählen Sie „Neue Verbindung“, um eine neue Verbindung zu erstellen

  2. Geben Sie Ihre Verbindungsdetails ein

    • Verbindungsname (erforderlich): Geben Sie eine eindeutige Kennung für diese Verbindung ein (z. B. „Produktionsdatenbank“)

    • Beschreibung (optional): Fügen Sie Details zum Zweck und zur Verwendung dieser Verbindung hinzu, damit Ihr Team versteht, auf welche Daten es zugreift

    • JDBC-URL (erforderlich): Geben Sie Ihre vollständige JDBC-Verbindungszeichenfolge im folgenden Format ein: (z. B.) jdbc:<database-type>://<hostname>:<port>/<database> jdbc:postgresql://db.example.com:5432/mydb

    • Schemaname (optional): Geben Sie bei Bedarf das Datenbankschema an (z. B. „public“, „dbo“, „myschema“). Lassen Sie das Feld leer, um das Standardschema Ihrer Datenbank zu verwenden

    • Geheimer ARN (erforderlich): Fügen Sie den geheimen ARN ein, den Sie in Schritt 2 gespeichert haben. Auf diese Weise kann Amazon Connect Decisions Ihre Datenbankanmeldedaten sicher aus Secrets Manager abrufen.

    • SSL-Verbindung erzwingen: Lassen Sie dieses Kontrollkästchen aktiviert (empfohlen), um eine SSL/TLS Verschlüsselung für Ihre Datenbankverbindung zu verlangen

    • VPC-Endpunkt-Servicename (erforderlich): Geben Sie Ihren VPC-Endpunkt-Servicenamen für private Konnektivität über AWS ein PrivateLink (Format:) com.amazonaws.vpce.<region>.vpce-svc-xxxxxxxxx

  3. Connect zu Ihrer Datenbank her

    • Klicken Sie auf „Connect“, um die Verbindung zu testen und herzustellen. Amazon Connect Decisions überprüft, ob es mit den angegebenen Anmeldeinformationen erfolgreich eine Verbindung zu Ihrer Datenbank herstellen kann. Dieser Schritt kann bis zu 2 Minuten dauern. Bitte verlassen Sie diesen Bildschirm nicht, während die Verbindung hergestellt wird.

    • Wenn die Verbindung erfolgreich ist, werden Sie automatisch zur Tabellenauswahl weitergeleitet

    • Wenn die Verbindung fehlschlägt:

      • Überprüfe deine Verbindungsdetails, um sicherzustellen, dass alle Felder korrekt sind:

        • Stellen Sie sicher, dass Ihr geheimer ARN korrekt ist

        • Bestätigen Sie, dass Ihre Datenbankanmeldedaten korrekt sind

        • Vergewissern Sie sich, dass Ihr JDBC-URL-Format korrekt ist

        • Stellen Sie sicher, dass Ihre Datenbank so konfiguriert ist, dass sie Verbindungen von AWS-Services akzeptiert

        • Stellen Sie sicher, dass Ihr KMS-Schlüssel und die Secrets Manager Manager-Richtlinien korrekt konfiguriert sind

      • Sie können das Chat-Erlebnis auch zur Behebung von Verbindungsproblemen nutzen, indem Sie Fragen wie „Warum schlägt meine Datenbankverbindung fehl?“ stellen oder „Hilf mir, meine JDBC-Verbindung zu debuggen“

  4. Wählen Sie die zu importierenden Tabellen aus

    • Sobald die Verbindung hergestellt ist, wird der Bildschirm „Tabellen auswählen“ mit allen verfügbaren Tabellen aus Ihrer Datenbank angezeigt

    • Markieren Sie das Kontrollkästchen neben jeder Tabelle, die Sie aufnehmen möchten

  5. Konfigurieren Sie den Zeitplan für die Tabellenaktualisierung

    • Klicken Sie für jede ausgewählte Tabelle auf das Dreipunktmenü in der Spalte Aktion und wählen Sie „Aktualisierung planen“

    • Stellen Sie im Dialogfeld „Ladedetails konfigurieren“ Folgendes ein:

      • Schrittfrequenz: Wie oft aktualisiert werden soll (stündlich, täglich, wöchentlich oder Benutzerdefiniert)

      • Startstunde: Die Zeit, zu der die Aktualisierung beginnen soll (wird in UTC mit Ihrem Zeitzonen-Offset angezeigt)

      • Aktualisierungstyp: Wählen Sie Vollständige Aktualisierung (alle Daten ersetzen) oder Inkrementelles Update (neue Daten zu vorhandenen hinzufügen; erfordert die Auswahl einer Spalte mit dem Zeitstempel für Datensätze)

      • Wiederholen Sie den Vorgang nach Bedarf für jede Tabelle

    • Klicken Sie auf Zuordnung starten, wenn alle Tabellen konfiguriert sind

  6. Fahren Sie mit der Datenzuordnung fort

    • Ab diesem Zeitpunkt ist die Erfahrung identisch mit unserem Daten-Onboarding-Ablauf

    • Folgen Sie dem Abschnitt Datenzuweisung im Data Onboarding-Benutzerhandbuch, um Ihre Einrichtung abzuschließen

Was ist zu erwarten

Sobald Ihre Verbindung hergestellt und Tabellen ausgewählt sind, kann Amazon Connect Decisions Daten aus Ihrer Datenbank lesen. Die Verbindung bleibt aktiv und sicher, wobei die Anmeldeinformationen über AWS Secrets Manager verschlüsselt und verwaltet werden. Sie müssen die Anmeldeinformationen in Amazon Connect Decisions nicht manuell aktualisieren. Alle Änderungen, die Sie in Secrets Manager vornehmen, werden automatisch übernommen.

Bewährte Methoden

Sicherheits- und Zugriffsmanagement

  • Anmeldeinformationen sicher speichern: Verwenden Sie immer AWS Secrets Manager, um Datenbankanmeldedaten zu speichern, niemals hartcodieren Sie Anmeldeinformationen in Verbindungszeichenfolgen oder Konfigurationsdateien

  • SSL/TLS Verschlüsselung aktivieren: Lassen Sie die Option „SSL-Verbindung erzwingen“ aktiviert, um sicherzustellen, dass Daten während der Übertragung verschlüsselt werden

  • Überprüfen Sie regelmäßig die Richtlinien von KMS und Secrets Manager: Stellen Sie sicher, dass nur autorisierte Dienste und Konten Zugriff auf Ihre Verschlüsselungsschlüssel und Geheimnisse haben

  • Zugriff mit geringsten Rechten verwenden: Gewähren Sie Datenbankbenutzern nur die erforderlichen Mindestberechtigungen, die Amazon Connect Decisions für Verbindungen verwendet

Konfiguration der Verbindung

  • Verwenden Sie aussagekräftige Verbindungsnamen: Wählen Sie klare, aussagekräftige Namen, die auf die Umgebung und den Zweck hinweisen (z. B. „production-inventory-db“ statt „db1")

  • Dokumentieren Sie Ihre Verbindungen: Verwenden Sie das Feld Beschreibung, um zu notieren, auf welche Daten die Verbindung zugreift, wem sie gehört und welche Besonderheiten zu beachten sind

  • Testen Sie die Verbindungen, bevor Sie fortfahren: Stellen Sie immer sicher, dass Ihre Verbindung funktioniert, bevor Sie Tabellen auswählen und Aktualisierungszeitpläne konfigurieren

  • Überprüfen Sie das JDBC-URL-Format: Double-check Ihre JDBC-URL-Syntax entspricht Ihrem Datenbanktyp, um Verbindungsfehler zu vermeiden

Strategie zur Datenaktualisierung

  • Wählen Sie den geeigneten Aktualisierungsrhythmus: Wählen Sie die Aktualisierungshäufigkeit auf der Grundlage der Häufigkeit der Änderungen Ihrer Quelldaten und Ihrer Geschäftsanforderungen

  • Planen Sie Aktualisierungen in Zeiten geringer Aktivität: Konfigurieren Sie Aktualisierungszeiten, zu denen Ihre Datenbank weniger ausgelastet ist, um die Leistungseinbußen zu minimieren

  • Verwenden Sie nach Möglichkeit inkrementelle Aktualisierungen: Bei großen Datensätzen mit häufigen Änderungen sind inkrementelle Aktualisierungen effizienter als vollständige Aktualisierungen

  • Wählen Sie aussagekräftige Zeitstempelspalten aus: Wählen Sie bei inkrementellen Aktualisierungen Spalten aus, die genau wiedergeben, wann Datensätze erstellt oder geändert wurden

Zur Problembehandlung mit dem Chat arbeiten

  • Seien Sie bei Ihren Anfragen spezifisch: Geben Sie einen klaren Kontext an, wenn Sie um Hilfe bei der Behebung von Verbindungs- oder Zuordnungsproblemen bitten

  • Fragen Sie nach Erläuterungen: Wenn Sie die Empfehlungen oder generierten SQL-Abfragen nicht verstehen, bitten Sie um Klarstellung

  • Testen Sie alle SQL-Änderungen, bevor Sie sie akzeptieren: Verwenden Sie die Vorschaufunktion, um zu überprüfen, ob die Transformationen mit Ihren tatsächlichen Daten erwartungsgemäß funktionieren

  • Nutzen Sie den Chat zur Problembehandlung: Wenn Verbindungen fehlschlagen oder bei Aktualisierungen Fehler auftreten, stellen Sie Diagnosefragen wie „Warum schlägt meine Verbindung fehl?“ oder „Hilf mir, diesen Aktualisierungsfehler zu verstehen“

Laufende Wartung

  • Überwachen Sie die Ausführung von Aktualisierungen regelmäßig: Überprüfen Sie die Registerkarten Ziele und Quellen in Data Management, um sicherzustellen, dass die Aktualisierungen erfolgreich abgeschlossen werden

  • Fehler umgehend beheben: Wenn Amazon Connect Decisions Sie auffordert, Fehler zu aktualisieren, untersuchen und lösen Sie Probleme schnell, um Datenlücken zu vermeiden

  • Anmeldeinformationen sicher aktualisieren: Wenn sich Datenbankkennwörter ändern, aktualisieren Sie sie in AWS Secrets Manager. Amazon Connect Decisions verwendet die neuen Anmeldeinformationen automatisch

  • Dokumentieren Sie benutzerdefinierte Konfigurationen: Machen Sie sich Notizen zu speziellen Aktualisierungsplänen, Transformationslogik oder Verbindungsanforderungen als Referenz für Ihr Team

  • Überprüfen Sie die Tabellenauswahl regelmäßig: Wenn sich Ihre Datenanforderungen ändern, überprüfen Sie erneut, welche Tabellen Sie aufnehmen und ob die Aktualisierungspläne immer noch den Geschäftsanforderungen entsprechen