オンプレミスFAQ ​

Workatoのコネクションは、リクエストが実行される送信元を決定します。 直接コネクションリクエストはWorkatoサーバーから送信されます。 オンプレミスエージェントを使用するコネクションは、エージェントがインストールされているEnvironmentからリクエストを送信します。

オンプレミスエージェントのコネクションは、クラウドプロファイルとコネクションプロファイルの2つの方法で設定できます。 クラウドプロファイルを使用すると、Workato内でコネクションを直接設定できます。 コネクションプロファイルでは、オンプレミスエージェントの設定ファイルで手動設定が必要です。

クラウドプロファイルを使用すると、通常のコネクターと同様にWorkatoでコネクションを直接設定できます。 これにより、コネクションプロファイルで必要となるオンプレミスエージェントの設定ファイルを手動で開いて編集する必要がなくなります。

はい。すべてのデータベースコネクターには、クラウドプロファイルまたはコネクションプロファイルを使用してオンプレミスエージェント経由で接続するオプションがあります。

クラウドプロファイル: 使用する予定のオンプレミスグループをコネクションフィールドで選択する必要があります。

コネクションプロファイル: 使用する予定のオンプレミスグループをコネクションフィールドで選択する必要があります。 オンプレミスコネクションプロファイル名を入力し、オンプレミスエージェントのconfig.ymlファイル内の設定と一致していることを確認します。

クラウドプロファイルまたはコネクションプロファイルを使用してオンプレミスファイルシステムに接続できます:

クラウドプロファイル: オンプレミスファイルシステムに接続するには、オンプレミスエージェントを使用する必要があります。 コネクションフィールドで関連するオンプレミスグループを選択し、オンプレミスファイルシステムに必要なプロパティを指定する必要があります。

コネクションプロファイル: 関連するオンプレミスグループを選択し、オンプレミスコネクションプロファイル名を入力する必要があります。 この名前は、オンプレミスエージェントのconfig.ymlファイルのfilesセクション内の設定と一致している必要があります。

コネクションプロファイルでは、オンプレミスエージェントの設定ファイルにコネクション詳細を手動で入力する必要があります。 クラウドプロファイルでは、Workatoで直接設定できます。

エラー:

JDBC driver internal error: exception creating result java.lang.ExceptionInInitializerError at net.snowflake.client.jdbc.internal.apache.arrow.memory.ArrowBuf.getDirectBuffer(ArrowBuf.java:231).: XX000

カスタムSQLアクションの使用中にselectクエリを実行したとき、前述のSnowflakeエラーが表示される場合は、次のいずれかの方法で解決できます:

• コネクションURLに&JDBC_QUERY_RESULT_FORMAT=JSONを追加します（推奨）
• 古いSnowflake JDBCドライバーバージョン（例: 3.9.2）を使用します

エラー:

java.lang.ExceptionInInitializerError: Exception java.lang.RuntimeException: Failed to initialize MemoryUtil. [in thread "pool-21-thread-1"]

このエラーは、ドライバーがデータ転送にApache Arrowを使用していることが原因で発生する場合があります。 このエラーを解決するには、JDBC URLにEnableArrow=0を追加してApache Arrowを無効にします:

jdbc:spark://host.cloud.databricks.com:443/default;EnableArrow=0;

このパラメーター変更により初期化エラーが回避され、コネクションが成功します。

クラウドプロファイルは、Workatoでオンプレミスエージェント（OPA）のコネクションを設定する新しい方法で、OPAバージョン2.15.0で導入されました。 これにより、ローカルのオンプレミスエージェント設定ファイルを編集することなく、Workatoプラットフォーム内でオンプレミスコネクションを直接設定できます。

クラウドプロファイルは、次を含むさまざまなシステムタイプをサポートしています:

• データベース
• オンプレミスファイルシステム
• SAP
• Javaメッセージングサービス
• Apache Kafka
• Active Directory
• コマンドラインスクリプト

クラウドプロファイルを使用して新しいコネクションを作成すると、詳細は特定のオンプレミスグループ内のすべてのエージェントに自動的に伝播されます。 このプロセスは通常ほぼ即時に実行されますが、場合によっては、エージェントが更新されたコネクション詳細を受信するまでに時間がかかることがあります。

データベースクラウドコネクションプロファイルには、次を含む複数のプロパティを含めることができます:

• 名前
• URL/ホスト
• ポート
• データベース名
• ユーザー名
• パスワード
• SSL設定（オプション）

OPAのデータベースクラウドプロファイルは、次のデータベースをサポートしています:

• Amazon Redshift: デフォルトポート: 5439
• JDBC互換データベース:
  • Microsoft SQL Server: デフォルトポート: 1433
  • MySQL: デフォルトポート: 3306
  • Oracle: デフォルトポート: 1521
  • PostgreSQL: デフォルトポート: 5432

SAPコネクターは、2つのコネクションタイプをサポートしています:

• 直接コネクション
• Message Serverコネクション

SAPで使用されるデフォルトポートは、コネクションタイプと設定によって異なります。 デフォルトポートの詳細については、SAPクラウドプロファイルのドキュメントを参照してください。

クラウドプロファイルのオンプレミスエージェントは、次のJMSプロバイダーをサポートしています:

• Amazon Simple Queue Service
• Apache ActiveMQ
• Azure Service Bus

クラウドプロファイルを使用してAmazon SQSに接続するには、次のプロパティを設定する必要があります:

• 地域
• アクセスキー
• シークレットキー

ActiveMQブローカーを実行するために必要な唯一の手順は、ブローカーURLを指定することです。

クラウドプロファイルを使用してAzure Service Busに接続するには、次のプロパティを設定する必要があります:

• プロバイダー
• クラス
• リモートURI
• ユーザー名
• パスワード

コネクションプロファイルは、オンプレミスアプリケーションを一意に識別し、その情報を含むファイルです。 プロファイルは、<INSTALL_HOME>/conf/config.ymlにある設定ファイルに保存されます。

次を含むさまざまな種類のシステムに接続できます:

• データベース
• オンプレミスファイルシステム
• SAP
• Javaメッセージングサービス
• Apache Kafka
• Active Directory
• HTTPプロファイル
• NTLM
• コマンドラインスクリプト
• 拡張機能
• サーバー設定。

新しいコネクションプロファイルを適用する場合を含め、config.ymlに変更が加えられるたびにOPAを再起動する必要があります。 オンプレミスエージェントが変更を自動的に適用できるようにするには、config.ymlファイルの先頭にconfig: autoReload: trueを追加します。 有効にすると、config.ymlに加えられた変更はautoReloadによって取得され、手動で再起動する必要はありません。 autoReloadはサーバープロファイルに加えられた変更には適用されないことに注意してください。この場合は、OPAを手動で停止して開始する必要があります。

データベースコネクションプロファイルは、OPAがデータベースに接続するために使用する情報を提供します。 これらのプロファイルは、config.ymlファイルのdatabaseセクションにあります。 OPAは複数のデータベースへのコネクションをサポートしています。

OPAは、次を含むさまざまなデータベースをサポートしています:

• Amazon Redshift
• JDBC互換データベース:
  • Microsoft SQL Server
  • MySQL
  • Oracle
  • PostgreSQL

データベースコネクションプロファイルには、次のようなプロパティを含めることができます:

• アダプター
• URL
• ホスト
• ポート
• データベース名
• ユーザー名
• パスワード
• driverClass
• プールオプション
• SSL設定

オンプレミスファイルを操作するには、config.ymlのfilesセクションでファイルシステムプロファイルを定義します。 ファイルアクセス用のベースフォルダを指定する必要があります。

SAPコネクションプロファイルでは、ServerプロファイルとSAPセクションの両方を定義する必要があります。 ServerプロファイルにはSAP JCoコネクターライブラリの場所が含まれ、SAPセクションにはコネクションタイプ、ホスト、システム番号、プログラムIDなどの詳細が含まれます。

SAPコネクターはデフォルトポートを使用します。SAP Message Server経由のコネクションには36xx、SAPへの直接呼び出しには48xx（SNCあり）または33xx（SNCなし）などです。

HTTPプロファイルを使用すると、内部HTTPSリソースへのエージェントアクセスを設定できます。 次のようなプロパティを設定できます:

• connectTimeout
• keepAlive
• SSL設定

NTLMコネクションプロファイルは、NTLM認証を必要とする特定のHTTPリソースに使用されます。 auth、username、password、base_urlなどのプロパティを設定できます。

コマンドラインスクリプトプロファイルを使用すると、OPAでスクリプトまたはコマンドを実行できます。 スクリプトとパラメーターを定義し、コマンド実行プロパティを指定できます。

拡張機能プロファイルは、Java拡張機能を操作するために使用されます。 JavaクラスのcontrollerClassおよびsecretプロパティを含む、serverセクションとextensionsセクションを定義する必要があります。

Serverプロファイルは、OPAアセットがオンプレミスサーバー上のどこに配置されるかを定義します。 これらには、Javaクラスと一時ファイルストレージのディレクトリを指定するclasspathやstagingなどのプロパティを含めることができます。