VK Cloud logo
Обновлена31 октября 2023 г. в 06:09

Подключение к БД

К БД развернутых в VK Cloud инстансов можно подключиться с помощью SDK.

Вы можете подключиться к БД как обычный пользователь или как администратор инстанса — пользователь с максимально широкими полномочиями во всех БД инстанса.

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

Тип СУБД
Имя пользователя
Комментарий
ClickHouse
root
MongoDB
root
При подключении от имени администратора необходимо дополнительно указывать параметр authSource=admin, подробнее в документации MongoDB
MySQL
root
OpenSearch
root
Все созданные через VK Cloud пользователи получают права администратора
PostgreSQL
PostgresPro
postgres
Redis 5
default
Используется, если включена опция requirepass. Можно не задавать имя пользователя при подключении (эквивалентно default)
Redis 6
root
Tarantool
admin

PostgreSQL

  1. Убедитесь, что PHP и composer установлены.

  2. Установите библиотеку php-pgsql.

  3. Подключитесь к базе данных с помощью функции pg_connect():

    $conn = pg_connect("host=<IP-ADDRESS> dbname=<DATABASE> user=<USERNAME> password=<PASSWORD>");

    Здесь:

    • <IP-ADDRESS> — внешний IP-адрес инстанса БД;
    • <DATABASE> — имя БД;
    • <USERNAME> — имя пользователя БД;
    • <PASSWORD> — пароль пользователя БД.

Подробнее о подключении к PostgreSQL в PHP читайте в документации.

MySQL

  1. Убедитесь, что PHP и composer установлены.

  2. Установите библиотеку php-mysql.

  3. Подключитесь к базе данных с помощью функции mysqli_real_connect():

    1$conn = mysqli_init();
    2
    3mysqli_real_connect($conn, "<IP-ADDRESS>", "<USERNAME>", "<PASSWORD>", "<DATABASE>", <PORT>);

    Здесь:

    • <IP-ADDRESS> — внешний IP-адрес инстанса БД;
    • <DATABASE> — имя БД;
    • <PORT> — порт подключения, стандартный — 3306;
    • <USERNAME> — имя пользователя БД;
    • <PASSWORD> — пароль пользователя БД.

Подробнее о подключении к MySQL в PHP читайте в документации.

Tarantool

  1. Убедитесь, что PHP и composer установлены.

  2. Установите библиотеку tarantool/client.

  3. Подключитесь к базе данных с помощью метода Client::fromDsn:

    1require_once __DIR__ . '/vendor/autoload.php';
    2
    3use Tarantool\Client\Client;
    4$client = Client::fromDsn('tcp://<USERNAME>:PASSWORD>@<IP-ADDRESS>');

    Здесь:

    • <IP-ADDRESS> — внешний IP-адрес инстанса БД;
    • <USERNAME> — имя пользователя БД;
    • <PASSWORD> — пароль пользователя БД.

Подробнее о подключении к Tarantool в PHP читайте в документации.

ClickHouse

  1. Убедитесь, что PHP и composer установлены.

  2. Установите php-curl.

  3. Установите модуль smi2/phpclickhouse.

  4. Подключитесь к базе данных:

    1require_once __DIR__ . '/vendor/autoload.php';
    2
    3$config = [
    4    'host' => '<IP-ADDRESS>',
    5    'port' => '<PORT>',
    6    'username' => '<USERNAME>',
    7    'password' => '<PASSWORD>'
    8];
    9$db = new ClickHouseDB\Client($config);
    10$db->database('<DATABASE>');

    Здесь:

    • <IP-ADDRESS> — внешний IP-адрес инстанса БД;
    • <DATABASE> — имя БД;
    • <PORT> — порт подключения, стандартный — 8123;
    • <USERNAME> — имя пользователя БД;
    • <PASSWORD> — пароль пользователя БД.

MongoDB

  1. Убедитесь, что PHP и composer установлены.

  2. Установите PHP-библиотеку для MongoDB.

  3. Подключитесь к базе данных:

    $manager = new MongoDB\Driver\Manager("mongodb://<IP-ADDRESS>/<DATABASE>", array("username" => <USERNAME>, "password" => <PASSWORD>));

    Здесь:

    • <IP-ADDRESS> — внешний IP-адрес инстанса БД;
    • <DATABASE> — имя БД;
    • <USERNAME> — имя пользователя БД;
    • <PASSWORD> — пароль пользователя БД.

Redis

  1. Убедитесь, что PHP и composer установлены.

  2. Установите predis.

  3. Подключитесь к базе данных:

    1require_once __DIR__ . '/vendor/autoload.php';
    2
    3Predis\Autoloader::register();
    4
    5$client = new Predis\Client('tcp://<IP-ADDRESS>');

    Здесь:

    • <IP-ADDRESS> — внешний IP-адрес инстанса БД;
    • <DATABASE> — имя БД;
    • <USERNAME> — имя пользователя БД;
    • <PASSWORD> — пароль пользователя БД.