Postgrex v0.9.0 → Overview → Postgrex → Connection

Postgrex.Connection

Summary
Functions

Main API for Postgrex. This module handles the connection to postgres.

Source

Summary↑

decode(result_set, mapper \\ fn x -> x end)	Decodes a result set
listen!(pid, channel, opts \\ [])	Listens to an asynchronous notification channel `channel`. See `listen/2`
listen(pid, channel, opts \\ [])	Listens to an asynchronous notification channel using the `LISTEN` command. A message `{:notification, connection_pid, ref, channel, payload}` will be sent to the calling process when a notification is received
parameters(pid, opts \\ [])	Returns a cached map of connection parameters
query!(pid, statement, params, opts \\ [])	Runs an (extended) query and returns the result or raises `Postgrex.Error` if there was an error. See `query/3`
query(pid, statement, params, opts \\ [])	Runs an (extended) query and returns the result as `{:ok, %Postgrex.Result{}}` or `{:error, %Postgrex.Error{}}` if there was an error. Parameters can be set in the query as `$1` embedded in the query string. Parameters are given as a list of elixir values. See the README for information on how Postgrex encodes and decodes elixir values by default. See `Postgrex.Result` for the result data
start_link(opts)	Start the connection process and connect to postgres
stop(pid, opts \\ [])	Stop the process and disconnect
unlisten!(pid, ref, opts \\ [])	Stops listening on the given channel by passing the reference returned from `listen/2`
unlisten(pid, ref, opts \\ [])	Stops listening on the given channel by passing the reference returned from `listen/2`

Functions

decode(result_set, mapper \\ fn x -> x end)

(function) # ↑

Decodes a result set.

It is a no-op if the result was already decoded.

A mapper function can be given to further process each row, in no specific order.

Source

listen(pid, channel, opts \\ [])

(function) # ↑

Specs:

listen(pid, String.t, Keyword.t) :: {:ok, reference} | {:error, Postgrex.Error.t}

Listens to an asynchronous notification channel using the LISTEN command. A message {:notification, connection_pid, ref, channel, payload} will be sent to the calling process when a notification is received.

Options

:timeout - Call timeout (default: 5000)

Source

listen!(pid, channel, opts \\ [])

(function) # ↑

Specs:

listen!(pid, String.t, Keyword.t) :: reference

Listens to an asynchronous notification channel channel. See listen/2.

Source

parameters(pid, opts \\ [])

(function) # ↑

Specs:

parameters(pid, Keyword.t) :: map

Returns a cached map of connection parameters.

Options

:timeout - Call timeout (default: 5000)

Source

query(pid, statement, params, opts \\ [])

(function) # ↑

Specs:

query(pid, iodata, list, Keyword.t) :: {:ok, Postgrex.Result.t} | {:error, Postgrex.Error.t}

Runs an (extended) query and returns the result as {:ok, %Postgrex.Result{}} or {:error, %Postgrex.Error{}} if there was an error. Parameters can be set in the query as $1 embedded in the query string. Parameters are given as a list of elixir values. See the README for information on how Postgrex encodes and decodes elixir values by default. See Postgrex.Result for the result data.

Options

:timeout - Call timeout (default: 5000)
:decode - If the result set decoding should be done automatically (:auto) or manually (:manual) via decode/2. Defaults to :auto.

Examples

Postgrex.Connection.query(pid, "CREATE TABLE posts (id serial, title text)", [])

Postgrex.Connection.query(pid, "INSERT INTO posts (title) VALUES ('my title')", [])

Postgrex.Connection.query(pid, "SELECT title FROM posts", [])

Postgrex.Connection.query(pid, "SELECT id FROM posts WHERE title like $1", ["%my%"])

Source

query!(pid, statement, params, opts \\ [])

(function) # ↑

Specs:

query!(pid, iodata, list, Keyword.t) :: Postgrex.Result.t

Runs an (extended) query and returns the result or raises Postgrex.Error if there was an error. See query/3.

Source

start_link(opts)

(function) # ↑

Specs:

start_link(Keyword.t) :: {:ok, pid} | {:error, Postgrex.Error.t | term}

Start the connection process and connect to postgres.

Options

:hostname - Server hostname (default: PGHOST env variable, then localhost);
:port - Server port (default: 5432);
:database - Database (required);
:username - Username (default: PGUSER env variable, then USER env var);
:password - User password (default PGPASSWORD);
:parameters - Keyword list of connection parameters;
:timeout - Connect timeout in milliseconds (default: 5000);
:ssl - Set to true if ssl should be used (default: false);
:ssl_opts - A list of ssl options, see ssl docs;
:socket_options - Options to be given to the underlying socket;
:sync_connect - Block in start_link/1 until connection is set up (default: false)
:extensions - A list of {module, opts} pairs where module is implementing the Postgrex.Extension behaviour and opts are the extension options;

Source

stop(pid, opts \\ [])

(function) # ↑

Specs:

stop(pid, Keyword.t) :: :ok

Stop the process and disconnect.

Options

:timeout - Call timeout (default: 5000)

Source

unlisten(pid, ref, opts \\ [])

(function) # ↑

Specs:

unlisten(pid, reference, Keyword.t) :: :ok | {:error, Postgrex.Error.t}

Stops listening on the given channel by passing the reference returned from listen/2.

Options

:timeout - Call timeout (default: 5000)

Source

unlisten!(pid, ref, opts \\ [])

(function) # ↑

Specs:

unlisten!(pid, reference, Keyword.t) :: :ok

Stops listening on the given channel by passing the reference returned from listen/2.

Source