接続の確立
CData Cmdlets ユーザーは、データモジュールをインストールし、接続プロパティを設定してスクリプトを開始できます。このセクションでは、CSV インポートおよびエクスポートcmdlet などのネイティブPowerShell cmdlet でTwitter Cmdlets を使用する例を示します。
インストールおよび接続
PSGet がある場合は、PowerShell Gallery から次のコマンドを使ってcmdlet をインストールできます。CData サイトからセットアップを取得することもできます。
Install-Module TwitterCmdlets
プロファイルに以下を追加すると、次のセッションでcmdlet がロードされます。
Import-Module TwitterCmdlets;
Connect-Twitter cmdlet を使って、別のcmdlet に渡すことができる接続オブジェクトを作成します。
$conn = Connect-Twitter
OAuth
本製品 には、Twitter に接続するための埋め込みOAuth クレデンシャルが含まれています。ユーザー資格情報の接続プロパティを設定せずに接続できます。接続すると、本製品 はデフォルトブラウザで OAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。本製品 がOAuth プロセスを完了します。
すべてのテーブルには認証が必要です。OAuth を使用してTwitter で認証する必要があります。OAuth では認証するユーザーにブラウザでTwitter との通信を要求します。詳しくは、OAuth 認証の使用 を参照してください。
データの取得
Select-Twitter cmdlet はデータを取得するためのネイティブなPowerShell インターフェースを提供します。
$results = Select-Twitter -Connection $conn -Table "Tweets" -Columns @("From_User_Name, Text") -Where "From_User_Name='twitter'"Invoke-Twitter cmdlet はSQL インターフェースを提供します。このcmdlet を使うと、Query パラメータを介してSQL クエリを実行できます。
cmdlet 出力のパイプ処理
cmdlet は行オブジェクトをパイプラインに一度に一行ずつ返します。以下は、結果をCSV ファイルにエクスポートします。
Select-Twitter -Connection $conn -Table Tweets -Where "From_User_Name = 'twitter'" | Select -Property * -ExcludeProperty Connection,Table,Columns | Export-Csv -Path c:\myTweetsData.csv -NoTypeInformation
Select-Twitter からの結果をSelect-Object cmdlet にパイプして、Export-CSV cmdlet にパイプする前にいくつかのプロパティを実行していることがわかるでしょう。これをする理由は、CData Cmdlets は接続、テーブル、およびカラムの情報を結果セットの各行オブジェクトに追加しますが、必ずしもその情報がCSV ファイルに必要ではないからです。
ただし、これによってcmdlet の出力を別のcmdlet にパイプすることが容易になります。以下に、結果セットをJSON に変換する例を示します。
PS C:\> $conn = Connect-Twitter PS C:\> $row = Select-Twitter -Connection $conn -Table "Tweets" -Columns (From_User_Name, Text) -Where "From_User_Name = 'twitter'" | select -first 1 PS C:\> $row | ConvertTo-Json { "Connection": { }, "Table": "Tweets", "Columns": [ ], "From_User_Name": "MyFrom_User_Name", "Text": "MyText" }
データの削除
以下は、抽出条件に合うあらゆるレコードを削除します。
Select-Twitter -Connection $conn -Table Tweets -Where "From_User_Name = 'twitter'" | Remove-Twitter
データの変更
cmdlet はデータクレンジング同様、データの変換を容易にします。次の例は、レコードがすでに存在するかどうか、挿入する前に更新が必要かどうかをチェックしてから、CSV ファイルのデータをTwitter にロードします。
Import-Csv -Path C:\MyTweetsUpdates.csv | %{ $record = Select-Twitter -Connection $conn -Table Tweets -Where ("Id = `'"+$_.Id+"`'") if($record){ Update-Twitter -Connection $conn -Table Tweets -Columns @("From_User_Name","Text") -Values @($_.From_User_Name, $_.Text) -Where "Id = `'$_.Id`'" }else{ Add-Twitter -Connection $conn -Table Tweets -Columns @("From_User_Name","Text") -Values @($_.From_User_Name, $_.Text) } }