|
|
@@ -15,9 +15,29 @@ repo](https://github.com/docker-library/official-images).
|
|
|
|
|
|
# What is PostgreSQL?
|
|
|
|
|
|
-PostgreSQL, often simply "Postgres", is an object-relational database management system (ORDBMS) with an emphasis on extensibility and standards-compliance. As a database server, its primary function is to store data, securely and supporting best practices, and retrieve it later, as requested by other software applications, be it those on the same computer or those running on another computer across a network (including the Internet). It can handle workloads ranging from small single-machine applications to large Internet-facing applications with many concurrent users. Recent versions also provide replication of the database itself for security and scalability.
|
|
|
-
|
|
|
-PostgreSQL implements the majority of the SQL:2011 standard, is ACID-compliant and transactional (including most DDL statements) avoiding locking issues using multiversion concurrency control (MVCC), provides immunity to dirty reads and full serializability; handles complex SQL queries using many indexing methods that are not available in other databases; has updateable views and materialized views, triggers, foreign keys; supports functions and stored procedures, and other expandability, and has a large number of extensions written by third parties. In addition to the possibility of working with the major proprietary and open source databases, PostgreSQL supports migration from them, by its extensive standard SQL support and available migration tools. And if proprietary extensions had been used, by its extensibility that can emulate many through some built-in and third-party open source compatibility extensions, such as for Oracle.
|
|
|
+PostgreSQL, often simply "Postgres", is an object-relational database management
|
|
|
+system (ORDBMS) with an emphasis on extensibility and standards-compliance. As a
|
|
|
+database server, its primary function is to store data, securely and supporting
|
|
|
+best practices, and retrieve it later, as requested by other software
|
|
|
+applications, be it those on the same computer or those running on another
|
|
|
+computer across a network (including the Internet). It can handle workloads
|
|
|
+ranging from small single-machine applications to large Internet-facing
|
|
|
+applications with many concurrent users. Recent versions also provide
|
|
|
+replication of the database itself for security and scalability.
|
|
|
+
|
|
|
+PostgreSQL implements the majority of the SQL:2011 standard, is ACID-compliant
|
|
|
+and transactional (including most DDL statements) avoiding locking issues using
|
|
|
+multiversion concurrency control (MVCC), provides immunity to dirty reads and
|
|
|
+full serializability; handles complex SQL queries using many indexing methods
|
|
|
+that are not available in other databases; has updateable views and materialized
|
|
|
+views, triggers, foreign keys; supports functions and stored procedures, and
|
|
|
+other expandability, and has a large number of extensions written by third
|
|
|
+parties. In addition to the possibility of working with the major proprietary
|
|
|
+and open source databases, PostgreSQL supports migration from them, by its
|
|
|
+extensive standard SQL support and available migration tools. And if proprietary
|
|
|
+extensions had been used, by its extensibility that can emulate many through
|
|
|
+some built-in and third-party open source compatibility extensions, such as for
|
|
|
+Oracle.
|
|
|
|
|
|
> [wikipedia.org/wiki/PostgreSQL](https://en.wikipedia.org/wiki/PostgreSQL)
|
|
|
|
|
|
@@ -29,8 +49,13 @@ PostgreSQL implements the majority of the SQL:2011 standard, is ACID-compliant a
|
|
|
|
|
|
docker run --name some-postgres -d postgres
|
|
|
|
|
|
-This image includes `EXPOSE 5432` (the postgres port), so standard container linking will make it automatically available to the linked containers. The default `postgres` user and database are created in the entrypoint with `initdb`.
|
|
|
-> The postgres database is a default database meant for use by users, utilities and third party applications. [postgresql.org/docs](http://www.postgresql.org/docs/9.3/interactive/app-initdb.html)
|
|
|
+This image includes `EXPOSE 5432` (the postgres port), so standard container
|
|
|
+linking will make it automatically available to the linked containers. The
|
|
|
+default `postgres` user and database are created in the entrypoint with
|
|
|
+`initdb`.
|
|
|
+> The postgres database is a default database meant for use by users, utilities
|
|
|
+> and third party applications.
|
|
|
+> [postgresql.org/docs](http://www.postgresql.org/docs/9.3/interactive/app-initdb.html)
|
|
|
|
|
|
## connect to it from an application
|
|
|
|
|
|
@@ -42,7 +67,15 @@ This image includes `EXPOSE 5432` (the postgres port), so standard container lin
|
|
|
|
|
|
# How to extend this image
|
|
|
|
|
|
-If you would like to do additional initialization in an image derived from this one, add a `*.sh` script under `/docker-entrypoint-initdb.d` (creating the directory if necessary). After the entrypoint calls `initdb` to create the default `postgres` user and database, it will source any `*.sh` script found in that directory to do further initialization before starting the service. If you need to execute SQL commands as part of your initialization, the use of Postgres'' [single user mode](http://www.postgresql.org/docs/9.3/static/app-postgres.html#AEN90580) is highly recommended.
|
|
|
+If you would like to do additional initialization in an image derived from this
|
|
|
+one, add a `*.sh` script under `/docker-entrypoint-initdb.d` (creating the
|
|
|
+directory if necessary). After the entrypoint calls `initdb` to create the
|
|
|
+default `postgres` user and database, it will source any `*.sh` script found in
|
|
|
+that directory to do further initialization before starting the service. If you
|
|
|
+need to execute SQL commands as part of your initialization, the use of
|
|
|
+Postgres'' [single user
|
|
|
+mode](http://www.postgresql.org/docs/9.3/static/app-postgres.html#AEN90580) is
|
|
|
+highly recommended.
|
|
|
|
|
|
# User Feedback
|
|
|
|