Инструкция для новичков

Всё, что нужно знать до первого запроса: что за звери такие «база», «строка подключения» и «Kafka», как подключиться, как работают тарифы и квоты и что будет, если не оплатить. Если после этой страницы останутся вопросы — напишите в поддержку, ответим.

• Словарь: что означает каждый термин
• Подключение за 5 шагов
• Готовый код для вашего языка
• Пароли, TLS и лимиты
• Тарифы: что сколько стоит
• Что будет, если не оплатить
• Что будет, если закончится место
• Kafka: зачем она и как подключить
• Частые ошибки и их смысл
• Куда писать, если не получается

Что означает каждый термин

Без этих десяти слов не читается ни одна инструкция в интернете.

Пять шагов до первого запроса

1. Зарегистрируйтесь. Нужны только почта и пароль, карта не требуется. Бесплатная база создаётся сразу.
2. Создайте базу. В кабинете нажмите «Создать» — имя базы сервис придумает сам, например t_3fa1c9. Менять его не нужно и нельзя: это же и логин. Через несколько секунд база готова.
3. Получите пароль. Кнопка «Получить пароль» создаёт пароль и показывает его один раз: после обновления страницы он скроется. Сохраните в менеджер паролей — восстановить нельзя, только сменить.
4. Скопируйте строку подключения. В кабинете есть готовые примеры для psql, DBeaver и языков программирования — копируются в один клик.
5. Проверьте. Самый простой способ — psql:

   psql "postgresql://t_3fa1c9:ПАРОЛЬ@infranest.ru:5432/t_3fa1c9?sslmode=require" -c "select now();"

   Если в ответ пришла дата — всё работает.

Что писать в приложение

Обычно достаточно одной строки — приложение само разберёт её на хост, порт, логин и пароль. В примерах ниже t_3fa1c9 — имя базы, которое придумал сервис; своё смотрите в кабинете, оно же будет логином.

DATABASE_URL=postgresql://t_3fa1c9:ПАРОЛЬ@infranest.ru:5432/t_3fa1c9?sslmode=require

Для Java/Spring — обычный JDBC-адрес: jdbc:postgresql://infranest.ru:5432/t_3fa1c9?sslmode=require, логин и пароль отдельными свойствами.

Примеры для каждого языка

Полные, с копированием, лежат в кабинете. Здесь — минимальный рабочий каркас.

Python

import psycopg
conn = psycopg.connect("postgresql://t_3fa1c9:ПАРОЛЬ@infranest.ru:5432/t_3fa1c9?sslmode=require")
with conn.cursor() as cur:
    cur.execute("select version()")
    print(cur.fetchone())

Node.js

const { Pool } = require("pg");
const db = new Pool({ connectionString: process.env.DATABASE_URL, ssl: true });
const { rows } = await db.query("select now()");
console.log(rows);

Java / Spring Boot

spring.datasource.url=jdbc:postgresql://infranest.ru:5432/t_3fa1c9?sslmode=require
spring.datasource.username=t_3fa1c9
spring.datasource.password=ПАРОЛЬ

PHP, Go, .NET

Любой драйвер PostgreSQL подойдёт: PDO с pdo_pgsql, pgx для Go, Npgsql для .NET. Правило одно: строка подключения та же, TLS обязателен.

Пароли, TLS и лимиты

• Один пароль на базу. У каждой базы свой пользователь, соседние базы его не видят.
• Пароль показывается один раз. Мы храним только его хэш. Забыли — сбросьте в кабинете, старый перестанет работать.
• TLS обязателен. Без sslmode=require соединение не установится: так пароль не уйдёт открытым текстом.
• Лимит соединений. У Free — 3, у «Недели» и Starter — 10, у Pro — 25. Приложению хватает 5–10; пул соединений в коде лучше ограничить этим числом.
• Долгие запросы прерываются. Ограничение 30 секунд. Это защита общей базы от случайного select * на миллион строк.
• Временные файлы ограничены. От 512 МБ до 4 ГБ в зависимости от тарифа: тяжёлая сортировка не съест диск сервера.

Что сколько стоит

Цена за период тарифа — неделя или месяц, НДС не облагается (УСН). Платить картой через ЮKassa, чек приходит на почту. Одна база на аккаунт на любом тарифе.

Kafka

Как перейти на другой тариф

1. В кабинете нажмите «Сменить тариф».
2. Выберите нужный и оплатите — лимиты диска и соединений применятся сразу после оплаты, база не пересоздаётся.
3. Понизить тариф можно, только если данные влезают в новый диск. Иначе сначала почистите базу.

Что будет, если не оплатить

Данные не исчезают в один момент. У вас есть время спокойно продлить или выгрузить всё.

Что будет, если закончится место

Как почистить

• Удалить ненужные строки: delete from logs where created_at < now() - interval '30 days'.
• Освободить место на диске после удаления: vacuum full logs (таблица на время блокируется, делайте в простой).
• Если подходящих данных больше нет — сменить тариф на больший.

Kafka: зачем и как подключить

Kafka нужна, когда приложение состоит из нескольких частей и они передают друг другу события. Для обычного сайта или бота хватит PostgreSQL.

1. Kafka входит в платные тарифы («Неделя», Starter, Pro): после оплаты подписка создаётся сама, с префиксом вида k_1a2b3c.
2. Создайте пользователей (Producer — пишет, Consumer — читает) и топики. Имена начинаются с вашего префикса.
3. Подключение: infranest.ru:9093, протокол SASL_SSL, механизм SCRAM-SHA-512, логин и пароль — из кабинета.

spring.kafka.bootstrap-servers=infranest.ru:9093
spring.kafka.properties.security.protocol=SASL_SSL
spring.kafka.properties.sasl.mechanism=SCRAM-SHA-512
spring.kafka.properties.sasl.jaas.config=org.apache.kafka.common.security.scram.ScramLoginModule required username="k_1a2b3c-producer" password="ПАРОЛЬ";

Если подписка не оплачена: сначала «льготный период» — всё работает, потом доступы отключаются, данные остаются. Оплата возвращает доступ.

Частые ошибки и их смысл

Куда писать, если не получается

Мы отвечаем в рабочие дни, обычно в течение нескольких часов.

• Почта: support@infranest.ru
• Обращение в кабинете: раздел «Обращения» — там же видна переписка и ответы.
• Что приложить: имя базы, текст ошибки, язык и версию драйвера. Пароль не присылайте никогда.