OdbcDatabaseMySqlOpen

value OdbcDatabaseMySqlOpen ( value BYREF dxDatabase, string strDatabase, value bCreateIfNotExists = TRUE, string strUser = "", string strPassword = "", string strServer = "localhost", value Port = 3306, string strMySqlOdbcDriver = "" );

Rückgabewert

Rückgabewert	Beschreibung
ODBC_success	Die Datenbank wurde erfolgreich geöffnet bzw. erfolgreich angelegt und geöffnet.
ODBC_error	Beim Öffnen bzw. Anlegen der Datenbank ist ein Fehler aufgetreten. Dieser kann mit OdbcGetLastError ausgelesen werden.
ODBC_MySqlOdbcDriverNotAvailable	Es wurde kein geeigneter MySQL/MariaDB ODBC-Treiber gefunden. Lösung: Es muss ein geeigneter MySQL/MariaDB ODBC-Treiber installiert werden bzw. beim Aufruf der Funktion über strMySqlOdbcDriver vorgegeben werden.

Parameter

dxDatabase

Wurde die Datenquelle erfolgreich geöffnet, so wird dxDatabase mit einem Verweis auf die geöffnete Datenquelle geladen. Nachfolgenden OdbcDatabase-Funktionsaufrufen, die sich auf diese Datenquelle beziehen, muss dieses Datenbankobjekt übergeben werden.

strDatabase

Der Name der Datenbank, die geöffnet bzw. angelegt und geöffnet werden soll.

bCreateIfNotExists

Gibt an, ob die Datenbank mit dem Namen strDatabase automatisch angelegt werden soll, wenn diese nicht existiert.

strUser

Der Benutzername der verwendet werden soll, um die Datenbank strDatabase zu öffnen bzw. anzulegen und zu öffnen. Der verwendete Benutzername muss innerhalb des MySQL/MariaDB Datenbankservers gültig sein und die entsprechenden Rechte besitzen diese Datenbank zu öffnen bzw. eine Datenbank anzulegen.

strPassword

Das Kennwort des Benutzers strUser, der verwendet werden soll, um die Datenbank strDatabase zu öffnen bzw. anzulegen und zu öffnen.

strServer

Der Name oder die IP-Adresse des Rechners, auf dem der MySQL/MariaDB Datenbankserver läuft, in dem die Datenbank strDatabase geöffnet bzw. angelegt und geöffnet werden soll.

Port

Der Socket-Port, den der MySQL/MariaDB Datenbankserver verwendet, in dem die Datenbank strDatabase geöffnet bzw. angelegt und geöffnet werden soll.

strMySqlOdbcDriver

Der Name des MySQL/MariaDB ODBC-Treibers, der für den Zugriff auf den MySQL/MariaDB Datenbankserver verwendet werden soll.
Ist kein Name bzw. ein Leerstring angegeben, so ermittelt die Funktion einen geeigneten Treiber aus der Liste der installierten ODBC-Treiber (Systemsteuerung->Verwaltung->Datenquellen (ODBC)->Treiber). Hierzu wird versucht einen MariaDB ODBC-Treiber zu finden. Schlägt die Suche fehl, wird nach einem MySQL ODBC-Treiber gesucht. Schlägt auch diese Suche fehl, liefert die Funktion den Fehler ODBC_MySqlOdbcDriverNotAvailable zurück.

Bemerkung

Stellt eine Verbindung zu der Datenbank strDatabase des MySQL/MariaDB Datenbankservers strServer her. Existiert die Datenbank nicht, wird versucht diese anzulegen wenn bCreateIfNotExists TRUE ist. Der verwendete Benutzer strUser/strPassword muss im Datenbankserver das Recht besitzen diese Datenbank zu öffnen bzw. das Recht besitzen eine Datenbank zu erstellen.

Muss die Datenbank von einem Benutzer angelegt werden, der höhere Rechte benötigt, so kann hierzu die Funktion OdbcDatabaseMySqlCreate verwendet werden, die nur dazu dient eine Datenbank anzulegen.

Allgemeine Erläuterungen zur Installation eines MySQL/MariaDB Datenbankservers siehe hier.

 

Wird die Datenquelle nicht mehr benötigt, so ist diese mit OdbcDatabaseClose zu schließen. Victory schließt alle offenen Datenbank automatisch, sobald die Anwendung gestoppt bzw. beendet wird.

Beispiel

//Öffnet die Datenbank 'Leitstand' im lokalen MySQL/MariaDB Datenbankserver
//Existiert die Datenbank nicht, wird sie angelegt und geöffnet.
OdbcDatabaseMySqlOpen(dxDatabase, "Leitstand", TRUE, "root", "RootKennwort");

Die ODBC Datenbankfunktionen

Siehe auch OdbcDatabaseActivateAnsiToUTF8, OdbcDatabaseClose, OdbcDatabaseExecute, OdbcDatabaseExport, OdbcDatabaseQuery, OdbcDatabaseIsOpen, OdbcDatabaseOpen, OdbcDatabaseOpenEx, OdbcGetLastError, OdbcDatabaseMySqlCreate