Skip to main content

schemainspect: SQL Schema Inspection

Schema inspection for PostgreSQL (and potentially others in the future).

Inspects tables, views, materialized views, constraints, indexes, sequences, enums, functions, and extensions. Handles table partitioning and inheritance.

Limitations: Function inspection only confirmed to work with SQL/PLPGSQL languages so far.

Basic Usage

Get an inspection object from an already opened SQLAlchemy session or connection as follows:

from schemainspect import get_inspector
from sqlbag import S

with S('postgresql:///example') as s:
    i = get_inspector(s)

The inspection object has attributes for tables, views, and all the other things it tracks. At each of these attributes you'll find a dictionary (OrderedDict) mapping from fully-qualified-and-quoted-name-of-thing-in-database to information object.

For instance, the information about a table books would be accessed as follows:

>>> books_table = i.tables['"public"."books"']
>>> books_table.name
'books'
>>> books_table.schema
'public'
>>> [each.name for each in books_table.columns]
['id', 'title', 'isbn']

Documentation

Documentation is a bit patchy at the moment. Watch this space!

Author Credits

Initial development, maintenance:

Contributions:

Install

Install with pip:

$ pip install schemainspect

To install psycopg2 (the PostgreSQL driver) at the same time as well:

$ pip install schemainspect[pg]

Metadata

Release files for schemainspect 0.1.1599449889

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for schemainspect 0.1.1599449889
File Size Uploaded
schemainspect-0.1.1599449889.tar.gz 25.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for schemainspect 0.1.1599449889
File Interpreter ABI Platform
schemainspect-0.1.1599449889-py2.py3-none-any.whl Python 3, Python 2 none any Details

Total release size: 59.2 kB

Release files / schemainspect-0.1.1599449889.tar.gz

Download URL schemainspect-0.1.1599449889.tar.gz
Size 25.3 kB
Tags Source
SHA-256 checksum
How to use checksums
94bc3b22470f9bd3f3f3a320e507765bb483fd16180d53bf42c35c5adcda4b61
BLAKE2b-256 checksum
How to use checksums
97a2cb35624279bd4a4e65a0695b0b40f29594000b49c91c8ebfed135d704153
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.0.5 CPython/3.8.2 Linux/4.15.0-1077-aws

Release files / schemainspect-0.1.1599449889-py2.py3-none-any.whl

Download URL schemainspect-0.1.1599449889-py2.py3-none-any.whl
Size 33.9 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
1139a839e29f694e52d5e66b63f4a5374e9256aba5ea9d132e6c9ef1c3f3f8a5
BLAKE2b-256 checksum
How to use checksums
619dbff0ca9a205bf37cdc176816b9c3a0d20d1c56fdbfef078cbec2f81d01b7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.0.5 CPython/3.8.2 Linux/4.15.0-1077-aws

Release history Release notifications | RSS feed

This release

0.1.1599449889 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page