Metadata-Version: 1.1
Name: ddlparse
Version: 1.2.2
Summary: DDL parase and Convert to BigQuery JSON schema
Home-page: http://github.com/shinichi-takii/ddlparse
Author: Shinichi Takii
Author-email: shinichi.takii@gmail.com
License: BSD-3-Clause
Description: DDL Parse
        =========
        
        .. image:: https://img.shields.io/pypi/v/ddlparse.svg
           :target: https://pypi.python.org/pypi/ddlparse
           :alt: PyPI version
        
        .. image:: https://img.shields.io/pypi/pyversions/ddlparse.svg
           :target: https://pypi.python.org/pypi/ddlparse
           :alt: Python version
        
        .. image:: https://travis-ci.org/shinichi-takii/ddlparse.svg?branch=master
           :target: https://travis-ci.org/shinichi-takii/ddlparse
           :alt: Travis CI Build Status
        
        .. image:: https://coveralls.io/repos/github/shinichi-takii/ddlparse/badge.svg?branch=master
           :target: https://coveralls.io/github/shinichi-takii/ddlparse?branch=master
           :alt: Coveralls Coverage Status
        
        .. image:: https://codecov.io/gh/shinichi-takii/ddlparse/branch/master/graph/badge.svg
           :target: https://codecov.io/gh/shinichi-takii/ddlparse
           :alt: codecov Coverage Status
        
        .. image:: https://requires.io/github/shinichi-takii/ddlparse/requirements.svg?branch=master
           :target: https://requires.io/github/shinichi-takii/ddlparse/requirements/?branch=master
           :alt: Requirements Status
        
        .. image:: https://img.shields.io/badge/License-BSD%203--Clause-blue.svg
           :target: https://github.com/shinichi-takii/ddlparse/blob/master/LICENSE.md
           :alt: License
        
        *DDL parase and Convert to BigQuery JSON schema and DDL statements
        module, available in Python.*
        
        --------------
        
        Features
        --------
        
        -  DDL parse and get table schema information.
        -  Currently, only the ``CREATE TABLE`` statement is supported.
        -  Convert to `BigQuery JSON
           schema <https://cloud.google.com/bigquery/docs/schemas#creating_a_json_schema_file>`__
           and `BigQuery DDL
           statements <https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language>`__.
        -  Supported databases are MySQL, PostgreSQL, Oracle, Redshift.
        
        Requirement
        -----------
        
        1. Python >= 3.4
        2. `pyparsing <http://pyparsing.wikispaces.com/>`__
        
        Installation
        ------------
        
        Install
        ~~~~~~~
        
        pip install:
        
        .. code:: bash
        
           $ pip install ddlparse
        
        command install:
        
        .. code:: bash
        
           $ python setup.py install
        
        Update
        ~~~~~~
        
        pip update:
        
        .. code:: bash
        
           $ pip install ddlparse --upgrade
        
        Usage
        -----
        
        Example
        ~~~~~~~
        
        .. code:: python
        
           from ddlparse.ddlparse import DdlParse
        
           sample_ddl = """
           CREATE TABLE My_Schema.Sample_Table (
             Id integer PRIMARY KEY,
             Name varchar(100) NOT NULL,
             Total bigint NOT NULL,
             Avg decimal(5,1) NOT NULL,
             Created_At date, -- Oracle 'DATE' -> BigQuery 'DATETIME'
             UNIQUE (NAME)
           );
           """
        
        
           # parse pattern (1-1)
           table = DdlParse().parse(sample_ddl)
        
           # parse pattern (1-2) : Specify source database
           table = DdlParse().parse(ddl=sample_ddl, source_database=DdlParse.DATABASE.oracle)
        
        
           # parse pattern (2-1)
           parser = DdlParse(sample_ddl)
           table = parser.parse()
        
           print("* BigQuery Fields * : normal")
           print(table.to_bigquery_fields())
        
        
           # parse pattern (2-2) : Specify source database
           parser = DdlParse(ddl=sample_ddl, source_database=DdlParse.DATABASE.oracle)
           table = parser.parse()
        
        
           # parse pattern (3-1)
           parser = DdlParse()
           parser.ddl = sample_ddl
           table = parser.parse()
        
           # parse pattern (3-2) : Specify source database
           parser = DdlParse()
           parser.source_database = DdlParse.DATABASE.oracle
           parser.ddl = sample_ddl
           table = parser.parse()
        
           print("* BigQuery Fields * : Oracle")
           print(table.to_bigquery_fields())
        
        
           print("* TABLE *")
           print("schema = {} : name = {} : is_temp = {}".format(table.schema, table.name, table.is_temp))
        
           print("* BigQuery Fields *")
           print(table.to_bigquery_fields())
        
           print("* BigQuery Fields - column name to lower case / upper case *")
           print(table.to_bigquery_fields(DdlParse.NAME_CASE.lower))
           print(table.to_bigquery_fields(DdlParse.NAME_CASE.upper))
        
           print("* COLUMN *")
           for col in table.columns.values():
               col_info = []
               col_info.append("name = {}".format(col.name))
               col_info.append("data_type = {}".format(col.data_type))
               col_info.append("length = {}".format(col.length))
               col_info.append("precision(=length) = {}".format(col.precision))
               col_info.append("scale = {}".format(col.scale))
               col_info.append("constraint = {}".format(col.constraint))
               col_info.append("not_null =  {}".format(col.not_null))
               col_info.append("PK =  {}".format(col.primary_key))
               col_info.append("unique =  {}".format(col.unique))
               col_info.append("bq_legacy_data_type =  {}".format(col.bigquery_legacy_data_type))
               col_info.append("bq_standard_data_type =  {}".format(col.bigquery_standard_data_type))
               col_info.append("BQ {}".format(col.to_bigquery_field()))
               print(" : ".join(col_info))
        
           print("* DDL (CREATE TABLE) statements *")
           print(table.to_bigquery_ddl())
        
           print("* DDL (CREATE TABLE) statements - dataset name, table name and column name to lower case / upper case *")
           print(table.to_bigquery_ddl(DdlParse.NAME_CASE.lower))
           print(table.to_bigquery_ddl(DdlParse.NAME_CASE.upper))
        
           print("* Get Column object (case insensitive) *")
           print(table.columns["total"])
        
        License
        -------
        
        `BSD 3-Clause
        License <https://github.com/shinichi-takii/ddlparse/blob/master/LICENSE.md>`__
        
        Author
        ------
        
        Shinichi Takii shinichi.takii@gmail.com
        
        Links
        -----
        
        -  Repository : https://github.com/shinichi-takii/ddlparse
        -  PyPI Package : https://pypi.python.org/pypi/ddlparse
        
        Special Thanks
        --------------
        
        -  pyparsing : http://pyparsing.wikispaces.com/
        
Keywords: ddl sql parse bigquery
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries :: Python Modules
