Seit der MySQL-Version 5 kennt der MySQL Server nun auch gespeicherte Prozeduren mit der Syntax von SQL 2003.

Eine gespeicherte Prozedur besteht in einer Reihe von SQL-Anweisungen, die im Server gespeichert werden können. fortan müssen die Clients keine individuellen Anweisungen mehr geben, sondern können stattdessen auf die gespeicherte Prozedur verweisen.

Gespeicherte Prozeduren können vor allem in folgenden Situationen nützlich sein:

Connector/NET unterstützt den Aufruf von gespeicherten Prozeduren mit dem MySqlCommand-Objekt. Zur Übergabe von Daten in die und aus der gespeicherten Prozedur von MySQL dient die MySqlCommand.Parameters-Collection.

Hinweis:  Wenn Sie eine gespeicherte Prozedur aufrufen, setzt das Befehlsobjekt einen zusätzlichen SELECT-Aufruf ab, um die Parameter der gespeicherten Prozedur zu ermitteln. Sie müssen sicherstellen, dass der Benutzer, der die Prozedur aufruft, die SELECT-Berechtigung für die mysql.proc-Tabelle besitzt, um die Parameter überprüfen zu können. Sonst wird beim Aufruf der Prozedur ein Fehler ausgelöst.

Eine tiefer gehende Erörterung zu gespeicherten Prozeduren finden Sie in http://dev.mysql.com/doc/mysql/en/stored-procedures.html, aber nicht im vorliegenden Abschnitt.

Eine Beispielanwendung zur Verwendung von gespeicherten Prozeduren mit Connector/NET finden Sie im Samples-Verzeichnis Ihrer Connector/NET-Installation.

In MySQL gibt es mehrere Möglichkeiten, gespeicherte Prozeduren anzulegen. Erstens können gespeicherte Prozeduren mit dem Kommandozeilen-Client mysql erzeugt werden, zweitens mit dem GUI-Client MySQL Query Browser und drittens mit der .ExecuteNonQuery-Methode des MySqlCommand-Objekts:

Visual Basic-Beispiel

Dim conn As New MySqlConnection
Dim cmd As New MySqlCommand

conn.ConnectionString = "server=127.0.0.1;" _
    & "uid=root;" _
    & "pwd=12345;" _
    & "database=test"

Try
    conn.Open()
    cmd.Connection = conn

    cmd.CommandText = "CREATE PROCEDURE add_emp(" _
        & "IN fname VARCHAR(20), IN lname VARCHAR(20), IN bday DATETIME, OUT empno INT) " _
        & "BEGIN INSERT INTO emp(first_name, last_name, birthdate) " _
        & "VALUES(fname, lname, DATE(bday)); SET empno = LAST_INSERT_ID(); END"
 
    cmd.ExecuteNonQuery()
Catch ex As MySqlException
    MessageBox.Show("Error " & ex.Number & " has occurred: " & ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Error)
End Try

C#-Beispiel

MySql.Data.MySqlClient.MySqlConnection conn;
MySql.Data.MySqlClient.MySqlCommand cmd;

conn = new MySql.Data.MySqlClient.MySqlConnection();
cmd = new MySql.Data.MySqlClient.MySqlCommand();

conn.ConnectionString = "server=127.0.0.1;uid=root;" +
    "pwd=12345;database=test;";

try
{
    conn.Open();
    cmd.Connection = conn;

    cmd.CommandText = "CREATE PROCEDURE add_emp(" +
        "IN fname VARCHAR(20), IN lname VARCHAR(20), IN bday DATETIME, OUT empno INT) " +
        "BEGIN INSERT INTO emp(first_name, last_name, birthdate) " +
        "VALUES(fname, lname, DATE(bday)); SET empno = LAST_INSERT_ID(); END";

    cmd.ExecuteNonQuery();
}
catch (MySql.Data.MySqlClient.MySqlException ex)
{
MessageBox.Show("Error " + ex.Number + " has occurred: " + ex.Message,
    "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
}

Wenn Sie gespeicherte Prozeduren in Connector/NET anlegen, sind Sie, anders als beim Kommandozeilen- oder GUI-Client, nicht auf ein bestimmtes Trennzeichen festgelegt.

Um eine gespeicherte Prozedur mit Connector/NET aufzurufen, erzeugen Sie ein MySqlCommand-Objekt und übergeben den Namen der Prozedur als .CommandText-Eigenschaft. Setzen Sie die .CommandType-Eigenschaft auf CommandType.StoredProcedure.

Auf die Angabe der gespeicherten Prozedur folgt für jeden ihrer Parameter ein MySqlCommand-Parameter. IN-Parameter werden mit ihrem Namen und dem Objekt, das ihren Wert enthält, definiert, und OUT-Parameter mit ihrem Namen und dem erwarteten Rückgabe-Datentyp. Alle Parameter müssen mit Richtung definiert werden.

Sind die Parameter angelegt, so kann die gespeicherte Prozedur mit der Methode MySqlCommand.ExecuteNonQuery() aufgerufen werden:

Visual Basic-Beispiel

Dim conn As New MySqlConnection
Dim cmd As New MySqlCommand

conn.ConnectionString = "server=127.0.0.1;" _
    & "uid=root;" _
    & "pwd=12345;" _
    & "database=test"

Try
    conn.Open()
    cmd.Connection = conn

    cmd.CommandText = "add_emp"
    cmd.CommandType = CommandType.StoredProcedure

    cmd.Parameters.Add("?lname", 'Jones')
    cmd.Parameters["?lname"].Direction = ParameterDirection.Input

    cmd.Parameters.Add("?fname", 'Tom')
    cmd.Parameters["?fname"].Direction = ParameterDirection.Input

    cmd.Parameters.Add("?bday", #12/13/1977 2:17:36 PM#)
    cmd.Parameters["?bday"].Direction = ParameterDirection.Input

    cmd.Parameters.Add("?empno", MySqlDbType.Int32)
    cmd.Parameters["?empno"].Direction = ParameterDirection.Output

    cmd.ExecuteNonQuery()

    MessageBox.Show(cmd.Parameters["?empno"].Value)
Catch ex As MySqlException
    MessageBox.Show("Error " & ex.Number & " has occurred: " & ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Error)
End Try

C#-Beispiel

MySql.Data.MySqlClient.MySqlConnection conn;
MySql.Data.MySqlClient.MySqlCommand cmd;

conn = new MySql.Data.MySqlClient.MySqlConnection();
cmd = new MySql.Data.MySqlClient.MySqlCommand();

conn.ConnectionString = "server=127.0.0.1;uid=root;" +
    "pwd=12345;database=test;";

try
{
    conn.Open();
    cmd.Connection = conn;

    cmd.CommandText = "add_emp";
    cmd.CommandType = CommandType.StoredProcedure;

    cmd.Parameters.Add("?lname", "Jones");
    cmd.Parameters["?lname"].Direction = ParameterDirection.Input;

    cmd.Parameters.Add("?fname", "Tom");
    cmd.Parameters["?fname"].Direction = ParameterDirection.Input;

    cmd.Parameters.Add("?bday", DateTime.Parse("12/13/1977 2:17:36 PM"));
    cmd.Parameters["?bday"].Direction = ParameterDirection.Input;

    cmd.Parameters.Add("?empno", MySqlDbType.Int32);
    cmd.Parameters["?empno"].Direction = ParameterDirection.Output;

    cmd.ExecuteNonQuery();

    MessageBox.Show(cmd.Parameters["?empno"].Value);
}
catch (MySql.Data.MySqlClient.MySqlException ex)
{
    MessageBox.Show("Error " + ex.Number + " has occurred: " + ex.Message,
      "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
}

Sobald die gespeicherte Prozedur aufgerufen wird, können die Werte ihrer Ausgabeparameter mit der .Value-Eigenschaft der MySqlConnector.Parameters-Collection abgerufen werden.