# tCosmosDBSQLAPIOutput SQL APIを介して、前のコンポーネントからの入力フローに基づいてCosmosデータベースコレクションでドキュメントを挿入、更新、アップサート、削除します。 ## tCosmosDBSQLAPIOutputの標準プロパティ これらのプロパティは、標準ジョブのフレームワークで実行されているtCosmosDBSQLAPIOutputを設定するために使われます。 標準のtCosmosDBSQLAPIOutputコンポーネントは、データベースNoSQLファミリーに属しています。 このフレームワーク内のコンポーネントは、すべてのTalend製品で利用できます。 ## 基本設定 | [Properties] (プロパティ) | 説明 | | --- | --- | | [Property type] (プロパティタイプ) | [Built-in] (組み込み)と[Repository] (リポジトリー)のいずれかです。

| | [Edit Schema] (スキーマを編集) | スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。



このコンポーネントによって、コレクションにドキュメントを挿入する際にダイナミックスキーマがサポートされます。ダイナミックスキーマ機能を使用するためには、コレクションにパーティションキーが存在しないこと、そしてスキーマに含まれているカラムが1つだけであることを確認し、[DB column] (DBカラム)を\*に、そして[Type] (タイプ)を文字列に(入力タイプが文字列の場合)、またはオブジェクトに(入力タイプがオブジェクトの場合)に設定する必要があります。

情報メモ注:

| | URI | CosmosユーザーアカウントのURIを入力します。フィールドでプロンプトが表示されると、CosmosデータベースユーザーアカウントのURIはhttps://{アカウント名}.document.azure.com:443という形式になります。URIは、[Azure Portal]の[Keys] (キー)ペインで取得できます。関連情報は、[Create an Azure Cosmos DB account](https://docs.microsoft.com/en-us/azure/cosmos-db/create-cosmosdb-resources-portal)をクリックしてください。 | | [Primary key] (プライマリキー) | Cosmosユーザーアカウントのプライマリキーを入力します。プライマリキーは、[Azure Portal]の[Keys] (キー)ペインで取得できます。関連情報は、[Create an Azure Cosmos DB account](https://docs.microsoft.com/en-us/azure/cosmos-db/create-cosmosdb-resources-portal)をクリックしてください。

プライマリキーを入力するには、[Primary key] (プライマリキー)フィールドの横にある[...]ボタンをクリックし、[Enter a new password] (新しいパスワードを入力)ダイアログボックスを表示させ、テキストフィールドにプライマリキーを入力して[OK]をクリックします。プライマリキーは、[pure password] (純粋なパスワード)モードではJSON文字列で、[Java mode] (Javaモード)ではJava式として入力できます。テキストフィールドの上部にある[switch to Java mode] (Javaモードに切り替え)または[switch to pure password mode] (純粋なパスワードに切り替え)をクリックすることで、2つのモードの間で切り替えられます。

情報メモ注:

| | [Database ID] (データベースID) | データベースの名前を入力します | | [Collection ID] (コレクション ID) | コレクション名を入力します。 | | 存在しない場合はコレクションを作成します | このオプションをオンにすると、コレクションが存在しない場合にコレクションIDフィールドで指定されたコレクションを作成できます。このオプションは、[Data action] (データアクション)ドロップダウンリストから[Update] (アップデート)または[Delete] (削除)が選択されている場合に利用できます。 | | データのアクション | 次のいずれかのオプションを選択します。

| | Availability-note[Deprecated](https://help.talend.com/r/en-US/Cloud/labels-on-talend-help-center/availability-deprecated)

このコンテンツは非推奨になりました。

[Auto ID generation] (自動ID生成) | このオプションを選択すると、処理されるドキュメントのIDを生成できます。

情報メモ非推奨: 8.0.1-R2024-03マンスリーリリース以降、このオプションは非推奨です。 | ## 詳細設定 | [Properties] (プロパティ) | 説明 | | --- | --- | | [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、コンポーネントレベルでログデータを収集できます。 | | [Connection mode] (接続モード) | 使用する接続モードを指定します。GatewayとDirectHttpsの2つのオプションを利用できます。関連情報を参照するには、[ConnectionMode](https://docs.microsoft.com/en-us/java/api/com.microsoft.azure.cosmosdb.connectionmode?view=azure-java-legacy)をクリックしてください。 | | [Max connection pool size] (最大接続プールサイズ) | 最大接続プールサイズを設定するために使われます。デフォルトは1000です。 | | [Consistency level] (一貫性レベル) | 一貫性レベルを設定するために使われます。関連情報は、 [\[Consistency levels\] (一貫性レベル)](https://docs.microsoft.com/en-us/azure/cosmos-db/consistency-levels) をクリックしてください。 | | [Partition key] (パーティションキー) | ドキュメントを削除するパーティションのキーを入力します。パーティションキーには、Nullでない値が推奨されます。

8.0.1-R2024-03マンスリーリリースでは、3種類のパーティションキー(Boolean、Double、String )を入力できます。パーティションキーは3階層まで設定可能です。詳細は、Microsoftのドキュメンテーションで[Hierarchical partition keys in Azure Cosmos DB](https://learn.microsoft.com/en-us/azure/cosmos-db/hierarchical-partition-keys?tabs=java-v4%2Cbicep)をご覧ください。

このオプションは、[Create collection if not exist] (コレクションが存在しない場合は作成)チェックボックスが選択した場合に利用できます。 | ## [Global Variables] (グローバル変数) | 変数 | 説明 | | --- | --- | | ERROR\_MESSAGE | エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。 | | NB\_LINE | 処理された行数。これはAfter変数で、整数を返します。 | ## 使用方法 | 使用方法のガイダンス | 説明 | | --- | --- | | **使用ルール** | tCosmosDBSQLAPIOutput、ジョブ内の先行するコンポーネントからのフローをベースに、データベースのコレクションで定義されているアクションを実行します。 | | **認証付きHTTPSプロキシにおけるCosmos DBの制限事項** | HTTPプロキシとHTTPSプロキシはtSetProxyコンポーネントで動作しますが、次の点に注意してください。



追加の制限事項: プロキシ設定はグローバルなJVMシステムプロパティを通じて管理されるため、同じジョブ内で異なるコンポーネントに複数の異なるプロキシ設定を使用することは推奨されません。設定が意図したとおりに機能しない可能性があります。 |