SAP HANA

SAP HANA コネクタを使用すると、SAP HANA データベースに対して挿入、削除、更新、読み取りオペレーションを行うことができます。

サポート対象のバージョン

SAP HANA バージョン 2.0 SPS04 以降

始める前に

SAP Hana コネクタを使用する前に、次の作業を行います。

Google Cloud プロジェクトで次の操作を行います。
- ネットワーク接続が設定されていることを確認します。ネットワークパターンの詳細については、Network Connectivity をご覧ください。
- コネクタを構成するユーザーに roles/connectors.admin IAM ロールを付与します。
- コネクタに使用するサービスアカウントに、次の IAM ロールを付与します。
  - roles/secretmanager.viewer
  - roles/secretmanager.secretAccessor
  サービスアカウントは特別なタイプの Google アカウントで、Google API のデータにアクセスするのに認証を受ける必要がある人間以外のユーザーを表します。サービスアカウントがない場合は、サービスアカウントを作成する必要があります。詳細については、サービスアカウントを作成するをご覧ください。
- 次のサービスを有効にします。
  - secretmanager.googleapis.com（Secret Manager API）
  - connectors.googleapis.com（Connectors API）
  サービスを有効にする方法については、サービスを有効にするをご覧ください。
以前にプロジェクトでこうしたサービスを有効にしていない場合は、コネクタを構成するときにそれを有効にすることを求められます。

SAP HANA データベースの作成については、SAP HANA のクイックスタートをご覧ください。SAP HANA の詳細については、SAP HANA プラットフォームの概要をご覧ください。

コネクタを構成する

コネクタを構成するには、データソース（バックエンドシステム）への接続を作成する必要があります。接続はデータソースに特有です。つまり、多数のデータソースがある場合は、データソースごとに別々の接続を作成する必要があります。接続を作成する手順は次のとおりです。

Cloud コンソールで、[Integration Connectors] > [接続] ページに移動し、Google Cloud プロジェクトを選択または作成します。
[接続] ページに移動
[+ 新規作成] をクリックして [接続の作成] ページを開きます。
[ロケーション] セクションで、接続のロケーションを選択します。
1. リージョン: プルダウンリストからロケーションを選択します
  サポートされているすべてのリージョンの一覧については、ロケーションをご覧ください。
2. [NEXT] をクリックします。
[接続の詳細] セクションで、次の操作を行います。
1. コネクタ: 使用可能なコネクタのプルダウンリストから [SAP HANA] を選択します。
2. コネクタのバージョン: 使用可能なバージョンのプルダウンリストからコネクタのバージョンを選択します。
3. [接続名] フィールドに、接続インスタンスの名前を入力します。
  接続名は次の条件を満たす必要があります。
  - 接続名には英字、数字、ハイフンを使用できます。
  - 文字は小文字のみを使用できます。
  - 接続名の先頭には英字を設定し、末尾には英字または数字を設定する必要があります。
  - 接続名は 49 文字以内で指定してください。
4. 必要に応じて、接続インスタンスの [説明] を入力します。
5. 必要に応じて、Cloud Logging を有効にして、ログレベルを選択します。デフォルトのログレベルは Error に設定されています。
6. サービスアカウント: 必要なロールを持つサービスアカウントを選択します。
7. 必要に応じて、接続ノードの設定を構成します。
  - ノードの最小数: 接続ノードの最小数を入力します。
  - ノードの最大数: 接続ノードの最大数を入力します。
  ノードは、トランザクションを処理する接続の単位（またはレプリカ）です。1 つの接続でより多くのトランザクションを処理するには、より多くのノードが必要になります。逆に、より少ないトランザクションを処理するには、より少ないノードが必要になります。ノードがコネクタの料金に与える影響については、接続ノードの料金をご覧ください。値を入力しない場合は、デフォルトで最小ノード数は 2 に設定され（可用性を高めるため）、最大ノード数は 50 に設定されます。
8. データベース: SAP HANA データベースの名前。
9. BrowsableSchemas: このプロパティは、利用可能なスキーマのサブセットに報告されるスキーマを制限します。例: BrowsableSchemas=SchemaA,SchemaB,SchemaC。
10. システムオブジェクトを含める: IncludeSystemObjects を True に設定して、Hana システムスキーマとテーブルを取得します。
11. テーブルタイプを含める: true に設定すると、プロバイダは個々のテーブルおよびビューのタイプを報告します。
12. セッション変数: 現在の接続に設定するセッション変数のカンマ区切りのリスト。
13. 必要に応じて、[+ ラベルを追加] をクリックして Key-Value ペアの形式でラベルを接続に追加します。
14. [NEXT] をクリックします。
[宛先] セクションに、接続するリモートホスト（バックエンドシステム）の詳細を入力します。
1. 宛先の種類: 宛先の種類を選択します。
  - リストから [ホストアドレス] を選択し、宛先のホスト名または IP アドレスを指定します。
  - バックエンドシステムへのプライベート接続を確立する場合は、リストからエンドポイントアタッチメントを選択し、次にエンドポイントアタッチメントリストから必要なエンドポイントアタッチメントを選択します。
    注: エンドポイントアタッチメントの作成方法については、PSC サービスアタッチメントとエンドポイントアタッチメントをご覧ください。エンドポイントアタッチメントを作成すると、[エンドポイントアタッチメント] リストに表示されます。
  セキュリティをさらに強化してバックエンドシステムへのパブリック接続を確立する場合は、接続用の静的アウトバウンド IP アドレスの構成を検討してから、特定の静的 IP アドレスのみを許可リストに登録するようファイアウォールルールを構成します。
  
  他の宛先を入力するには、[+ 宛先を追加] をクリックします。
2. [NEXT] をクリックします。
[認証] セクションで、認証の詳細を入力します。
1. [認証タイプ] を選択し、関連する詳細を入力します。
  SAP HANA 接続でサポートされる認証タイプは、次のとおりです。
  - ユーザー名とパスワードを指定する
2. [NEXT] をクリックします。
Review: 接続と認証の詳細を確認します。
[作成] をクリックします。

認証を構成する

使用する認証に基づいて詳細を入力します。

ユーザー名とパスワード
- ユーザー名: コネクタのユーザー名
- パスワード: コネクタに関連付けられたパスワードを含む Secret Manager の Secret。

基本認証接続タイプ

次の表に、基本認証接続タイプのサンプル構成値を示します。必須フィールドと省略可能なフィールドについては、コンソールの接続作成インターフェースをご覧ください。

フィールド名	詳細
ロケーション	us-central1
コネクタ	SAP HANA
コネクタのバージョン	1
接続名	sap-hana-db-conn
Cloud Logging を有効にする	○
サービスアカウント	SERVICE_ACCOUNT_NAME@serviceaccount
データベース	S19
BrowsableSchemas	GOOGLEUSER
テーブルタイプを含める	○
詳細ログを有効にする	5
ノードの最小数	2
ノードの最大数	50
宛先の種類	ホストアドレス
host 1	192.0.2.0/24
port 1	31015
ユーザー名	ユーザー名
パスワード	パスワード
シークレットのバージョン	1

エンティティ、オペレーション、アクション

すべての Integration Connectors が、接続されたアプリケーションのオブジェクトを抽象化するレイヤを提供します。アプリケーションのオブジェクトには、この抽象化を通じてのみアクセスできます。抽象化は、エンティティ、オペレーション、アクションとして公開されます。

エンティティ: エンティティは、接続されているアプリケーションやサービスのオブジェクト、またはプロパティのコレクションと考えることができます。エンティティの定義は、コネクタによって異なります。たとえば、データベースコネクタでは、テーブルがエンティティであり、ファイルサーバーコネクタでは、フォルダがエンティティです。また、メッセージングシステムコネクタでは、キューがエンティティです。
ただし、コネクタでいずれのエンティティもサポートされていない、またはエンティティが存在しない可能性があります。その場合、Entities リストは空になります。
オペレーション: エンティティに対して行うことができるアクティビティです。エンティティに対して次のいずれかのオペレーションを行うことができます。
- リスト
- 取得
- 作成
- 更新
- 削除
使用可能なリストからエンティティを選択すると、そのエンティティで使用可能なオペレーションのリストが生成されます。オペレーションの詳細については、コネクタタスクのエンティティオペレーションをご覧ください。ただし、コネクタがいずれかのエンティティオペレーションをサポートしていない場合、サポートされていないオペレーションは Operations リストに含まれません。
アクション: コネクタインターフェースを介して統合で使用できる主要な関数の一つです。アクションを使用すると、1 つまたは複数のエンティティに対して変更を加えることができます。また、使用できるアクションはコネクタごとに異なります。通常、アクションには入力パラメータと出力パラメータがあります。ただし、コネクタがどのアクションもサポートしていない可能性があります。その場合は、Actions リストが空になります。

アクション

このセクションには、コネクタでサポートされているアクションが一覧表示されます。アクションの構成方法については、アクションの例をご覧ください。

EMPLOYEE_PROCEDURE_HANA アクション

このアクションは、ID のデータを返します。

EMPLOYEE_PROCEDURE_HANA アクションの入力パラメータ

パラメータ名	データ型	必須	説明
ID	整数	True	プロシージャで渡す必要があるタイプ ID

EMPLOYEE_PROCEDURE_HANA アクションの構成例については、例をご覧ください。

ExecuteCustomQuery アクション

このアクションにより、特定のタスクを実行できます。たとえば、HANADB ではカスタム SQL クエリを実行できます。

ExecuteCustomQuery アクションの入力パラメータ

パラメータ名	データ型	必須	説明
クエリ	文字列	True	実行する必要があるクエリ文字列。
queryParameters	配列、Null	True	順番に渡すクエリパラメータ。
maxRows	数値、null	False	返される行の最大数。
timeout	数値、null	False	クエリの実行を待機する秒数。

ExecuteCustomQuery アクションの構成例については、例をご覧ください。

アクションの例

例 - EMPLOYEE_PROCEDURE_HANA

[Configure connector task] ダイアログで、[Actions] をクリックします。
[EMPLOYEE_PROCEDURE_HANA] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"ID":1
}
```

アクションが成功すると、EMPLOYEE_PROCEDURE_HANA タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 [{
"EMP_ID": 1.0,
"NAME": "Komal",
"CITY": "UP",
"SALARY": 7500.0,
"DEPARTMENT": "IT" 
}]

例 - ExecuteCustomQuery Join_GroupBy

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "SELECT CUSTOMER.COMPANY, SUM(ORDERS.AMOUNT) AS Total
FROM ORDERS
INNER JOIN CUSTOMER
ON ORDERS.CUSTOMER_ID = CUSTOMER.ID
GROUP BY CUSTOMER.COMPANY"
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
"COMPANY": "google India",
"TOTAL": 1560.0
},{
"COMPANY": "IBM India",
"TOTAL": 4500.0
}]

例 - ExecuteCustomQuery 結合

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "SELECT ID, NAME, AGE, AMOUNT FROM CUSTOMERS JOIN ORDERS ON CUSTOMERS.ID = ORDERS.CUSTOMER_ID"
  }]
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "ID": 3.0,
  "NAME": "Kaushik",
  "AGE": 23.0,
  "AMOUNT": 3000.0
}, {
  "ID": 3.0,
  "NAME": "Kaushik",
  "AGE": 23.0,
  "AMOUNT": 1500.0
}, {
  "ID": 2.0,
  "NAME": "Khilan",
  "AGE": 25.0,
  "AMOUNT": 1560.0
}, {
  "ID": 4.0,
  "NAME": "Chaitali",
  "AGE": 25.0,
  "AMOUNT": 2060.0
}]

例 - ExecuteCustomQuery Groupby_Having_Count

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "SELECT COUNT(ID), CITY FROM GCP_HANA_CUSTOM GROUP BY CITY HAVING COUNT(ID) > 1"
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 [{
  "COUNT(ID)": 2.0,
  "CITY": "Delhi"
}]

例 - ExecuteCustomQuery GroupBy

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "SELECT COUNT(ID), CITY FROM GCP_HANA_CUSTOM GROUP BY CITY"
}
```

この例では、ExecuteCustomQuery レコードを更新します。アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "COUNT(ID)": 1.0,
  "CITY": "Kolkata"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Katihar"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Bangalore"
}, {
  "COUNT(ID)": 2.0,
  "CITY": "Delhi"
}]

例 - ExecuteCustomQuery GroupBy_OrderBy

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "SELECT COUNT(ID), CITY FROM GCP_HANA_CUSTOM GROUP BY CITY ORDER BY COUNT(ID) DESC"
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "COUNT(ID)": 2.0,
  "CITY": "Delhi"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Kolkata"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Bangalore"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Katihar"
}]

例 - ExecuteCustomQuery Insert_Table

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "INSERT INTO CUSTOMER VALUES (3, 'IBM India')"
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
}]

例 - ExecuteCustomQuery SUM_AggFunc

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "SELECT SUM(SALARY) FROM CUSTOMERS"
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 [{
"SUM(SALARY)": 12000.0
}]

例 - ExecuteCustomQuery AVG_AggFunc

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "SELECT AVG(SALARY) FROM CUSTOMERS"
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
"AVG(SALARY)": 3000.0
}]

例 - ExecuteCustomQuery MAX_AggFunc

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "SELECT MAX(SALARY) FROM CUSTOMERS"
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 [{
"MAX(SALARY)": 6500.0
}]

例 - ExecuteCustomQuery MIN_AggFunc

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "SELECT MIN(SALARY) FROM CUSTOMERS"
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
"MIN_SALARY": 1500.0
}]

例 - ExecuteCustomQuery COUNT_AggFunc

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "SELECT COUNT(*) FROM CUSTOMERS"
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
"COUNT(*)": 4.0
}]

例 - ExecuteCustomQuery CreateTable

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "CREATE TABLE CUSTOMER (ID INT NOT NULL,COMPANY VARCHAR (20))"
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
}]

例 - ExecuteCustomQuery AlterTable

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "ALTER TABLE GCP_HANA_CUSTOM ADD CONSTRAINT test PRIMARY KEY (ID)"
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
}]

例 - ExecuteCustomQuery TruncateTable

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "TRUNCATE TABLE GCP_HANA_RENAME"
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
}]

例 - ExecuteCustomQuery DropTable

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "DROP TABLE GCP_HANA_DROP"
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
}]

例 - ExecuteCustomQuery RenameTable

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "RENAME TABLE GCP_HANA_CUSTOM1 TO GCP_HANA_RENAME"
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
}]

例 - ExecuteCustomQuery UpdateTable

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "UPDATE CUSTOMERS SET ADDRESS = 'Pune' WHERE ID = 3"
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
}]

例 - ExecuteCustomQuery SELECT_DATA_Table

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "SELECT * FROM CUSTOMERS"
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "ID": 1.0,
  "NAME": "Ramesh",
  "AGE": 32.0,
  "ADDRESS": "Ahmedabad",
  "SALARY": 2000.0
}, {
  "ID": 2.0,
  "NAME": "Khilan",
  "AGE": 25.0,
  "ADDRESS": "Delhi",
  "SALARY": 1500.0
}, {
  "ID": 4.0,
  "NAME": "Chaitali",
  "AGE": 25.0,
  "ADDRESS": "Mumbai",
  "SALARY": 6500.0
}]

例 - ExecuteCustomQuery DeleteTable

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ExecuteCustomQuery] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"query": "DELETE FROM CUSTOMERS WHERE ID = 3"
}
```

アクションが成功すると、ExecuteCustomQuery タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
}]

エンティティオペレーションの例

このセクションでは、このコネクタでエンティティオペレーションの一部を実行する方法について説明します。

例 - 全従業員を一覧表示する

この例では、Employee エンティティ内のすべての従業員を一覧表示します。

[Configure connector task] ダイアログで、[Entities] をクリックします。
Entity から Employee を選択します。
[List] オペレーションを選択し、[完了] をクリックします。
必要に応じて、コネクタタスクの [タスク入力] セクションでフィルタ句を指定して、結果セットをフィルタリングできます。フィルタ句の値は常に単一引用符（'）内で指定します。例: City='Bangalore'。論理演算子を使用して複数のフィルタ条件を指定することもできます。例: City='Bangalore' and region='asia-south2'。

例 - レコードを取得する

この例では、Employee エンティティから、指定した ID のレコードを取得します。

[Configure connector task] ダイアログで、[Entities] をクリックします。
Entity から Employee を選択します。
[Get] オペレーションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで [EntityId] をクリックし、[デフォルト値] フィールドに 12294 を入力します。
ここで、12294 は Employee エンティティの主キー値です。

例 - `Hana_unicode` にレコードを作成する

この例では、Hana_unicode エンティティにレコードを作成します。

[Configure connector task] ダイアログで、[Entities] をクリックします。
Entity から Hana_unicode を選択します。
[Create] オペレーションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"ID": 2.0,
"UNICODEDATA": "Unicode データ型はグローバル化されたデータの保存に使用されます",
"TEST": "Test7"
}
```
統合に成功すると、コネクタタスクの connectorOutputPayload フィールドの値は次のようになります。
```
{
"ID": 2.0,
"UNICODEDATA": "Unicode データ型はグローバル化されたデータの保存に使用されます",
"TEST": "Test7"
}
```

例 - `Languages` にレコードを作成する

この例では、Languages エンティティにレコードを作成します。

[Configure connector task] ダイアログで、[Entities] をクリックします。
Entity から Languages を選択します。
[Create] オペレーションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"ID": 5,
"ARABICTEXT": "مرحبا",
"GERMANTEXT": "Günther",
"HINDITEXT": "नमस्ते",
"ENGLISHTEST": "Test1"
}
```
統合に成功すると、コネクタタスクの connectorOutputPayload フィールドの値は次のようになります。
```
{
"ID": 5.0,
"ARABICTEXT": "مرحبا",
"GERMANTEXT": "Günther",
"HINDITEXT": "नमस्ते",
"ENGLISHTEST": "Test1"
}
```

例 - レコードを更新する

この例では、Employee エンティティにレコードを作成します。

[Configure connector task] ダイアログで、[Entities] をクリックします。
Entity から Employee を選択します。
[Update] オペレーションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"SALARY": 9000.0
}
```
[エンティティ ID] をクリックし、[デフォルト値] フィールドに「12294」と入力します。
統合に成功すると、コネクタタスクの connectorOutputPayload フィールドの値は次のようになります。
```
{
"SALARY": 9000.0
}
```

例 - レコードを削除する

この例では、Employee エンティティ内の指定された ID のレコードを削除します。

[Configure connector task] ダイアログで、[Entities] をクリックします。
Entity から Employee を選択します。
[Delete] オペレーションを選択してから、[完了] をクリックします。
[コネクタタスクの [タスク入力 セクションで [entityId] をクリックし、[デフォルト値] フィールドに 10001 を入力します。

Terraform を使用して接続を作成する

Terraform リソースを使用して、新しい接続を作成できます。

Terraform 構成を適用または削除する方法については、基本的な Terraform コマンドをご覧ください。

接続作成用の Terraform テンプレートのサンプルを表示するには、サンプルテンプレートをご覧ください。

Terraform を使用してこの接続を作成する場合は、Terraform 構成ファイルで次の変数を設定する必要があります。

パラメータ名	データ型	必須	説明
データベース	STRING	False	SAP HANA データベースの名前。
browsable_schemas	STRING	False	このプロパティは、利用可能なスキーマのサブセットに報告されるスキーマを制限します。例: BrowsableSchemas=SchemaA,SchemaB,SchemaC。
include_system_objects	BOOLEAN	False	IncludeSystemObjects を True に設定して、Hana システムスキーマとテーブルを取得します。
include_table_types	BOOLEAN	False	true に設定した場合、プロバイダは個々のテーブルとビューのタイプを報告します。
session_variables	STRING	False	現在の接続に設定するセッション変数のカンマ区切りのリスト。
enable_logging	ENUM	False	1（最も詳細ではない）から 5（最も詳細）のいずれかを選択することで、接続中のログの詳細度を有効にします。この機能は、エラーメッセージなどの予期しない動作のトラブルシューティングに役立ちます。ただし、このオプションを使用すると、コネクタとバックエンド間のすべての通信の詳細（リクエスト、レスポンス、SSL 証明書など）がログに記録されます。そのため、本番環境でこの機能を使用することはおすすめしません。サポートされている値: 1、2、3、4、5。

統合で SAP HANA 接続を使用する

接続を作成すると、Apigee Integration と Application Integration の両方で使用できるようになります。この接続は、コネクタタスクを介して統合で使用できます。

Apigee Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。
Application Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。

Google Cloud コミュニティの助けを借りる

Google Cloud コミュニティの Cloud フォーラムで質問を投稿したり、このコネクタについてディスカッションしたりできます。

SAP HANA

サポート対象のバージョン

始める前に

コネクタを構成する

認証を構成する

基本認証接続タイプ

エンティティ、オペレーション、アクション

アクション

EMPLOYEE_PROCEDURE_HANA アクション

EMPLOYEE_PROCEDURE_HANA アクションの入力パラメータ

ExecuteCustomQuery アクション

ExecuteCustomQuery アクションの入力パラメータ

アクションの例

例 - EMPLOYEE_PROCEDURE_HANA

例 - ExecuteCustomQuery Join_GroupBy

例 - ExecuteCustomQuery 結合

例 - ExecuteCustomQuery Groupby_Having_Count

例 - ExecuteCustomQuery GroupBy

例 - ExecuteCustomQuery GroupBy_OrderBy

例 - ExecuteCustomQuery Insert_Table

例 - ExecuteCustomQuery SUM_AggFunc

例 - ExecuteCustomQuery AVG_AggFunc

例 - ExecuteCustomQuery MAX_AggFunc

例 - ExecuteCustomQuery MIN_AggFunc

例 - ExecuteCustomQuery COUNT_AggFunc

例 - ExecuteCustomQuery CreateTable

例 - ExecuteCustomQuery AlterTable

例 - ExecuteCustomQuery TruncateTable

例 - ExecuteCustomQuery DropTable

例 - ExecuteCustomQuery RenameTable

例 - ExecuteCustomQuery UpdateTable

例 - ExecuteCustomQuery SELECT_DATA_Table

例 - ExecuteCustomQuery DeleteTable

エンティティ オペレーションの例

例 - 全従業員を一覧表示する

例 - レコードを取得する

例 - Hana_unicode にレコードを作成する

例 - Languages にレコードを作成する

例 - レコードを更新する

例 - レコードを削除する

Terraform を使用して接続を作成する

統合で SAP HANA 接続を使用する

Google Cloud コミュニティの助けを借りる

次のステップ

エンティティオペレーションの例

例 - `Hana_unicode` にレコードを作成する

例 - `Languages` にレコードを作成する