User-friendly Teradata client for Python
Due to changes in the priorities, this project is currently not being supported. The project is archived as of 11/17/21 and will be available in a read-only state. Please note, since archival, the project is not maintained or reviewed. ########
.. image:: https://img.shields.io/pypi/v/giraffez.svg :target: https://pypi.python.org/pypi/giraffez :alt: PyPi .. image:: https://img.shields.io/badge/license-Apache%202-blue.svg :target: https://www.apache.org/licenses/LICENSE-2.0 :alt: License
|
.. image:: https://raw.githubusercontent.com/capitalone/giraffez/master/docs/logo.png
Giraffez is a client library for Teradata <http://www.teradata.com/>
_, made to be fast and user-friendly. It shares many features with the official Teradata tools, but makes them available in an easy-to-use command-line interface and Python API.
Features ########
Command-line tool <https://capitalone.github.io/giraffez/command-line.html>
_Python API <https://capitalone.github.io/giraffez/api.html#giraffez-modules>
_ - expressive, powerful, and great for working with other packages <https://capitalone.github.io/giraffez/api.html#working-with-other-packages>
_ (e.g. pandas <http://pandas.pydata.org>
_)Execute <https://capitalone.github.io/giraffez/command-line.html#cmd>
_ SQL statements using the Teradata CLIv2 library -- performing ad hoc queries and commandsInsert <https://capitalone.github.io/giraffez/command-line.html#insert>
_ into existing Teradata tables using the CLIv2 driversArchive <https://capitalone.github.io/giraffez/command-line.html#archiving>
_ Teradata tables to save space. These can easily be transformed to flatfiles <https://capitalone.github.io/giraffez/command-line.html#fmt>
_ or loaded <https://capitalone.github.io/giraffez/command-line.html#load>
_ back into TeradataBulkExport <https://capitalone.github.io/giraffez/command-line.html#export>
_ from Teradata to a flatfile or archival format, retaining data type informationBulkLoad <https://capitalone.github.io/giraffez/command-line.html#load>
_ into existing Teradata tables using the Teradata PT Update (MLOAD)Config <https://capitalone.github.io/giraffez/command-line.html#config>
_ - manage connection information and credentials securely using the giraffez config
and giraffez secret
commandsInteractive shell <https://capitalone.github.io/giraffez/command-line.html#shell>
_ for executing Teradata queries -- much like BTEQ, but with a friendly interfaceRun <https://capitalone.github.io/giraffez/command-line.html#run>
_ job files in YAML formatLinks
Documentation <https://capitalone.github.io/giraffez>
_Quick Install #############
::
$ pip install giraffez
See the setup instructions <https://capitalone.github.io/giraffez/intro.html#giraffez-setup>
_ for requirements and details on how to configure your environment.
Contributors ############
We welcome Your interest in Capital One’s Open Source Projects (the "Project"). Any Contributor to the Project must accept and sign an Agreement indicating agreement to the license terms below. Except for the license granted in this Agreement to Capital One and to recipients of software distributed by Capital One, You reserve all right, title, and interest in and to Your Contributions; this Agreement does not impact Your rights to use Your own Contributions for any other purpose
Sign the Agreement <https://docs.google.com/forms/d/e/1FAIpQLSfwtl1s6KmpLhCY6CjiY8nFZshDwf_wrmNYx1ahpsNFXXmHKw/viewform>
_
Code of Conduct ###############
This project adheres to the Open Code of Conduct <https://developer.capitalone.com/single/code-of-conduct/>
_ By participating, you are
expected to honor this code.
Teradata is a registered trademark of Teradata Corporation