[Документация Yandex Cloud](../../index.md) > [Yandex Object Storage](../index.md) > [Практические руководства](index.md) > Перенос данных и интеграция с базами данных > Выгрузка данных Greenplum® в гибридное хранилище Yandex Object Storage

# Выгрузка данных Greenplum® в гибридное хранилище Yandex Object Storage

# Выгрузка данных Greenplum® в гибридное хранилище

В кластере Greenplum® можно включить [гибридное хранилище](../../managed-greenplum/concepts/hybrid-storage.md) для [таблиц типа AO и AOCO](../../managed-greenplum/concepts/tables.md) (append-optimized storage). Тогда с помощью [расширения Yezzey](../../managed-greenplum/operations/extensions/yezzey.md) данные этих таблиц можно перенести из хранилища кластера в гибридное хранилище.

Гибридное хранилище удобно, если данные нужно хранить долго, а работать с ними планируется редко. Так хранение [будет дешевле](../../managed-greenplum/pricing/index.md#rules-storage).

Чтобы перенести данные из хранилища кластера в гибридное хранилище:

1. [Подготовьте инфраструктуру](#prepare-infrastructure).
1. [Выгрузите таблицу Greenplum® в гибридное хранилище](#transfer).
1. [Проверьте результат](#check).

Также есть возможность [перенести данные обратно](#offload-to-local-storage) в хранилище кластера.

Если созданные ресурсы вам больше не нужны, [удалите их](#clear-out).

## Перед началом работы {#before-you-begin}

Зарегистрируйтесь в Yandex Cloud и создайте [платежный аккаунт](../../billing/concepts/billing-account.md):
1. Перейдите в [консоль управления](https://console.yandex.cloud), затем войдите в Yandex Cloud или зарегистрируйтесь.
1. На странице **[Yandex Cloud Billing](https://center.yandex.cloud/billing/accounts)** убедитесь, что у вас подключен платежный аккаунт, и он находится в [статусе](../../billing/concepts/billing-account-statuses.md) `ACTIVE` или `TRIAL_ACTIVE`. Если платежного аккаунта нет, [создайте его](../../billing/quickstart/index.md) и [привяжите](../../billing/operations/pin-cloud.md) к нему облако.

Если у вас есть активный платежный аккаунт, вы можете создать или выбрать [каталог](../../resource-manager/concepts/resources-hierarchy.md#folder), в котором будет работать ваша инфраструктура, на [странице облака](https://console.yandex.cloud/cloud).

[Подробнее об облаках и каталогах](../../resource-manager/concepts/resources-hierarchy.md).


### Необходимые платные ресурсы {#paid-resources}

* Кластер Yandex MPP Analytics for PostgreSQL: использование выделенных хостам вычислительных ресурсов, объем хранилища и резервных копий ([тарифы Yandex MPP Analytics for PostgreSQL](../../managed-greenplum/pricing/index.md)).
* Бакет Yandex Object Storage: использование хранилища и выполнение операций с данными ([тарифы Object Storage](../pricing.md)).
* Публичные IP-адреса, если для хостов кластера включен публичный доступ ([тарифы Yandex Virtual Private Cloud](../../vpc/pricing.md)).


## Подготовьте инфраструктуру {#prepare-infrastructure}

1. [Создайте кластер](../../managed-greenplum/operations/cluster-create.md) Greenplum®. При создании убедитесь, что включена опция **Гибридное хранилище**.

   {% note info %}

   Эту опцию нельзя отключить после сохранения настроек кластера.

   {% endnote %}

1. Получите SSL-сертификат для подключения к базе данных Greenplum®:

   {% list tabs group=operating_system %}
   
   - Linux (Bash)/macOS (Zsh) {#linux-macos}
   
      ```bash
      mkdir -p ~/.postgresql && \
      wget "https://storage.yandexcloud.net/cloud-certs/RootCA.pem" \
           --output-document ~/.postgresql/root.crt && \
      chmod 0655 ~/.postgresql/root.crt
      ```
   
      Сертификат будет сохранен в файле `~/.postgresql/root.crt`.
   
   - Windows (PowerShell) {#windows}
   
      ```powershell
      mkdir $HOME\.postgresql; curl.exe -o $HOME\.postgresql\root.crt https://storage.yandexcloud.net/cloud-certs/RootCA.pem
      ```
   
      Сертификат будет сохранен в файле `$HOME\.postgresql\root.crt`.
   
      Корпоративные политики и антивирус могут блокировать скачивание сертификата. Подробнее в разделе [Вопросы и ответы](../../managed-greenplum/qa/connection.md#get-ssl-error).
   
   {% endlist %}

   Для использования графических IDE [сохраните сертификат](https://storage.yandexcloud.net/cloud-certs/RootCA.pem) в локальную папку и укажите путь к нему в настройках подключения.

## Выгрузите таблицу Greenplum® в гибридное хранилище {#transfer}

1. Подключитесь к кластеру:

   ```bash
   psql "host=c-<идентификатор_кластера>.rw.mdb.yandexcloud.net \
        port=6432 \
        sslmode=verify-full \
        dbname=postgres \
        user=<имя_пользователя> \
        target_session_attrs=read-write"
   ```

1. Создайте БД `db_with_yezzey`:

   ```bash
   CREATE DATABASE db_with_yezzey;
   ```

   Для новой БД будут предоставлены права доступа на установку расширений. Такие права не выдаются для БД, установленной по умолчанию.

1. Подключитесь к новой БД:

   ```bash
   \connect db_with_yezzey
   ```

1. Создайте расширение Yezzey:

   ```bash
   CREATE EXTENSION yezzey;
   ```

1. Создайте AO-таблицу `ao_table`:

   ```bash
   CREATE TABLE ao_table (a int)
       WITH (appendoptimized=true)
       DISTRIBUTED BY (a);
   ```

1. Заполните таблицу рядом целых чисел от 1 до 10 000:

   ```bash
   INSERT INTO ao_table SELECT * FROM GENERATE_SERIES(1, 10000);
   ```

1. Перенесите данные таблицы `ao_table` в гибридное хранилище:

   ```bash
   SELECT yezzey_define_offload_policy('ao_table');
   ```

## Проверьте результат {#check}

1. Проверьте, сколько места в локальном кеше кластера и в гибридном хранилище занимают:

   * таблица `ao_table`:

      ```bash
      SELECT * FROM yezzey_offload_relation_status('ao_table');
      ```

   * каждый сегментный файл таблицы `ao_table`:

      ```bash
      SELECT * FROM yezzey_offload_relation_status_per_filesegment('ao_table');
      ```

   Если столбец `external_bytes` в выводе команд содержит ненулевые значения, значит, таблица перенесена в гибридное хранилище.

1. Посмотрите, какие сегментные файлы таблицы перенесены в гибридное хранилище:

   ```bash
   SELECT * FROM yezzey_relation_describe_external_storage_structure('ao_table');
   ```

1. Убедитесь, что доступно чтение данных из перенесенной таблицы:

   ```bash
   SELECT AVG(a) FROM ao_table;
   ```

   Результат:

   ```text
             avg          
   -----------------------
    5000.5000000000000000
   (1 row)
   ```

1. Убедитесь, что доступна запись в перенесенную таблицу:

   1. Добавьте в таблицу `ao_table` ряд целых чисел от 1 до 10 000:

      ```bash
      INSERT INTO ao_table SELECT * FROM GENERATE_SERIES(1, 10000);
      ```

   1. Проверьте, что количество строк увеличилось вдвое:

      ```bash
      SELECT COUNT(1) FROM ao_table;
      ```

      Результат:

      ```text
       count
      -------
       20000
      (1 row)
      ```

## Перенесите таблицу из гибридного хранилища в хранилище кластера {#offload-to-local-storage}

Если нужно перенести таблицу `ao_table` из гибридного хранилища обратно в хранилище кластера, выполните команду:

```bash
SELECT yezzey_load_relation('ao_table');
```

## Удалите созданные ресурсы {#clear-out}

Если созданный кластер вам больше не нужен, [удалите его](../../managed-greenplum/operations/cluster-delete.md).

_Greenplum® и Greenplum Database® являются зарегистрированными товарными знаками или товарными знаками Broadcom Inc в США и/или других странах._