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 commands
Insert <https://capitalone.github.io/giraffez/command-line.html#insert>_ into existing Teradata tables using the CLIv2 drivers
Archive <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 Teradata
BulkExport <https://capitalone.github.io/giraffez/command-line.html#export>_ from Teradata to a flatfile or archival format, retaining data type information
BulkLoad <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 commands
Interactive shell <https://capitalone.github.io/giraffez/command-line.html#shell>_ for executing Teradata queries -- much like BTEQ, but with a friendly interface
Run <https://capitalone.github.io/giraffez/command-line.html#run>_ job files in YAML format

Links

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

Giraffez

Install / Use

README