The following code example shows how to bind parameters to create parameterized statements.

Single-Use Statements

The execute method accepts an additional sequence for binding query parameters to values.

cursor.execute("SELECT Email, Username FROM NorthwindOData WHERE Email = ?", ("[email protected]",))
for (Email, Username) in cursor:
    print("Email = {}, Username = {}".format(Email, Username))

Multi-Use Statements

The executemany method can be used to execute the same query repeatedly with different sets of parameters. Instead of a sequence of parameters, executemany accepts a nested sequence of parameters which are used for each execution.

executemany works only with INSERT, UPDATE and DELETE statements. It cannot be used with any operation that returns results, such as a SELECT or an EXECUTE.

params = [
  ("Ana Trujilo 1",),
  ("Ana Trujilo 2",),
  ("Ana Trujilo 3",),
]

cursor.executemany("INSERT INTO NorthwindOData (Username) VALUES (?)", params)