Package: nzalchemy
A Netezza Dialect(nzalchemy) for SQLAlchemyScopenzalchemy runs on top of pyodbc(over nzodbc) or nzpy as a dialect to bridge Netezza Performance Server and SQLAlchemy applications.Prerequisites for using nzalchemy with pyodbcInstall pyodbc Python packageDetails of pyodbc pre-requisites and installation instruction can be found here:https://github.com/mkleehammer/pyodbc/wiki/InstallInstall Netezza OBDC(nzodbc) driversYou will not be able to use pyodbc driver without installing Netezza OBDC drivers. This step is one of the pre-requisites to use pyodbc.Install and configure Netezza ODBC on LinuxIBM has provided Netezza ODBC driver that you can install into any Linux box. Go to IBM support center and download required version of ODBC driver.Get latest nzodbc 64bit driver linux64cli.package.tar from (https://www.ibm.com/support/fixcentral/swg/selectFixes?product=ibm/WebSphere/IBM+Cloud+Private+for+Data+System&release=IPS_11.1&platform=All&function=fixId&fixids=11.1.0.0-WS-ICPDS-IPS-fp125793)untar and unpack using below command :$ tar -xvf ips-linuxclient-v<version>.tar.gz
	$ ./unpack npsclient.<version>.tar.gzUnpacking would create a lib64 directory under which there would be libnzodbc.so.
Add above directory to LD_LIBRARY_PATH.For further details read here:https://www.ibm.com/support/knowledgecenter/SSULQD_7.2.1/com.ibm.nz.datacon.doc/c_datacon_configuring_odbc_unix_linux.htmlInstall and configure Netezza ODBC on WindowsYou can download the Netezza odbc drivers from IBM website and install it on required system.Get latest nzodbc driver nzodbcsetup.exe from (https://www.ibm.com/support/fixcentral/swg/selectFixes?product=ibm/WebSphere/IBM+Cloud+Private+for+Data+System&release=IPS_11.1&platform=All&function=fixId&fixids=11.1.0.0-WS-ICPDS-IPS-fp125793)The installation program installs the Netezza ODBC libraries on your system, creates a Netezza SQL system data source entry (NZSQL) with appropriate default values, and adds the appropriate entries to the Windows registry.In the ODBC Data Source Administrator window, click either the System DSN tab or the User DSN tab.Select either of the following options:To configure an existing DSN, click Configure. Clicking Configure displays the ODBC Driver Setup window.To configure a new DSN, click Add. Clicking Add displays the Create New Data Source window. Select NetezzaSQL as the driver and click Finish.In the ODBC Driver Setup window, configure the DSN and driver options. See ODBC Driver Setup window.Attempt to establish a connection to the data source on your Netezza appliance server by clicking the DSN Options tab and then clicking Test Connection.For further details read here:https://www.ibm.com/support/knowledgecenter/SSULQD_7.2.1/com.ibm.nz.datacon.doc/c_datacon_installing_configuring_odbc_win.htmlPrerequisites for using nzalchemy with nzpyInstall nzpy packageTo install nzpy using pip type:pipinstallnzpyTo install nzpy using setup.py:pythonsetup.pyinstallInstalling Netezza SQLAlchemyThe Netezza SQLAlchemy package can be installed from the public PyPI repository using pip:pip install nzalchemyConnection ParametersTo connect to Netezza with SQLAlchemy using pyodbc use the following connection string:netezza+pyodbc:///?<ODBC connection parameters>For example:import urllib 
params= urllib.parse.quote_plus("DRIVER=<path-to-libnzodbc.so>;SERVER=<nz-running-server>;PORT=5480;DATABASE=<dbname>;UID=<usr>;PWD=<password>")

engine = create_engine("netezza+pyodbc:///?odbc_connect=%s" % params,  echo=True)To connect to Netezza with SQLAlchemy using nzpy use the following connection string:netezza+nzpy://username:password@hostname:port/databasenameFor example:engine = create_engine("netezza+nzpy://admin:password@localhost:5480/db1")In order to pass any nzpy connection arguments to nzalchemy use below:import nzpy

def creator():
    return nzpy.connect(user="admin", password="password",host='localhost', port=5480, database="db1", securityLevel=0,logOptions=nzpy.LogOptions.Logfile, char_varchar_encoding='utf8')

engine = create_engine("netezza+nzpy://", creator=creator)Feature SupportSQLAlchemy ORM - Python object based automatically constructed SQLSQLAlchemy Core - schema-centric SQL Expression LanguageAuto-increment BehaviorAuto-incrementing a value requires the Sequence object. Include the Sequence object in the primary key column to automatically increment the value as each new record is inserted.
For example:t = Table('mytable', metadata,
    Column('id', Integer, Sequence('id_seq'), primary_key=True),
    Column(...), ...Known LimitationsINTERVAL data type Reading interval data at sqlalchemy will fail as pyodbc doesn’t support interval data type directly.There will not be any issue for writing data.Unicode varchar will failTIME data type with time zone TIME WITH TIME ZONE data type might not work. TIMETZ which is separate data type (internally it will be time with time zone) that works fine.If you have any questions or issues you can create a newissue here.Pull requests are very welcome! Make sure your patches are well tested.
Ideally create a topic branch for every separate change you make. For
example:Fork the repoCreate your feature branch (git checkout -b my-new-feature)Commit your changes (git commit -am 'Added some feature')Push to the branch (git push origin my-new-feature)Create new Pull RequestLicense & AuthorsIf you would like to see the detailed LICENSE clickhere.Copyright:: 2019-2020 IBM, Inc

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.Quick Example#!/usr/bin/env python3
from sqlalchemy import create_engine, MetaData, Table, Column, select
import nzalchemy as nz
import urllib 
params= urllib.parse.quote_plus("DRIVER=<path-to-libnzodbc.so>;SERVER=<nz-running-server>;PORT=5480;DATABASE=<dbname>;UID=<usr>;PWD=<password>")
engine = create_engine("netezza+pyodbc:///?odbc_connect=%s" % params,  echo=True)
#create engine using nzpy
#engine = create_engine("netezza+nzpy://<username>:<password>@<nz-running-server>:5480/<dbname>")
meta = MetaData()
test = Table(
'TEST', meta,
Column('id', nz.INTEGER),
Column('name', nz.VARCHAR(20) ),
Column('gender', nz.CHAR),
)
meta.create_all(engine)
#conn for insert and select
conn = engine.connect()
#Insert 
conn.execute(test.insert(),[
			{'id':2,'name':'xyz','gender':'F'},
			{'id':3,'name':'abc','gender':'M'},
			]
		)

#Select
print ("After Insert")
s = select([test])
result = conn.execute(s)
for row in result:
	print (row)
#Update
updt = test.update().where(test.c.id == '2').values(name='updated_name')
conn.execute(updt)
s = select([test])
result = conn.execute(s)
for row in result:
	print (row)

#Delete Row/s
delt = test.delete().where(test.c.name == 'abc')
conn.execute(delt)
s = select([test])
result = conn.execute(s)
for row in result:
	print (row)