Workiva-ondersteuningscentrum

Met de MySQL® connector kunt u commando's in een keten gebruiken om gestructureerde querytaal (SQL) bewerkingen uit te voeren in MySQL databasesystemen, zoals Amazon® Aurora®. Met deze connector kunt u bijvoorbeeld:

• SQL-opdrachten uitvoeren, inclusief een CREATE of UPDATE verklaring of SELECT query
• Details over een tabel in MySQL ophalen
• Records invoegen in een MySQL database

Vereisten

Om de MySQL database te kunnen verbinden, gebruikt de connector Java database connectivity (JDBC), beveiligd met een basis gebruikersnaam en wachtwoord. Om de connector in te stellen, hebt u het volgende nodig:

• Een aangewezen integratiegebruiker die in de database is aangemaakt voor de connector
• De gebruikersnaam en het wachtwoord van de integratiegebruiker
• De URL van de JDBC-verbinding, zoals jdbc:mysql://host:33060/database?options
• Om verbinding te maken met een on-premise MySQL database, een GroundRunner voor de verbinding

Opmerking: Om verbinding te maken met een cloud-instantie van MySQL, gebruikt u de standaard CloudRunner.

De MySQL-connector instellen

Opmerking: Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een beveiligingsbeheerder van de org deze eerst inschakelen vanuit Configuratie.

1. Ga naar Chain Builder, klik op Connectionscompare_arrows, en vervolgens op Create rechtsboven.
2. Selecteer onder Connector Connection, MySQL en de runner die u met de verbinding wilt gebruiken.
   
3. Voer onder Basisinfo een unieke naam en beschrijving in om de verbinding te helpen identificeren.
4. Voer onder Eigenschappen de gegevens van de connector in:
   
   

   Eigendom	Details
   Gebruikersnaam	Voer de gebruikersnaam van de integratiegebruiker van de connector in.
   Wachtwoord	Voer het wachtwoord in voor de eigenschap Username.
   URL verbinding	Voer de URL voor de JDBC-verbinding in, zoals jdbc:mysql://<server>:<poort>/database. Om optionele eigenschappen voor de verbinding op te nemen, voegt u deze toe als een querystring, zoals jdbc:mysql://host:33060/database?<options>. Opmerking: Standaard is de poort 33060; dit kan echter voor uw omgeving anders zijn.

   Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met Advanced Encryption Standard (AES)-256 codering. Vermijd om veiligheidsredenen het opnemen van gebruikersreferenties als optionele eigenschappen binnen de eigenschap Connection URL.

5. Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan.
6. Om de verbinding te testen, maakt een ketting aan en voert deze uit met de opdracht Get Table Definition van de connector en controleert of deze een geldige uitvoer oplevert.

Probleemoplossing

Als de verbinding met de MySQL database mislukt:

• Controleer de verificatiegegevens van de integratiegebruiker.
• Controleer de URL voor de JDBC-verbinding, inclusief de server en poort.

Als de verbinding een opdracht niet kan uitvoeren, controleer dan of de invoer, zoals de SQL-syntaxis of tabel, geldig is.