自律型AIデータベースでのWITH_CONTEXTを使用したPythonスクリプトの起動

WITH_CONTEXT属性を指定したOracle Schedulerジョブを使用して、Autonomous AI DatabaseインスタンスでPythonスクリプトを実行できます。

Pythonスクリプトの作成例を示します

• 例: データベースに表を作成するPythonスクリプト。

  #!/usr/bin/env python1
  
  import oracledb
  import utils
   def gsf_main(argc, argv):
      table_name = argv[0]
      table_pk = argv[1]
      print(f"Total number of args: {argc}")
      print(f"Arg1: {table_name}")
      print(f"Arg2: {table_pk}")
      print(f"Arg3: {argv[2]}")
      print(f"Arg4: {argv[3]}")
      print(f"Arg5: {argv[4]}")
       
      # Step 1: Get connection object
      con = utils.getconnection()
      if con is None:
          print("Failed to establish database connection.")
          return -1
        try:
          # Step 2: Create a table
          cur = con.cursor()
          create_table_query = f"""
              CREATE TABLE {table_name} (
                  employee_id NUMBER GENERATED ALWAYS AS IDENTITY (START WITH 1 INCREMENT BY 1),
                  employee_name VARCHAR2(4000),
                  employee_age NUMBER,
                  CONSTRAINT {table_pk} PRIMARY KEY (employee_id)
              )
              """
          cur.execute(create_table_query)
      except Exception as e:
          print(f"Error performing operations: {e}")
          return -1
      finally:
          if cur:
              cur.close()

  この例では、python1.pyスクリプトを作成します。このスクリプトは、スケジューラ・ジョブからの引数を受け入れるPython関数gsf_main(argc, argv)を定義し、指定された属性を使用してデータベースに表を作成し、例外を処理します。

  oracledbドライバを使用すると、スクリプトをデータベースに接続できます。

  utilsパッケージは、データベース接続を取得するためのヘルパー関数getconnection()を提供します。

詳細は、Pythonのドキュメントを参照してください。

Oracle Autonomous AI Database EXTPROCコンテナ・イメージを取得および構成するステップについて説明します。

自己署名ウォレットは、Autonomous AI Database EXTPROCエージェント・アプリケーションの作成の一部として作成されます。このウォレットを使用すると、Extrpocエージェント・インスタンスにアクセスできます。

1. EXTPROCエージェント・インスタンスの証明書を含むウォレットcwallet.ssoを、オブジェクト・ストレージからAutonomous AIデータベースにインポートします。ウォレット・ファイルについて次の点に注意してください。

   • ウォレット・ファイルは、データベース・ユーザーIDとパスワードとともに、EXTPROCエージェント・インスタンスへのアクセスを提供します。ウォレット・ファイルを安全な場所に格納し、認可されたユーザーのみと共有します。

   • ウォレット・ファイルの名前を変更しないでください。オブジェクト・ストレージのウォレット・ファイルには、cwallet.ssoという名前を付ける必要があります。

2. 資格証明を作成して、ウォレット・ファイルcwallet.ssoを格納するオブジェクト・ストレージにアクセスします。様々なオブジェクト・ストレージ・サービスのusernameおよびpasswordパラメータの詳細は、「CREATE_CREDENTIALプロシージャ」を参照してください。
   リソース・プリンシパル資格証明を有効にする場合、Oracle Cloud Infrastructureオブジェクト・ストアにアクセスするための資格証明の作成は必要ありません。詳細は、リソース・プリンシパルを使用したOracle Cloud Infrastructureリソースへのアクセスについてを参照してください。
3. ウォレット・ファイルcwallet.ssoのディレクトリをAutonomous AI Databaseに作成します。

   CREATE DIRECTORY wallet_dir AS 'directory_location';

   ディレクトリの作成の詳細は、Autonomous AI Databaseでのディレクトリの作成を参照してください。

4. DBMS_CLOUD.GET_OBJECTを使用して、ウォレットのアップロードを行います。たとえば:

   BEGIN
     DBMS_CLOUD.GET_OBJECT (
       credential_name     => 'DEF_CRED_NAME',
       object_uri          => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/cwallet.sso',
       directory_name      => 'WALLET_DIR'
   );
   END;
   /

   この例では、namespace-stringはOracle Cloud Infrastructure Object Storageネームスペースで、bucketnameはバケット名です。詳細は、「オブジェクト・ストレージ・ネームスペース」を参照してください。

   ウォレットは、前のステップWALLET_DIRで作成したディレクトリにコピーされます。EXTPROCエージェント・インスタンスに接続できるウォレットが、Autonomous AI Databaseインスタンスで使用できるようになりました。

自律型AIデータベースでPythonスクリプトを起動するステップを示します。

• Autonomous AI Databaseでのリモート・エンドポイントの登録および管理
  ADMINユーザーとして、次のステップを実行して、Autonomous AI Databaseでリモート・エンドポイントを登録および管理します。
• Pythonスクリプトを起動するスケジューラ・ジョブの作成と管理
  Autonomous AI DatabaseからPythonスクリプトを起動するスケジューラ・ジョブを作成および管理するステップを示します。