データベースアクセス

PostgreSQL 8.4.1文書
前のページ | 巻戻し | 第 41章PL/Python - Python手続き言語 | 早送り | 次のページ

# 41.3. データベースアクセス

PL/Python言語モジュールは自動的に`plpy`というPythonモジュールをインポートします。 このモジュールの関数と定数は、`plpy.`foo``のように作成したPythonコードから使用することができます。 現在`plpy`では、`plpy.debug(`msg`)`、`plpy.log(`msg`)`、`plpy.info(`msg`)`、`plpy.notice(`msg`)`、`plpy.warning(`msg`)`、`plpy.error(`msg`)`、および`plpy.fatal(`msg`)`関数を実装しています。 `plpy.error`および`plpy.fatal`は、実際にPythonの例外を発生させます。 これが捕捉されない場合、呼び出し中の問い合わせ外部に伝わり、その結果、現在のトランザクションもしくは副トランザクションがアボートします。 `raise plpy.ERROR("msg")`および`raise plpy.FATAL("msg")`は、それぞれ`plpy.error`および`plpy.fatal`の呼び出しと同じです。 他のレベルは、異なる重要度のメッセージを生成するだけです。 log_min_messagesとclient_min_messages設定変数は、特定の重要度のメッセージをクライアントに報告するか、サーバのログに書き出すか、あるいはその両方かを制御します。 詳細は第18章を参照してください。

さらに、`plpy`モジュールは`execute`および`prepare`という2つの関数を用意しています。 `plpy.execute`を、問い合わせ文字列および省略可能な制限引数を付けて呼び出すと、問い合わせが実行され、結果オブジェクトとして問い合わせ結果が返ります。 この結果オブジェクトはリストもしくは辞書オブジェクトをエミュレートします。 結果オブジェクトは、行番号や列名によってアクセスすることができます。 結果オブジェクトには、問い合わせ結果の行数を返す`nrows()`、`SPI_execute`が返す値を返す`status`というメソッドが追加されています。 結果オブジェクトは、変更することができます。

以下に例を示します。

    rv = plpy.execute("SELECT * FROM my_table", 5)

これは、`my_table`から5行までを返します。 `my_table`に`my_column`列が存在する場合、その列には以下のようにアクセスできます。

    foo = rv[i]["my_column"]

2番目の関数`plpy.prepare`は、問い合わせの実行計画を準備します。 問い合わせ内にパラメータ参照がある場合、問い合わせ文字列および引数型のリストとともに呼び出されます。 例えば、以下のようにします。

    plan = plpy.prepare("SELECT last_name FROM my_users WHERE first_name = $1", [ "text" ])

`text`は、`$1`として渡す変数の型です。 文を準備した後、それを実行するために関数`plpy.execute`を使用します。

    rv = plpy.execute(plan, [ "name" ], 5)

3番目の引数は制限引数であり、省略可能です。

PL/Pythonモジュールを使用して準備した計画は自動的に保存されます。 これが何を意味するのかについてはSPIの文書（第42章）を参照してください。 これを複数呼び出しにおいて効果的に使用するためには、永続的な格納用辞書である`SD`または`GD`（項41.1を参照）のいずれかを使用する必要があります。 例えば、以下のようにします。

    CREATE FUNCTION usesavedplan() RETURNS trigger AS $$
        if SD.has_key("plan"):
            plan = SD["plan"]
        else:
            plan = plpy.prepare("SELECT 1")
            SD["plan"] = plan
        # rest of function
    $$ LANGUAGE plpythonu;

前のページ | ホーム | 次のページ
トリガ関数 | 上に戻る | サーバプログラミングインタフェース