LINQ を使ってVercel のデータに連携する方法
この記事では、CData ADO.NET Data Provider for API 経由でLINQ を使ってVercel テーブルにアクセスする方法を説明します。これを行うには、Entity Framework にLINQ を使います。これにより接続を作成し、あらゆる CData ADO.NET Data Providers からLINQ を使ってデータにアクセスできるようになります。
- Visual Studio の新規プロジェクトで、プロジェクトを右クリックし[新しい項目の追加]を選択します。[ADO.NET Entity Data Model]を追加します。
- [データベースから生成]を選択し、[次へ]をクリックします。
- [接続の追加]をクリックし、データソースタイプを "CData Vercel Data Source" に変更します。
データソースの接続情報を入力します。一般的な接続プロパティは以下のとおりです:
API キー認証の設定
Vercel は Bearer トークン認証を使用します。API キーとして、パーソナルアクセストークンまたは OAuth アクセストークンのいずれかを使用できます。
パーソナルアクセストークンを取得するには、以下のステップで進めます:
- https://vercel.com/ で Vercel アカウントにログインします
- Account Settings > Tokens に移動します。
- Create Token をクリックし、名前と有効期限を入力して Create をクリックします。
- 生成されたトークンをコピーします(一度しか表示されません)。
トークンを取得したら、以下の接続プロパティを設定します:
- AuthScheme:APIKey に設定します。
- APIKey:Vercel のパーソナルアクセストークンまたは OAuth アクセストークンに設定します。
接続文字列の例
Profile=C:\profiles\Vercel.apip;AuthScheme=APIKey;APIKey=your_access_token;
チームの利用
Vercel のリソースの多くは、チームにスコープされています。すべてのリクエストを特定のチームにスコープするには、TeamId 接続プロパティにチームの ID を設定します。チーム ID は、Teams テーブルをクエリするか、Vercel ダッシュボードで確認できます。あるいは、サポートされている場合は SQL クエリの WHERE 句で TeamId を指定することもできます。
Vercel への接続
認証を設定すると、Vercel に接続して、Projects、Deployments、Teams、Domains などの利用可能なテーブルからデータをクエリできます。
Below is a typical connection string:
Profile=C:\profiles\Vercel.apip;AuthScheme=APIKey;APIKey=your_access_token;
- エンティティ接続をApp.Config に保存する場合は、エンティティ名を設定します。この例では、APIEntities をエンティティ接続としてApp.Config に設定しています。
- モデル名を入力し、モデルに含めたいテーブルまたはビューを選択します。
作成したエンティティを使って、選択、更新、削除、および挿入コマンドが実行できます。例:
APIEntities context = new APIEntities();
var userQuery = from user in context.User select user;
foreach (var result in userQuery) {
Console.WriteLine("{0} {1} ", result.Id, result.);
}
サポートされたLINQ のクエリ例は、ヘルプドキュメントの「LINQ およびEntity Framework」をご参照ください。