Installing Analytics Accelerator
================================

Postgres Analytics
AcceleratorPGAAを使用するには、Postgresインスタンスに拡張機能をインストールし、クエリエンジンのバックグラウンドワーカーを有効にする必要があります。サポートされているプラットフォームの完全なリストについては、
:ref:`Analytics Accelerator compatibility <Analytics Accelerator compatibility>` を参照してください。

パッケージのダウンロードとインストール
--------------------------------------

EDBリポジトリからパッケージをダウンロードします。

.. code:: shell

   export EDB_SUBSCRIPTION_TOKEN=<your-token>
   export EDB_SUBSCRIPTION_PLAN=<your-subscription-plan>
   curl -1sSLf "https://downloads.enterprisedb.com/$EDB_SUBSCRIPTION_TOKEN/$EDB_SUBSCRIPTION_PLAN/setup.deb.sh" | sudo -E bash
   sudo apt-get install -y <postgresql-distribution>-pgaa

.. code:: shell

   export EDB_SUBSCRIPTION_TOKEN=<your-token>
   EDB_SUBSCRIPTION_PLAN=<your-subscription-plan>
   curl -1sSLf "https://downloads.enterprisedb.com/$EDB_SUBSCRIPTION_TOKEN/$EDB_SUBSCRIPTION_PLAN/setup.rpm.sh" | sudo -E bash
   sudo dnf install -y <postgresql-distribution>-pgaa

どこで

- ``$EDB_SUBSCRIPTION_TOKEN``
  は、EDBサブスクリプションの登録時に受け取ったトークンです。

- ``$EDB_SUBSCRIPTION_PLAN`` は、 ``standard`` PGEまたはCommunity
  Postgresの場合または\ ``enterprise`` EPASの場合。

- ``<postgresql-distribution>`` は、 Postgresディストリビューション
  ``edb-postgresextended`` 、\ ``edb-as`` 、または\ ``postgres``
  とバージョンを指定します。

拡張機能の有効化
----------------

PGAAを初期化するには、\ ``postgresql.conf``
ファイルを更新する必要があります。 ``pgaa``
を\ ``shared_preload_libraries``
に追加すると、PostgresはバックグラウンドワーカーとしてSeafowlクエリエンジンのライフサイクルを管理できます。

1. ``postgresql.conf`` を編集します。

.. code:: ini

       shared_preload_libraries = pgaa
       pgaa.autostart_seafowl = on

1. Postgresサービスを再起動して、新しいライブラリをロードします。

2. Postgresインスタンスにログインします。これが新規インストールであるか更新であるかに応じて、適切なコマンドを実行します。

- 新規インストールの場合

.. code:: sql

           CREATE EXTENSION IF NOT EXISTS pgaa CASCADE;

``CASCADE`` を使用すると、Postgresファイルシステム ``PGFS``
などの必要な依存関係が自動的にインストールされます。

- 既存のインストールをアップグレードする場合

.. code:: sql

           ALTER EXTENSION pgaa UPDATE;

インストールの検証
------------------

``\dx``
メタコマンドまたはversionファンクションを呼び出して、拡張機能がアクティブであることを確認します。

.. code:: sql

   SELECT pgaa.pgaa_version();

インストールしたら、
:ref:`Configuring storage locations <Configuring storage locations>` してデータレイクへのPGAAアクセスを付与したり、 Postgres
:ref:`Integrating with Iceberg catalogs <Integrating with Iceberg catalogs>` を統合したりできます。

例

寄木細工ファイルをポイントします。

.. code:: sql

   SELECT pgaa.test_storage_location (my-storage-location, false);

ファンクションは、成功すると\ ``NULL`` を返します。