Skip to content

Latest commit

 

History

History
147 lines (104 loc) · 4.38 KB

README.md

File metadata and controls

147 lines (104 loc) · 4.38 KB

Join the chat at https://gitter.im/OmniDB/Lobby

OmniDB 2.0.4

OmniDB was completely rewritten to Python using the Django framework. Starting from version 2.0, OmniDB Python version will receive new features and will be actively maintained.

The source code for the ASP.NET/C# version is in the branch csharp. The next release of OmniDB C# version is 1.7, and it will only receive bug fixes.

Besides being written in Python, initial version of OmniDB 2.0 contains the following main differences from the C# version:

  • Support to HTTPS;
  • It allows query execution in background and cancellation through the use of websockets;
  • Initially, only an improved support of PostgreSQL is implemented. More RDBMS support coming soon;
  • There is a new Snippet feature.

1- Installation

1.1- Installation packages

Just go to omnidb.org, download the appropriate file for your operating system and architecture and install it.

1.2- From source

1.2.1- On Debian >= 9 with pip

sudo apt install python3-pip
pip3 install pip --upgrade
pip3 install -r requirements.txt

1.2.2- On Debian/Ubuntu using PyEnv

sudo apt install git make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev xz-utils

git clone https://github.com/pyenv/pyenv.git ~/.pyenv
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc
source ~/.bashrc

pyenv install 3.5.2
pyenv local 3.5.2

pip install pip --upgrade
pip install -r requirements.txt

1.3- Running OmniDB

Download or clone OmniDB repo and extract it somewhere. To start Django server, enter into OmniDB/OmniDB folder and type:

python3 manage.py runserver

2- Introduction

OmniDB is a web tool that simplifies database management focusing on interactivity, designed to be powerful and lightweight. Check-out some characteristics:

  • Web Tool: Accessible from any platform, using a browser as a medium
  • Responsive Interface: All available functions in a single page
  • Unified Workspace: Different technologies managed in a single workspace
  • Simplified Editing: Easy to add and remove connections
  • Safety: Multi-user support with encrypted personal information
  • Interactive Tables: All functionalities use interactive tables, allowing copying and pasting in blocks
  • Smart SQL Editor: Contextual SQL code completion
  • Beautiful SQL Editor: You can choose between many available color themes
  • Tabbed SQL Editor: Easily add, rename or delete editor tabs

Technologies:

  • Python (3.5+)
  • Django

Supported Platforms:

  • Linux
  • Windows
  • OS X

Supported DBMS:

  • PostgreSQL
  • MySQL
  • Oracle
  • Firebird
  • SQLite
  • Microsoft SQL Server
  • IBM DB2

3- Database Schema Management

OmniDB is designed for easy database management. Here are some features:

  • Tree view showing database structure
    • Included structures:
      • Columns and Tables
      • Key Constraints: primary, foreign and unique
      • Index (unique and non-unique)

  • Powerful table creation
    • Editing capabilities:
      • Tables' names
      • Columns: name, type and nullable
      • Primary keys and respective columns
      • Foreign keys with either table and reference columns, including updating rules and removal as well
      • Indexes

  • Table editing: Edit table structure according to DBMS limitations
  • Data management: Add, edit and remove records

  • SQL Editing
    • Customizable Features:
      • Syntax highlighting for SQL
      • SQL code completion for table columns and subquery
      • Multiple themes to be selected

  • Other features:
    • Querying organized in tables
    • DDL commands execution
    • Multiple sequenced command execution (scripts)
    • Graphs displaying tables and their relations

  • Graphs displaying complete ER diagram