[Документация Yandex Cloud](../../../index.md) > [Yandex MPP Analytics for PostgreSQL](../../index.md) > [Пошаговые инструкции](../index.md) > Работа с PXF > Изменение настроек PXF # Изменение настроек PXF Настройки [PXF](../external-tables.md), которые можно задать средствами Yandex Cloud, совпадают с настройками в конфигурационном файле [pxf-application.properties](https://techdocs.broadcom.com/us/en/vmware-tanzu/data-solutions/tanzu-greenplum-platform-extension-framework/6-11/gp-pxf/config_files.html#pxfappprops). Он описывает свойства протокола PXF. В кластере Yandex MPP Analytics for PostgreSQL для настроек PXF заданы значения по умолчанию. Чтобы оптимизировать работу с [внешними таблицами](../../concepts/external-tables.md), вы можете изменить настройки PXF с помощью интерфейсов Yandex Cloud вместо правки файла. {% list tabs group=instructions %} - Консоль управления {#console} Чтобы изменить настройки PXF: 1. Перейдите [на страницу каталога](https://kz.console.yandex.cloud). 1. Перейдите в сервис **Yandex MPP Analytics for PostgreSQL**. 1. Нажмите на имя нужного кластера и выберите на панели слева ![image](../../../_assets/console-icons/arrow-right-arrow-left.svg) **PXF**. 1. Нажмите кнопку ![image](../../../_assets/console-icons/pencil.svg) **Изменить настройки PXF** в верхней части страницы. 1. Измените настройки: * **Connection Timeout** — таймаут подключения к серверу Apache Tomcat® во время выполнения запросов на чтение. Диапазон значений: от `5` до `600` секунд. Значение можно указать в разных единицах времени. * **Upload Timeout** — таймаут подключения к серверу Apache Tomcat® во время выполнения запросов на запись. Диапазон значений: от `5` до `600` секунд. Значение можно указать в разных единицах времени. * **Max Threads** — максимальное количество потоков Apache Tomcat®. Диапазон значений: от `1` до `1024`. Чтобы предотвратить ситуации, когда запросы зависают или не выполняются из-за перерасхода памяти или некорректной работы сборщика мусора Java, задайте количество потоков Apache Tomcat®. О регулировке числа потоков читайте в документации [VMware Greenplum® Platform Extension Framework](https://techdocs.broadcom.com/us/en/vmware-tanzu/data-solutions/tanzu-greenplum-platform-extension-framework/6-11/gp-pxf/cfg_mem.html). * **Pool Allow Core Thread Timeout** — разрешен ли таймаут для стриминговых потоков ядра приложения (core streaming threads). * **Pool Core Size** — количество стриминговых потоков ядра в пуле. Диапазон значений: от `1` до `1024`. * **Pool Queue Capacity** — максимальное количество запросов, которое можно добавить в очередь в пул за стриминговыми потоками ядра. Диапазон значений: от нуля и выше. При значении `0` очередь в пул не образуется. * **Pool Max Size** — максимально допустимое количество стриминговых потоков ядра. Диапазон значений: от `1` до `1024`. * **Xmx** — максимальный размер JVM-кучи для демона PXF. Диапазон значений: от `64` до `16384` МБ. Значение можно указать в разных единицах измерения. * **Xms** — изначальный размер JVM-кучи для демона PXF. Диапазон значений: от `64` до `16384` МБ. Значение можно указать в разных единицах измерения. 1. Нажмите кнопку **Сохранить**. - CLI {#cli} Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../../cli/quickstart.md#install). По умолчанию используется каталог, указанный при [создании](../../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа. Чтобы изменить настройки PXF: 1. Посмотрите описание команды CLI для изменения конфигурации кластера: ```bash yc managed-greenplum cluster update --help ``` 1. Задайте настройки PXF: ```bash yc managed-greenplum cluster update <имя_или_идентификатор_кластера> \ --pxf-connection-timeout=<таймаут_для_запросов_на_чтение> \ --pxf-upload-timeout=<таймаут_для_запросов_на_запись> \ --pxf-max-threads=<максимальное_число_потоков_Apache_Tomcat®> \ --pxf-pool-allow-core-thread-timeout=<разрешен_ли_таймаут_для_стриминговых_потоков> \ --pxf-poll-core-size=<количество_стриминговых_потоков> \ --pxf-pool-queue-capacity=<емкость_очереди_в_пул_за_стриминговыми_потоками> \ --pxf-pool-max-size=<максимальное_число_стриминговых_потоков> \ --pxf-xmx=<максимальный_размер_JVM-кучи> \ --pxf-xms=<изначальный_размер_JVM-кучи> ``` Где: * `pxf-connection-timeout` — таймаут подключения к серверу Apache Tomcat® во время выполнения запросов на чтение (в секундах). Диапазон значений: от `5` до `600`. * `pxf-upload-timeout` — таймаут подключения к серверу Apache Tomcat® во время выполнения запросов на запись (в секундах). Диапазон значений: от `5` до `600`. * `pxf-max-threads` — максимальное количество потоков Apache Tomcat®. Диапазон значений: от `1` до `1024`. Чтобы предотвратить ситуации, когда запросы зависают или не выполняются из-за перерасхода памяти или некорректной работы сборщика мусора Java, задайте количество потоков Apache Tomcat®. О регулировке числа потоков читайте в документации [VMware Greenplum® Platform Extension Framework](https://techdocs.broadcom.com/us/en/vmware-tanzu/data-solutions/tanzu-greenplum-platform-extension-framework/6-11/gp-pxf/cfg_mem.html). * `pxf-pool-allow-core-thread-timeout` — разрешен ли таймаут для стриминговых потоков ядра приложения (core streaming threads). Значение по умолчанию: `false`. * `pxf-poll-core-size` — количество стриминговых потоков ядра в пуле. Диапазон значений: от `1` до `1024`. * `pxf-pool-queue-capacity` — максимальное количество запросов, которое можно добавить в очередь в пул за стриминговыми потоками ядра. Диапазон значений: от нуля и выше. При значении `0` очередь в пул не образуется. * `pxf-pool-max-size` — максимально допустимое количество стриминговых потоков ядра. Диапазон значений: от `1` до `1024`. * `pxf-xmx` — максимальный размер JVM-кучи для демона PXF (в мегабайтах). Диапазон значений: от `64` до `16384`. * `pxf-xms` — изначальный размер JVM-кучи для демона PXF (в мегабайтах). Диапазон значений: от `64` до `16384`. Имя кластера можно [получить со списком кластеров в каталоге](../cluster-list.md#list-clusters). - Terraform {#tf} Чтобы изменить настройки PXF: 1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры. Как создать такой файл, читайте в разделе [Создание кластера Yandex MPP Analytics for PostgreSQL](../cluster-create.md). Полный список доступных для изменения полей конфигурации кластера Yandex MPP Analytics for PostgreSQL вы найдете в [документации провайдера Terraform](../../../terraform/resources/mdb_greenplum_cluster.md). 1. В описании кластера, в блоке `pxf_config`, задайте настройки PXF: ```hcl resource "yandex_mdb_greenplum_cluster" "<имя_кластера>" { ... pxf_config { connection_timeout = <таймаут_для_запросов_на_чтение> upload_timeout = <таймаут_для_запросов_на_запись> max_threads = <максимальное_число_потоков_Apache_Tomcat®> pool_allow_core_thread_timeout = <разрешен_ли_таймаут_для_стриминговых_потоков> pool_core_size = <количество_стриминговых_потоков> pool_queue_capacity = <емкость_очереди_в_пул_за_стриминговыми_потоками> pool_max_size = <максимальное_число_стриминговых_потоков> xmx = <максимальный_размер_JVM-кучи> xms = <изначальный_размер_JVM-кучи> } } ``` Где: * `connection_timeout` — таймаут подключения к серверу Apache Tomcat® во время выполнения запросов на чтение (в секундах). Диапазон значений: от `5` до `600`. * `upload_timeout` — таймаут подключения к серверу Apache Tomcat® во время выполнения запросов на запись (в секундах). Диапазон значений: от `5` до `600`. * `max_threads` — максимальное количество потоков Apache Tomcat®. Диапазон значений: от `1` до `1024`. Чтобы предотвратить ситуации, когда запросы зависают или не выполняются из-за перерасхода памяти или некорректной работы сборщика мусора Java, задайте количество потоков Apache Tomcat®. О регулировке числа потоков читайте в документации [VMware Greenplum® Platform Extension Framework](https://techdocs.broadcom.com/us/en/vmware-tanzu/data-solutions/tanzu-greenplum-platform-extension-framework/6-11/gp-pxf/cfg_mem.html). * `pool_allow_core_thread_timeout` — разрешен ли таймаут для стриминговых потоков ядра приложения (core streaming threads). Значение по умолчанию: `false`. * `pool_core_size` — количество стриминговых потоков ядра в пуле. Диапазон значений: от `1` до `1024`. * `pool_queue_capacity` — максимальное количество запросов, которое можно добавить в очередь в пул за стриминговыми потоками ядра. Диапазон значений: от нуля и выше. При значении `0` очередь в пул не образуется. * `pool_max_size` — максимально допустимое количество стриминговых потоков ядра. Диапазон значений: от `1` до `1024`. * `xmx` — максимальный размер JVM-кучи для демона PXF (в мегабайтах). Диапазон значений: от `64` до `16384`. * `xms` — изначальный размер JVM-кучи для демона PXF (в мегабайтах). Диапазон значений: от `64` до `16384`. 1. Проверьте корректность настроек. 1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры. 1. Выполните команду: ```bash terraform validate ``` Если в файлах конфигурации есть ошибки, Terraform на них укажет. 1. Подтвердите изменение ресурсов. 1. Выполните команду для просмотра планируемых изменений: ```bash terraform plan ``` Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены. 1. Если вас устраивают планируемые изменения, внесите их: 1. Выполните команду: ```bash terraform apply ``` 1. Подтвердите изменение ресурсов. 1. Дождитесь завершения операции. - REST API {#api} 1. [Получите IAM-токен для аутентификации в API](../../api-ref/authentication.md) и поместите токен в переменную среды окружения: ```bash export IAM_TOKEN="" ``` 1. Воспользуйтесь методом [Cluster.Update](../../api-ref/Cluster/update.md) и выполните запрос, например, с помощью [cURL](https://curl.se/): {% note warning %} Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре `updateMask` (одной строкой через запятую). {% endnote %} ```bash curl \ --request PATCH \ --header "Authorization: Bearer $IAM_TOKEN" \ --header "Content-Type: application/json" \ --url 'https://mdb.api.yandexcloud.kz/managed-greenplum/v1/clusters/<идентификатор_кластера>' \ --data '{ "updateMask": "configSpec.pxfConfig.connectionTimeout,configSpec.pxfConfig.uploadTimeout,configSpec.pxfConfig.maxThreads,configSpec.pxfConfig.poolAllowCoreThreadTimeout,configSpec.pxfConfig.poolCoreSize,configSpec.pxfConfig.poolQueueCapacity,configSpec.pxfConfig.poolMaxSize,configSpec.pxfConfig.xmx,configSpec.pxfConfig.xms", "configSpec": { "pxfConfig" : { "connectionTimeout": "<таймаут_для_запросов_на_чтение>", "uploadTimeout": "<таймаут_для_запросов_на_запись>", "maxThreads": "<максимальное_число_потоков_Apache_Tomcat®>", "poolAllowCoreThreadTimeout": <разрешен_ли_таймаут_для_стриминговых_потоков>, "poolCoreSize": "<количество_стриминговых_потоков>", "poolQueueCapacity": "<емкость_очереди_в_пул_за_стриминговыми_потоками>", "poolMaxSize": "<максимальное_число_стриминговых_потоков>", "xmx": "<максимальный_размер_JVM-кучи>", "xms": "<изначальный_размер_JVM-кучи>" } } }' ``` Где: * `updateMask` — перечень изменяемых параметров в одну строку через запятую. * `connectionTimeout` — таймаут подключения к серверу Apache Tomcat® во время выполнения запросов на чтение (в секундах). Диапазон значений: от `5` до `600`. * `uploadTimeout` — таймаут подключения к серверу Apache Tomcat® во время выполнения запросов на запись (в секундах). Диапазон значений: от `5` до `600`. * `maxThreads` — максимальное количество потоков Apache Tomcat®. Диапазон значений: от `1` до `1024`. Чтобы предотвратить ситуации, когда запросы зависают или не выполняются из-за перерасхода памяти или некорректной работы сборщика мусора Java, задайте количество потоков Apache Tomcat®. О регулировке числа потоков читайте в документации [VMware Greenplum® Platform Extension Framework](https://techdocs.broadcom.com/us/en/vmware-tanzu/data-solutions/tanzu-greenplum-platform-extension-framework/6-11/gp-pxf/cfg_mem.html). * `poolAllowCoreThreadTimeout` — разрешен ли таймаут для стриминговых потоков ядра приложения (core streaming threads). Значение по умолчанию: `false`. * `poolCoreSize` — количество стриминговых потоков ядра в пуле. Диапазон значений: от `1` до `1024`. * `poolQueueCapacity` — максимальное количество запросов, которое можно добавить в очередь в пул за стриминговыми потоками ядра. Диапазон значений: от нуля и выше. При значении `0` очередь в пул не образуется. * `poolMaxSize` — максимально допустимое количество стриминговых потоков ядра. Диапазон значений: от `1` до `1024`. * `xmx` — максимальный размер JVM-кучи для демона PXF (в мегабайтах). Диапазон значений: от `64` до `16384`. * `xms` — изначальный размер JVM-кучи для демона PXF (в мегабайтах). Диапазон значений: от `64` до `16384`. Идентификатор кластера можно запросить со [списком кластеров в каталоге](../cluster-list.md#list-clusters). 1. Убедитесь, что запрос был выполнен успешно, изучив [ответ сервера](../../api-ref/Cluster/update.md#yandex.cloud.operation.Operation). - gRPC API {#grpc-api} 1. [Получите IAM-токен для аутентификации в API](../../api-ref/authentication.md) и поместите токен в переменную среды окружения: ```bash export IAM_TOKEN="" ``` 1. Клонируйте репозиторий [cloudapi](https://github.com/yandex-cloud/cloudapi): ```bash cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi ``` Далее предполагается, что содержимое репозитория находится в директории `~/cloudapi/`. 1. Воспользуйтесь вызовом [ClusterService.Update](../../api-ref/grpc/Cluster/update.md) и выполните запрос, например, с помощью [gRPCurl](https://github.com/fullstorydev/grpcurl): {% note warning %} Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре `update_mask` (в виде массива строк `paths[]`). {% cut "Формат перечисления настроек" %} ```yaml "update_mask": { "paths": [ "<настройка_1>", "<настройка_2>", ... "<настройка_N>" ] } ``` {% endcut %} {% endnote %} ```bash grpcurl \ -format json \ -import-path ~/cloudapi/ \ -import-path ~/cloudapi/third_party/googleapis/ \ -proto ~/cloudapi/yandex/cloud/mdb/greenplum/v1/cluster_service.proto \ -rpc-header "Authorization: Bearer $IAM_TOKEN" \ -d '{ "cluster_id": "<идентификатор_кластера>", "update_mask": { "paths": [ "config_spec.pxf_config.connection_timeout", "config_spec.pxf_config.upload_timeout", "config_spec.pxf_config.max_threads", "config_spec.pxf_config.pool_allow_core_thread_timeout", "config_spec.pxf_config.pool_core_size", "config_spec.pxf_config.pool_queue_capacity", "config_spec.pxf_config.pool_max_size", "config_spec.pxf_config.xmx", "config_spec.pxf_config.xms" ] }, "config_spec": { "pxf_config" : { "connection_timeout": "<таймаут_для_запросов_на_чтение>", "upload_timeout": "<таймаут_для_запросов_на_запись>", "max_threads": "<максимальное_число_потоков_Apache_Tomcat®>", "pool_allow_core_thread_timeout": <разрешен_ли_таймаут_для_стриминговых_потоков>, "pool_core_size": "<количество_стриминговых_потоков>", "pool_queue_capacity": "<емкость_очереди_в_пул_за_стриминговыми_потоками>", "pool_max_size": "<максимальное_число_стриминговых_потоков>", "xmx": "<максимальный_размер_JVM-кучи>", "xms": "<изначальный_размер_JVM-кучи>" } } }' \ mdb.api.yandexcloud.kz:443 \ yandex.cloud.mdb.greenplum.v1.ClusterService.Update ``` Где: * `update_mask` — перечень изменяемых параметров в одну строку через запятую. * `connection_timeout` — таймаут подключения к серверу Apache Tomcat® во время выполнения запросов на чтение (в секундах). Диапазон значений: от `5` до `600`. * `upload_timeout` — таймаут подключения к серверу Apache Tomcat® во время выполнения запросов на запись (в секундах). Диапазон значений: от `5` до `600`. * `max_threads` — максимальное количество потоков Apache Tomcat®. Диапазон значений: от `1` до `1024`. Чтобы предотвратить ситуации, когда запросы зависают или не выполняются из-за перерасхода памяти или некорректной работы сборщика мусора Java, задайте количество потоков Apache Tomcat®. О регулировке числа потоков читайте в документации [VMware Greenplum® Platform Extension Framework](https://techdocs.broadcom.com/us/en/vmware-tanzu/data-solutions/tanzu-greenplum-platform-extension-framework/6-11/gp-pxf/cfg_mem.html). * `pool_allow_core_thread_timeout` — разрешен ли таймаут для стриминговых потоков ядра приложения (core streaming threads). Значение по умолчанию: `false`. * `pool_core_size` — количество стриминговых потоков ядра в пуле. Диапазон значений: от `1` до `1024`. * `pool_queue_capacity` — максимальное количество запросов, которое можно добавить в очередь в пул за стриминговыми потоками ядра. Диапазон значений: от нуля и выше. При значении `0` очередь в пул не образуется. * `pool_max_size` — максимально допустимое количество стриминговых потоков ядра. Диапазон значений: от `1` до `1024`. * `xmx` — максимальный размер JVM-кучи для демона PXF (в мегабайтах). Диапазон значений: от `64` до `16384`. * `xms` — изначальный размер JVM-кучи для демона PXF (в мегабайтах). Диапазон значений: от `64` до `16384`. Идентификатор кластера можно запросить со [списком кластеров в каталоге](../cluster-list.md#list-clusters). 1. Убедитесь, что запрос был выполнен успешно, изучив [ответ сервера](../../api-ref/grpc/Cluster/update.md#yandex.cloud.operation.Operation). {% endlist %} _Greenplum® и Greenplum Database® являются зарегистрированными товарными знаками или товарными знаками Broadcom Inc в США и/или других странах._