Який правильний спосіб використовувати модуль node.js postgresql?

Я пишу додаток node.js на Heroku і використовую модуль pg . Я не можу зрозуміти "правильний" спосіб отримати клієнтський об'єкт для кожного запиту, який мені потрібен для запиту до бази даних.

Документація використовує такий код:

pg.connect(conString, function(err, client) {
  // Use the client to do things here
});

Але, звичайно, вам не потрібно викликати pg.connectвсередині кожної функції, яка використовує базу даних, чи не так? Я бачив інший код, який робить це:

var conString = process.env.DATABASE_URL || "tcp://postgres:1234@localhost/postgres";
var client = new pg.Client(conString);
client.connect();
// client is a global so you can use it anywhere now

Я схиляюся до другого варіанту, оскільки я вважаю, що безкоштовний екземпляр бази даних для Heroku в будь-якому випадку обмежений одним підключенням, але чи є якісь недоліки, щоб зробити це таким чином? Чи потрібно щоразу перевіряти, чи об'єкт мого клієнта підключений, перш ніж я його використовую?

Я автор node-postgres . По-перше, перепрошую, документація не дала зрозуміти правильного варіанту: це моя вина. Я спробую це вдосконалити. Я зараз написав « Історію», щоб пояснити це, тому що розмова надто довга для Twitter.

Використання pg.connect- це спосіб рухатись у веб-середовищі.

Сервер PostgreSQL може одночасно обробляти лише 1 запит за підключення. Це означає, що якщо у вас є 1 глобальний new pg.Client()приєднаний до вашої серверної мережі, весь ваш додаток знаходиться на вузькому місці, залежно від того, як швидко postgres може відповідати на запити. Буквально все буде вибудовувати, чергуючи кожен запит. Так, це асинхронізація, і це нормально ... але чи не скоріше б ви помножили свою пропускну здатність на 10 разів? Використовуйте pg.connect встановіть pg.defaults.poolSizeщось розумне (ми робимо 25-100, ще не впевнені в правильній цифрі).

new pg.Clientдля того, коли ти знаєш, що робиш. Коли вам з якоїсь причини потрібен один довгожитель або вам потрібно дуже ретельно контролювати життєвий цикл. Хорошим прикладом цього є використання LISTEN/NOTIFY. Клієнт прослуховування повинен бути поруч і підключений, а не спільний, щоб він міг правильно обробляти NOTIFYповідомлення. Іншим прикладом може бути відкриття одноразового клієнта, щоб убити кілька завислих речей або в сценаріях командного рядка.

Одна дуже корисна річ - це централізувати весь доступ до вашої бази даних у вашому додатку до одного файлу. Не смійте pg.connectдзвінки та нових клієнтів. Майте такий файл, db.jsякий виглядає приблизно так:

module.exports = {
   query: function(text, values, cb) {
      pg.connect(function(err, client, done) {
        client.query(text, values, function(err, result) {
          done();
          cb(err, result);
        })
      });
   }
}

Таким чином, ви можете змінити свою реалізацію pg.connectна спеціальний пул клієнтів або що завгодно, і потрібно змінити речі лише в одному місці.

Погляньте на модуль node-pg-query, який робить саме це.

Я є автором pg-promis , який спрощує використання node-postgres за допомогою обіцянок.

У ньому розглядаються питання про правильний спосіб підключення до бази даних та відключення від неї за допомогою пулу підключень, реалізованого node-postgres , серед іншого, як автоматизовані транзакції.

Індивідуальний запит у pg-promis зводиться до того, що стосується вашої бізнес-логіки:

db.any('SELECT * FROM users WHERE status = $1', ['active'])
    .then(data => {
        console.log('DATA:', data);
    })
    .catch(error => {
        console.log('ERROR:', error);
    });

тобто вам не потрібно мати справу з логікою підключення при виконанні запитів, оскільки ви встановили підключення лише один раз, глобально, приблизно так:

const pgp = require('pg-promise')(/*options*/);

const cn = {
    host: 'localhost', // server name or IP address;
    port: 5432,
    database: 'myDatabase',
    user: 'myUser',
    password: 'myPassword'
};
// alternative:
// const cn = 'postgres://username:password@host:port/database';

const db = pgp(cn); // database instance;

Ви можете знайти ще багато прикладів у навчальному посібнику « Вивчення на прикладі» або на домашній сторінці проекту .

Басейн - це шлях зараз. Дещо подібне

const { Pool } = require('pg');

    const pool = new Pool({
      connectionString: DATABASE_URL,
      ssl: false,
      max: 20,
      idleTimeoutMillis: 30000,
      connectionTimeoutMillis: 2000,
    });
    module.exports = {
        query: (text, params) => pool.query(text, params)
      }

його можна використовувати як db.query('<BEGIN,COMMIT,ROLLBACK,your query,anything')

Краще створити pg-пул у всьому світі, і кожного разу, коли вам потрібно робити db-операцію, використовуйте клієнт, а потім відпускайте його назад до пулу. Після того, як всі операції з db завершені, закінчіть використання пулуpool.end()

Зразок коду -

let pool = new pg.Pool(dbConfig);
pool.connect(function(err, client, done) {

if (err) {
    console.error('Error connecting to pg server' + err.stack);
    callback(err);
} else {
    console.log('Connection established with pg db server');

    client.query("select * from employee", (err, res) => {

            if (err) {
                console.error('Error executing query on pg db' + err.stack);
                callback(err);
            } else {
                console.log('Got query results : ' + res.rows.length);


               async.each(res.rows, function(empRecord) {   
                        console.log(empRecord.name);
                });
            }
            client.release();

        });
}

});  

Для отримання детальної інформації ви можете звернутися до мого повідомлення в блозі - Джерело

Як видно з документації, обидва варіанти дійсні, тож вибирайте, що вам більше подобається. Як і ви, я піду на другий вибір.

Мене зацікавив дуже простий обробник для цього, тому я зробив свій власний, не ускладнюючи. Я не маю ілюзій, що це надзвичайно просто, але це може допомогти деяким людям розпочати роботу. В основному він підключає, запускає запити та обробляє помилки за вас.

function runQuery(queryString, callback) {
  // connect to postgres database
  pg.connect(postgresDatabase.url,function(err,client,done) {
    // if error, stop here
    if (err) {console.error(err); done(); callback(); return;}
    // execute queryString
    client.query(queryString,function(err,result) {
      // if error, stop here
      if (err) {console.error(err+'\nQuery: '+queryString); done(); callback(); return;}
      // callback to close connection
      done();
      // callback with results
      callback(result.rows);
    });
  });
}

Тоді ви використовували б, називаючи це так:

runQuery("SELECT * FROM table", function(result) {
  // Whatever you need to do with 'result'
}

Ось як я це роблю, свого роду "все вищезазначене"

Promise = require 'bluebird'
pg = module.exports = require 'pg'

Promise.promisifyAll pg.Client.prototype
Promise.promisifyAll pg.Client
Promise.promisifyAll pg.Connection.prototype
Promise.promisifyAll pg.Connection
Promise.promisifyAll pg.Query.prototype
Promise.promisifyAll pg.Query
Promise.promisifyAll pg

connectionString = process.env.DATABASE_URL

module.exports.queryAsync = (sql, values) ->
  pg.connectAsync connectionString
  .spread (connection, release) ->
    connection.queryAsync sql, values
    .then (result) ->
      console.log result.rows[0]
    .finally ->
      release()