Schema
What is Schema?
Have you ever wondered how to work with your fellows in one database without interfering with each other? Is it possible to organize the database objects into logical groups which do not collide with the other objects’ names?
We can do those things with Schema.
A schema is a collection of tables. A schema also contains views, indexes, sequences, data types, operators, and functions. We support multiple schemas. For example, you can have a database named oxla
and have multiple schemas based on your needs, like auth
, model
, business
, etc.
Default Schema in Oxla
By default, the public
schema is used in Oxla.
When unqualified table_name
is used, that table_name
is equivalent to public.table_name
. It also applies to CREATE
, DROP
, and SELECT TABLE
statements.
Schema Usage Scenarios
#1 - Create a Schema
The basic syntax of creating a schema is as follows:
CREATE SCHEMA schema_name;
schema_name
is the name of the schema you are going to create.
#2 - Create a Table in Schema
The syntax to create a table in a specified schema is as follows:
CREATE TABLE schema_name.table_name(
...
);
-
schema_name
is the schema that you have created. -
table_name
is the table name you are going to create.
#3 - Select a Table in Schema
After creating the table and inserting some data, display all rows with the syntax below:
SELECT * FROM schema_name.table_name;
-
schema_name
is the name of the schema. -
table_name
is the name of the table you want to display.
#4 - Drop the Schema
To drop an empty schema where no objects remain in it, use the command below:
DROP SCHEMA schema_name;
Tables reside in a schema, so it is impossible to drop a schema without also dropping the tables. With the command below, you will also drop the schema with the tables.
DROP SCHEMA schema_name CASCADE;
Example #1
- First, connect to Oxla and create a schema as shown below:
CREATE SCHEMA oxlarefs;
- Next, create a table in the above schema with the following details:
CREATE TABLE oxlarefs.functions(
id int,
function_name string,
active bool
);
INSERT INTO oxlarefs.functions(id, function_name, active)
VALUES
('1111', 'Numeric', 'TRUE'),
('2222', 'String', 'TRUE'),
('3333', 'Timestamp', 'TRUE'),
('4444', 'JSON', 'TRUE'),
('5555', 'Boolean', 'TRUE');
- You can verify and show the table made with the command below:
SELECT * FROM oxlarefs.functions;
- You will get the following result:
+------+---------------+---------+
| id | function_name | active |
+------+---------------+---------+
| 1111 | Numeric | t |
| 2222 | String | t |
| 3333 | Timestamp | t |
| 4444 | JSON | t |
| 5555 | Boolean | t |
+------+---------------+---------+
Example #2
From Example #1, we created a new schema and a table. Use the command below to delete the schema and also the tables in it:
DROP SCHEMA oxlarefs CASCADE;
Another case is if there is no table or object created inside the schema, you can use the following command to drop the schema:
DROP SCHEMA oxlarefs;