資料の 英語版 に戻るMicrosoft Azure Cosmos DB 接続
Microsoft Azure Cosmos DB 接続
最終更新: 2024年11月28日
Microsoft Azure Cosmos DB 内のデータにアクセスするには、そのデータ用の接続資産を作成します。
Azure Cosmos DB は、フルマネージド NoSQL データベース・サービスです。
Microsoft Azure Cosmos DB への接続を作成します
接続資産を作成するには、以下の接続の詳細が必要です:
- ホスト名
- ポート番号
- マスター・キー: Azure Cosmos Database のプライマリー読み取り/書き込みキー
注: エントラID認証の前提条件:
Microsoft Entra IDは、クラウドベースのIDおよびアクセス管理サービスである。 Entra ID 認証方式の接続値を取得するには、Microsoft Azure ポータルにサインインして、ストレージアカウントに移動します。 Microsoft Entra IDについては、MicrosoftのEntra IDとはを参照してください。
Entra ID クライアント秘密鍵資格情報
- テナントID : Microsoft Entra テナント ID。 テナントIDを確認するには、 Microsoft Entra ID>プロパティ。 下にスクロールしてテナントID分野。 詳細については、 Microsoft Entra テナント ID を見つける方法。
- Client ID: Microsoft Azure Cosmos DBへのアクセスを認可するためのクライアントID。 アプリケーションのクライアントIDを見つけるには、マイクロソフト エントラ ID 。 からアプリ登録、アプリケーションを選択します。 クリックコピーアプリケーションのクライアント ID をコピーします。 詳細については、 Microsoft Entra アプリを登録し、サービス プリンシパルを作成する。
- クライアントシークレット: Microsoft Azure Cosmos DBへのアクセスを認証するためのクライアントIDに関連付けられた認証キー。 アプリケーションのクライアントシークレットを見つけるには、マイクロソフト エントラ ID 。 からアプリ登録、アプリケーションを選択します。 へ移動証明書とシークレット > クライアント シークレット。 クリックコピー既存のクライアントシークレットをコピーするか、新しいクライアントシークレット新しいクライアントシークレットを作成し、それをコピーします。 詳細については、 Microsoft Entra アプリを登録し、サービス プリンシパルを作成する。
- ストレージ アカウント URL : ストレージ アカウントの URL。
Entra ID ユーザー名パスワード資格情報
- クライアントID: Microsoft Azure Cosmos DBへのアクセスを認可するためのクライアントID。 アプリケーションのクライアントIDを見つけるには、マイクロソフト エントラ ID 。 からアプリ登録、アプリケーションを選択します。 クリックコピーアプリケーションのクライアント ID をコピーします。 詳細については、 Microsoft Entra アプリを登録し、サービス プリンシパルを作成する。
- ユーザー名とパスワードです:Microsoft Azure Cosmos DBアカウントのユーザー名とパスワード。 多要素認証なしでアクセスするには許可が必要です。
- ストレージ アカウント URL : ストレージ アカウントの URL。
プライベート接続の場合、インターネットに外部化されていないデータベース (例えば、ファイアウォールの内側) に接続するには、 セキュア接続をセットアップする必要があります。
プラットフォーム内の場所に基づいて接続を作成する方法を選択してください
- プロジェクト内
- 「アセット」>「新規アセット」>「データ・ソースへの接続」をクリックします。 プロジェクトへの接続の追加を参照してください。
- カタログ内
- 「カタログに追加」>「接続」をクリックしてください。 カタログへの接続資産の追加を参照してください。
- デプロイメント・スペース内
- 「アセットのインポート」>「データ・アクセス」>「接続」をクリックします。 デプロイメント・スペースへのデータ資産の追加を参照してください。
- Platform assets catalog
- 新規接続をクリックしてください。 プラットフォーム接続の追加を参照してください。
次のステップ: 接続からデータ資産を追加する
プロジェクトでの接続からのデータの追加を参照してください。
カタログ内の接続からのデータの追加を参照してください。
この接続を使用できる場所
Microsoft Azure Cosmos DB 接続は、以下のワークスペースおよびツールで使用できます:
プロジェクト
- Data Refinerywatsonx.aiStudio またはIBM Knowledge Catalog
- DataStage (DataStage サービス)。 DataStageでのデータ・ソースへの接続を参照してください。
- Decision Optimizationwatsonx.aiStudio およびwatsonx.aiRuntime)
- ノートブックwatsonx.aiStudio)。 「コード・スニペット」 ペインの 「データの読み取り」 をクリックして、接続資格情報を取得し、データをデータ構造にロードします。 データ・ソース接続からのデータのロードを参照してください。
- SPSS Modelerwatsonx.aiStudio)
カタログ
Platform assets catalog
その他のカタログ(IBM Knowledge Catalog)
Azure Cosmos DB のセットアップ
- Azure Cosmos DB のセットアップ: Azure portal
- Azure Cosmos DB のデータへのアクセスを保護: マスター鍵
制限
- コア (SQL) API のみがサポートされます。
- Azure Cosmos DB 接続の認証に Entra ID 認証情報を使用している場合、コレクション/コンテナの作成と削除がサポートされません。 既存のコレクションの一覧表示と変更のみがサポートされています。 詳細については、Azure Cosmos DB ドキュメントを参照してください。
SQL ステートメントの実行
SQL ステートメントが正しく実行されるようにするには、正しい構文について Azure Cosmos DB の資料 を参照してください。
もっと見る
親トピック: サポートされた接続