feat: Use Fast Executemany Mode when using the PyODBC SQL Server dialect, closes wireservices/csvkit#1114

Author: jpmckinney

CHANGELOG.rst

@@ -1,6 +1,7 @@
 Unreleased
 ----------
 
+* feat: Use `Fast Executemany Mode <https://docs.sqlalchemy.org/en/20/dialects/mssql.html#fast-executemany-mode>`_ when using the PyODBC SQL Server dialect.
 * Add Python 3.12 support.
 * Drop support for Python 3.6 (2021-12-23), 3.7 (2023-06-27).
 

agatesql/table.py

@@ -5,6 +5,7 @@
 
 import datetime
 import decimal
+from urllib.parse import urlsplit
 
 import agate
 from sqlalchemy import Column, MetaData, Table, UniqueConstraint, create_engine, dialects
@@ -58,7 +59,11 @@ def get_engine_and_connection(connection_or_string=None):
         connection = connection_or_string
         return None, connection
 
-    engine = create_engine(connection_or_string)
+    kwargs = {}
+    if urlsplit(connection_or_string).scheme == 'mssql+pyodbc':
+        kwargs = {'fast_executemany': True}
+
+    engine = create_engine(connection_or_string, **kwargs)
     connection = engine.connect()
     return engine, connection