Команда ReQL: connect

Синтаксис команды

r.connect(options) → connection

Описание

Создайте новое подключение к серверу базы данных. Ключевые аргументы:

• host: хост экземпляра RethinkDB. Значение по умолчанию localhost.
• port: порт драйвера, по умолчанию 28015.
• db: база данных, используемая, если не указана явно в запросе, по умолчанию test.
• user: учетная запись пользователя для подключения (по умолчанию admin).
• password: пароль для учетной записи пользователя для подключения (по умолчанию '', пустой).
• timeout: временной интервал таймаута в секундах для открытия подключения (по умолчанию 20).
• ssl: хеш настроек для поддержки SSL-соединений (по умолчанию None). В настоящее время доступна только одна настройка, и если указан параметр ssl, этот ключ обязателен:
  • ca_certs: путь к сертификату SSL CA.

Если подключение не может быть установлено, будет брошено исключение ReqlDriverError.

Возвращаемый объект подключения будет иметь два метода, возвращающих порт и адрес подключения:

conn.client_port()
conn.client_address()

Использование SSL с RethinkDB требует прокси-программного обеспечения на сервере, такого как Nginx, HAProxy или SSL-туннель. RethinkDB будет шифровать трафик и проверять сертификат CA, чтобы предотвратить атаки «человек посередине». Для получения более подробной информации см. документацию по вашей прокси-программе.

В качестве альтернативы, вы можете использовать встроенную поддержку TLS RethinkDB TLS support.

Драйвер RethinkDB для Python включает поддержку асинхронных подключений с использованием Tornado и Twisted. Подробнее читайте в документации по асинхронным подключениям.

Примечание: В настоящее время драйвер Python не потокобезопасен. Каждый поток или процесс multiprocessing должен получать собственный объект подключения. (Это, вероятно, изменится в будущих версиях RethinkDB; вы можете отслеживать проблему #2427.)

Пример: Открыть подключение с использованием хоста и порта по умолчанию, указав базу данных по умолчанию.

conn = r.connect(db='marvel')

Пример: Открыть новое подключение к базе данных.

conn = r.connect(host='localhost',
                 port=28015,
                 db='heroes')

Пример: Открыть новое подключение к базе данных, указав комбинацию пользователя/пароля для аутентификации.

conn = r.connect(host='localhost',
                 port=28015,
                 db='heroes',
                 user='herofinder',
                 password='metropolis')

Пример: Открыть новое подключение к базе данных с использованием SSL-прокси.

conn = r.connect(host='localhost',
                 port=28015,
                 ssl={'ca_certs': '/path/to/ca.crt'})

Пример: Использовать оператор with для открытия подключения и передачи его в блок. При использовании такого стиля подключение будет автоматически закрыто, когда выполнение достигнет конца блока.

with r.connect(db='marvel') as conn:
    r.table('superheroes').run(conn)