Skip to content

sqlanywhere/sqlanydb

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

sqlanydb

This package provides a python interface to the SQL Anywhere database server. This interface conforms to PEP 249.

Requirements

Before installing the sqlanydb interface please make sure the following components are installed on your system.

  • Python 2.4 or greater (including Python 3.x)
  • Python ctypes module if missing
  • SQL Anywhere 10 or higher

Installing the sqlanydb module

Run the following command as an administrative user to install sqlanydb:

python setup.py install

Alternatively, you can use pip:

pip install sqlanydb

Converter Functions

This library wraps around the sqlanydb dbcapi C library. When retrieving values from the database, the C API returns one of these types:

  • A_INVALID_TYPE
  • A_BINARY
  • A_STRING
  • A_DOUBLE
  • A_VAL64
  • A_UVAL64
  • A_VAL32
  • A_UVAL32
  • A_VAL16
  • A_UVAL16
  • A_VAL8
  • A_UVAL8

Other types are returned as the above types. For example, the NUMERIC type is returned as a string.

To have sqlanydb return a different or custom python object, you can register callbacks with the sqlanydb module, using register_converter(datatype, callback). Callback is a function that takes one argument, the type to be converted, and should return the converted value. Datatype is one of the DT_ variables present in the module.

The types available to register a converter for:

  • DT_NOTYPE
  • DT_DATE
  • DT_TIME
  • DT_TIMESTAMP
  • DT_DATETIMEX
  • DT_VARCHAR
  • DT_FIXCHAR
  • DT_LONGVARCHAR
  • DT_STRING
  • DT_DOUBLE
  • DT_FLOAT
  • DT_DECIMAL
  • DT_INT
  • DT_SMALLINT
  • DT_BINARY
  • DT_LONGBINARY
  • DT_TINYINT
  • DT_BIGINT
  • DT_UNSINT
  • DT_UNSSMALLINT
  • DT_UNSBIGINT
  • DT_BIT
  • DT_LONGNVARCHAR

For example, to have NUMERIC types be returned as a python Decimal object:

import decimal

def decimal_callback(valueToConvert):
    return decimal.Decimal(valueToConvert)

sqlanydb.register_converter(sqlanydb.DT_DECIMAL, decimal_callback)

Testing the sqlanydb module

To test that the Python interface to SQL Anywhere is working correctly first start the demo database included with your SQL Anywhere installation and then create a file named test_sqlany.py with the following contents:

import sqlanydb
conn = sqlanydb.connect(uid='dba', pwd='sql', eng='demo', dbn='demo' )
curs = conn.cursor()
curs.execute("select 'Hello, world!'")
print( "SQL Anywhere says: %s" % curs.fetchone() )
curs.close()
conn.close()

Run the test script and ensure that you get the expected output:

> python test_sqlany.py
SQL Anywhere says: Hello, world!

License

This package is licensed under the terms of the Apache License, Version 2.0. See the LICENSE file for details.

Feedback and Questions

For feedback on this project, or for general questions about using SQL Anywhere please use the SQL Anywhere Forum at http://sqlanywhere-forum.sap.com/

About

Python driver for SAP Sybase SQL Anywhere

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages