Skip to main content

A Python library to dump table schema of a SQLite database file.

Project description

Summary

A Python library to dump table schema of a SQLite database file.

Installation

pip install sqliteschema

Usage

Full example can be found at examples/get_table_schema.py

Extract SQLite Schemas as dict

Sample Code:
import json
import sqliteschema

extractor = sqliteschema.SQLiteSchemaExtractor(sqlite_db_path)

print("--- dump all of the table schemas with a dictionary ---\n{}\n".format(
    json.dumps(extractor.fetch_database_schema_as_dict(), indent=4)))

print("--- dump a specific table schema with a dictionary ---\n{}\n".format(
    json.dumps(extractor.fetch_table_schema("sampletable1").as_dict(), indent=4)))
Output:
--- dump all of the table schemas with a dictionary ---
{
    "sampletable0": [
        {
            "Attribute": "attr_a",
            "Index": false,
            "Type": "INTEGER",
            "PRIMARY KEY": false,
            "NOT NULL": false,
            "UNIQUE": false
        },
        {
            "Attribute": "attr_b",
            "Index": false,
            "Type": "INTEGER",
            "PRIMARY KEY": false,
            "NOT NULL": false,
            "UNIQUE": false
        }
    ],
    "sampletable1": [
        {
            "Attribute": "foo",
            "Index": true,
            "Type": "INTEGER",
            "PRIMARY KEY": false,
            "NOT NULL": false,
            "UNIQUE": false
        },
        {
            "Attribute": "bar",
            "Index": false,
            "Type": "REAL",
            "PRIMARY KEY": false,
            "NOT NULL": false,
            "UNIQUE": false
        },
        {
            "Attribute": "hoge",
            "Index": true,
            "Type": "TEXT",
            "PRIMARY KEY": false,
            "NOT NULL": false,
            "UNIQUE": false
        }
    ],
    "constraints": [
        {
            "Attribute": "primarykey_id",
            "Index": false,
            "Type": "INTEGER",
            "PRIMARY KEY": true,
            "NOT NULL": false,
            "UNIQUE": false
        },
        {
            "Attribute": "notnull_value",
            "Index": false,
            "Type": "REAL",
            "PRIMARY KEY": false,
            "NOT NULL": true,
            "UNIQUE": false
        },
        {
            "Attribute": "unique_value",
            "Index": false,
            "Type": "INTEGER",
            "PRIMARY KEY": false,
            "NOT NULL": false,
            "UNIQUE": true
        }
    ]
}

--- dump a specific table schema with a dictionary ---
{
    "sampletable1": [
        {
            "Attribute": "foo",
            "Index": true,
            "Type": "INTEGER",
            "PRIMARY KEY": false,
            "NOT NULL": false,
            "UNIQUE": false
        },
        {
            "Attribute": "bar",
            "Index": false,
            "Type": "REAL",
            "PRIMARY KEY": false,
            "NOT NULL": false,
            "UNIQUE": false
        },
        {
            "Attribute": "hoge",
            "Index": true,
            "Type": "TEXT",
            "PRIMARY KEY": false,
            "NOT NULL": false,
            "UNIQUE": false
        }
    ]
}

Extract SQLite Schemas as Table

Sample Code:
import sqliteschema

extractor = sqliteschema.SQLiteSchemaExtractor(sqlite_db_path)

for verbosity_level in range(2):
    print("--- dump all of the table schemas with a tabular format: verbosity_level={} ---".format(
        verbosity_level))
    print(extractor.dumps(output_format="markdown", verbosity_level=verbosity_level))

for verbosity_level in range(2):
    print("--- dump a specific table schema with a tabular format: verbosity_level={} ---".format(
        verbosity_level))
    print(extractor.fetch_table_schema("sampletable1").dumps(
        output_format="markdown", verbosity_level=verbosity_level))
Output:
--- dump all of the table schemas with a tabular format: verbosity_level=0 ---
# sampletable0
|Attribute| Type  |
|---------|-------|
|attr_a   |INTEGER|
|attr_b   |INTEGER|


# sampletable1
|Attribute| Type  |
|---------|-------|
|foo      |INTEGER|
|bar      |REAL   |
|hoge     |TEXT   |


# constraints
|  Attribute  | Type  |
|-------------|-------|
|primarykey_id|INTEGER|
|notnull_value|REAL   |
|unique_value |INTEGER|


--- dump all of the table schemas with a tabular format: verbosity_level=1 ---
# sampletable0
|Attribute| Type  |PRIMARY KEY|NOT NULL|UNIQUE|Index|
|---------|-------|-----------|--------|------|-----|
|attr_a   |INTEGER|           |        |      |     |
|attr_b   |INTEGER|           |        |      |     |


# sampletable1
|Attribute| Type  |PRIMARY KEY|NOT NULL|UNIQUE|Index|
|---------|-------|-----------|--------|------|-----|
|foo      |INTEGER|           |        |      |X    |
|bar      |REAL   |           |        |      |     |
|hoge     |TEXT   |           |        |      |X    |


# constraints
|  Attribute  | Type  |PRIMARY KEY|NOT NULL|UNIQUE|Index|
|-------------|-------|-----------|--------|------|-----|
|primarykey_id|INTEGER|X          |        |      |     |
|notnull_value|REAL   |           |X       |      |     |
|unique_value |INTEGER|           |        |X     |     |


--- dump a specific table schema with a tabular format: verbosity_level=0 ---
# sampletable1
|Attribute| Type  |
|---------|-------|
|foo      |INTEGER|
|bar      |REAL   |
|hoge     |TEXT   |


--- dump a specific table schema with a tabular format: verbosity_level=1 ---
# sampletable1
|Attribute| Type  |PRIMARY KEY|NOT NULL|UNIQUE|Index|
|---------|-------|-----------|--------|------|-----|
|foo      |INTEGER|           |        |      |X    |
|bar      |REAL   |           |        |      |     |
|hoge     |TEXT   |           |        |      |X    |

Extract SQLite Schemas as Text

Sample Code:
import sqliteschema

extractor = sqliteschema.SQLiteSchemaExtractor(sqlite_db_path)

for verbosity_level in range(5):
    print("--- dump all of the table schemas with text format: verbosity_level={} ---".format(
        verbosity_level))
    print(extractor.dumps(output_format="text", verbosity_level=verbosity_level) + "\n")

for verbosity_level in range(5):
    print("--- dump specific table schema with text format: verbosity_level={} ---".format(
        verbosity_level))
    print(extractor.fetch_table_schema("sampletable1").dumps(
        output_format="text", verbosity_level=verbosity_level) + "\n")
Output:
--- dump all of the table schemas with text format: verbosity_level=0 ---
sampletable0
sampletable1
constraints

--- dump all of the table schemas with text format: verbosity_level=1 ---
sampletable0 (attr_a, attr_b)
sampletable1 (foo, bar, hoge)
constraints (primarykey_id, notnull_value, unique_value)

--- dump all of the table schemas with text format: verbosity_level=2 ---
sampletable0 (attr_a INTEGER, attr_b INTEGER)
sampletable1 (foo INTEGER, bar REAL, hoge TEXT)
constraints (primarykey_id INTEGER, notnull_value REAL, unique_value INTEGER)

--- dump all of the table schemas with text format: verbosity_level=3 ---
sampletable0 (attr_a INTEGER, attr_b INTEGER)
sampletable1 (foo INTEGER, bar REAL, hoge TEXT)
constraints (primarykey_id INTEGER PRIMARY KEY, notnull_value REAL NOT NULL, unique_value INTEGER UNIQUE)

--- dump all of the table schemas with text format: verbosity_level=4 ---
sampletable0 (
    attr_a INTEGER,
    attr_b INTEGER
)
sampletable1 (
    foo INTEGER,
    bar REAL,
    hoge TEXT
)
constraints (
    primarykey_id INTEGER PRIMARY KEY,
    notnull_value REAL NOT NULL,
    unique_value INTEGER UNIQUE
)

--- dump specific table schema with text format: verbosity_level=0 ---
sampletable1

--- dump specific table schema with text format: verbosity_level=1 ---
sampletable1 (foo, bar, hoge)

--- dump specific table schema with text format: verbosity_level=2 ---
sampletable1 (foo INTEGER, bar REAL, hoge TEXT)

--- dump specific table schema with text format: verbosity_level=3 ---
sampletable1 (foo INTEGER, bar REAL, hoge TEXT)

--- dump specific table schema with text format: verbosity_level=4 ---
sampletable1 (
    foo INTEGER,
    bar REAL,
    hoge TEXT
)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
sqliteschema-0.13.4-py2.py3-none-any.whl (10.9 kB) Copy SHA256 hash SHA256 Wheel py2.py3
sqliteschema-0.13.4.tar.gz (14.6 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page