資料の 英語版 に戻る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 Refinery
- Decision Optimization
- ノートブック。 「コード・スニペット」 ペインの 「データの読み取り」 をクリックして、接続資格情報を取得し、データをデータ構造にロードします。 データ・ソース接続からのデータのロードを参照してください。
- SPSS Modeler
- Synthetic Data Generator
カタログ
- Platform assets catalog
Azure Cosmos DB のセットアップ
- Azure Cosmos DB のセットアップ: Azure portal
- Azure Cosmos DB のデータへのアクセスを保護: マスター鍵
制約事項
- Core (SQL) API のみがサポートされます。
- Azure Cosmos DB 接続の認証に Entra ID 認証情報を使用している場合、コレクション/コンテナの作成と削除がサポートされません。 既存のコレクションの一覧表示と変更のみがサポートされています。 詳細については、Azure Cosmos DB ドキュメントを参照してください。
SQL ステートメントの実行
SQL ステートメントが正しく実行されるようにするには、正しい構文について Azure Cosmos DB の資料 を参照してください。
詳細情報
親トピック: サポートされた接続