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 ShipName, ShipCity FROM Orders WHERE ShipCountry = ?", ("USA",))
for (ShipName, ShipCity) in cursor:
    print("ShipName = {}, ShipCity = {}".format(ShipName, ShipCity))

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 = [
  ("New York 1",),
  ("New York 2",),
  ("New York 3",),
]

cursor.executemany("INSERT INTO Orders (ShipCity) VALUES (?)", params)