Twitter への接続
コンセプト情報
Twitter のライブ データを接続し、ツイート、フォロワー、メッセージ、検索などにアクセスします。コネクターはアプリケーションのみの認証を使用するため、Twitter でアプリケーションを登録し、必要な資格情報を取得する必要があります。
メモ
このコネクターを Analytics から独立して使用することはできません。コネクター ドライバーの DSN は Windows の ODBC データ ソース アドミニストレーターを使って設定できますが、DSN 接続を本コネクターの[Windows DSN configuration(Windows DSN 設定)]ダイアログ 内でなく、Analytics 内でテストする必要があります。
作業を開始する前に
Twitter に接続するには、アプリケーションを登録し、Twitter Application Management ポータルを使用して、Twitter から Oauth 資格情報を取得する必要があります。
接続の前提条件の収集については、組織の Twitter 管理者に支援を仰いでください。管理者から支援を得られない場合は、あなたまたは管理者から Twitter のサポートにお問い合わせください。
Twitter 接続の作成
- Analytics のメイン メニューから、[インポート > データベースとアプリケーション]を選択します。
- ACL コネクター セクションの[新規の接続 ]タブから、Twitter を選択します。
ヒント
使用可能なコネクターのリストをフィルタリングするには、[接続のフィルタリング]ボックスに検索文字列を入力します。コネクターはアルファベット順に表示されます。
- [データ接続の設定]パネルが開いたら、接続設定を入力し、パネルの下部にある[保存して接続]をクリックします。
デフォルトの接続名を使用するか、新しい名前を入力します。
Twitterの接続は、[既存の接続]タブに保存されます。今後、Twitterに接続するには、保存したこの接続を使用できます。
接続が確立されると、データ アクセス ウィンドウが開いてステージング領域が表示されるので、データのインポートを開始できます。Twitterからデータをインポートする方法については、データ アクセス ウィンドウの作業を参照してください。
接続設定
基本設定
| 設定 | 説明 | 例 |
|---|---|---|
| OAuth クライアント Id |
クライアント ID は、Twitter の OAuth 承認サーバーでアプリケーションを登録するときに割り当てられます。 OAuth では、アプリケーションを登録する必要があります。登録の一部として、クライアント ID(別称:コンシューマ キー)およびクライアント シークレットを受け取ります。OAuthClientId と OAuthClientSecret の両方を、OAuth サーバーに接続するように設定されます。 |
xvz1evFS4wEEPTGEFPHBog |
| OAuth クライアント シークレット |
クライアント シークレットは、Twitter の OAuth 承認サーバーにアプリケーションを登録するときに割り当てられます。 OAuth では、アプリケーションを登録する必要があります。登録の一部として、クライアント ID(別称:コンシューマ キー)およびクライアント シークレットを受け取ります。OAuthClientId と OAuthClientSecret の両方を、OAuth サーバーに接続するように設定されます。 |
L8qq9PZyRg6ieKGEKhZolGC0vJWLw8iEJ88DRdyOg |
| OAuth アクセス トークン |
OAuth を使用して接続するためのアクセス トークン。 OAuthAccessToken プロパティは、OAuth を使用して接続するために使用されます。OAuthAccessToken は、認証処理の一部として OAuth サーバーから取得します。サーバー依存タイムアウトであり、要求間で再利用できます。 アクセス トークンは、ユーザー名とパスワードの代わりに使用されます。アクセス トークンは、サーバーで課すことによって、資格情報を保護します。 |
xvz1evFS4wEEPTGEFPHBog:L8qq9PZyRg6ieKGEKhZolGC0vJWLw8iEJ88DRdyOg |
| OAuth アクセス トークン シークレット |
OAuth を使用して接続するための OAuth アクセス トークン シークレット。 OAuthAccessTokenSecret プロパティは、OAuth を使用して接続および認証するために使用されます。OAuthAccessTokenSecret は、認証処理の一部として、OAuth サーバーから取得されます。OAuthAccessToken を使用し、タイムアウトするまで、複数の要求を使用できます。 |
Ewy4p5VygSPOUI1rhbClVZcLnu05Y23Md22F0AKQYh1Hg |
詳細設定
| 設定 | 説明 | 例 |
|---|---|---|
| 日付時刻を GMT に変換 |
インポート時に日付時刻フィールドを GMT タイムゾーンに変換します。日付時刻値は、false の場合には、Analytics を実行するコンピューターのオペレーティング システム タイムゾーンに変換されます。 |
true |
| 鍵サイズの上限 |
主キー列の最大長。サイズを 0 に接続すると、キー長が元の長さに戻ります。 このプロパティでは、コネクターが主キー列のすべての報告された列を無効にします。 |
255 |
| Long Varchar にマッピング |
列が SQL_LONGVARCHAR として返されるかどうかを制御します。 この設定を使用すると、指定されたサイズよりも大きい列をマッピングし、SQL_VARCHAR ではなく、SQL_LONGVARCHAR として報告されます。 |
-1 |
| WVarchar にマッピング |
文字列タイプを SQL_VARCHAR ではなく、SQL_WVARCHAR にマッピングするかどうかを制御します。デフォルトで設定されます。 文字列を SQL_WVARCHAR にマッピングし、さまざまな国際文字セット格納するため、MapToWVarchar はデフォルトで true に設定されています。false に設定すると、SQL_VARCHAR を使用できます。 |
true |
| 擬似列 |
擬似列を列としてテーブルに含めるかどうかを指定します。 この設定は、テーブル列ではない場合に、擬似列の値を設定できない Entity Framework で特に有用です。 この接続設定の値は、"Table1=Column1, Table1=Column2, Table2=Column3" の形式です。"*" 文字を使用すると、すべてのテーブルとすべての列を含めることができます。 |
MyTable=* |
| 大文字の ID | テーブルおよび列名を含む、すべての識別子を大文字で報告します。 | false |
| SSL サーバー証明書 |
TLS/SSL を使用して接続するときにサーバーから許可される証明書。次のいずれかを指定できます。
TLS/SSL 接続を使用している場合は、このプロパティを使用して、サーバーから許可される TLS/SSL 証明書を指定できます。コンピューターから信頼されない他の認定書はすべて拒否されます。 |
C:\cert.cer |
| 拡張 SQL のサポート |
メモリ内クライアント側処理を有効にし、API 経由で直接サポートされるよりも、SQL 機能を強化します。
述語の実行コネクターは、データソースでサポートされている節を決定してから、ソースにプッシュし、クエリを満たす行の最も小さいスーパーセットを取得します。その後に、行の残りをローカルでフィルタリングします。フィルター処理はストリームされ、ドライバーは非常に大きいデータセットでも効果的にフィルタリングできます。 結合の実行コネクターはさまざまな手法を使用してメモリで結合します。ドライバーは、同じテーブルを複数回読み取る要件に対して、メモリ利用率をトレードオフします。 集計の実行コネクターは、メモリ内の集計を処理するために必要なすべての行を取得します。 |
|
| プロキシ認証スキーム |
ProxyServer プロキシで認証するために使用する認証タイプ。 この値は、ProxyServer および ProxyPort で指定された HTTP プロキシで認証するために使用する認証タイプを指定します。 メモ コネクターはデフォルトでシステム プロキシ設定を使用し、さらなる構成は必要ありません。別のプロキシに接続する場合は、ProxyAutoDetect を false に設定し、ProxyServer と ProxyPort も false に設定する必要があります。認証するには、ProxyAuthScheme を設定し、必要に応じて、ProxyUser と ProxyPassword を設定します。 認証タイプは次のいずれかにすることができます。
|
BASIC |
| プロキシ自動検出 | システムプロキシ設定を使用するかどうかを指定します。ProxyAutoDetect を FALSE に設定すると、カスタム プロキシ設定を使用します。これは他のプロキシ設定よりも優先されます。 | true |
| プロキシ ユーザー |
ProxyServer プロキシで認証するために使用されるユーザー名。 ProxyUser および ProxyPassword オプションは、ProxyServer で指定された HTTP プロキシに対して接続および認証するために使用されます。 ProxyAuthScheme で使用可能な認証タイプのいずれかを選択できます。HTTP 認証を使用している場合は、これを HTTP プロキシで認識されるユーザーのユーザー名に設定します。Windows または Kerberos 認証を使用している場合は、このプロパティを次の形式のいずれかのユーザー名に設定します。
|
john_doe@example.com |
| プロキシのパスワード |
ProxyServer プロキシで認証するために使用されるパスワード。 このプロパティは、NTLM (Windows)、Kerberos、または HTTP 認証をサポートする HTTP プロキシ サーバーで認証するために使用されます。HTTP プロキシを指定するには、ProxyServer と ProxyPort を設定できます。認証タイプを指定するには、ProxyAuthScheme を設定します。 HTTP 認証を使用している場合は、追加で、ProxyUser と ProxyPassword を HTTP プロキシに設定します。 NTLM 認証を使用している場合は、ProxyUser と ProxyPassword を Windows パスワードに設定します。Kerberos 認証を完了するためにこれらが必要な場合もあります |
|
| プロキシ サーバー |
HTTP トラフィックをルーティングするプロキシのホスト名または IP アドレス。 HTTP トラフィックをルーティングするプロキシのホスト名または IP アドレス。ドライバーは、HTTP、Windows (NTLM)、または Kerberos 認証タイプを使用して、HTTP プロキシで認証できます。 デフォルトでは、ドライバーはシステム プロキシを使用します。別のプロキシを使用する場合は、ProxyAutoDetect を false に設定します。 |
206.174.193.115 |
| プロキシのポート | ProxyServer プロキシが実行されている TCP ポート。 | 80 |
| プロキシ SSL タイプ |
ProxyServer プロキシに接続するときに使用する SSL タイプ:
|
AUTO |
ストリーミング テーブル
TweetStream テーブルなど、継続的に更新されるデータをキャプチャするテーブルはクエリしないでください。ストリーミング テーブルは、履歴データのアーカイブではなく、リアルタイムのアクティビティが格納されるだけです。これらのテーブルで確立される接続は開いたままになるため、ご使用アカウントでの API の更新頻度制限を超えてしまう可能性があります。
データ コネクターの更新
Analytics またはロボット エージェントをアップグレードする場合は、いずれかの Analytics データ コネクターを使ってデータをインポートするスクリプト(ACCESSDATA コマンド)をテストする必要があります。
データ ソースまたは ODBC ドライバーのサード パーティ ベンダーが加えた変更により、1 つまたは複数のデータ コネクターを更新しなければならない可能性があります。スクリプトに作り込んだデータ接続を引き続き正常に動作させるには、それを更新する必要があります。
- インポートの再実行 接続機能を最も簡単に更新する方法は、更新されたバージョンの Analytics のデータ アクセス ウィンドウを使って、インポートを手動で実行することです。ログに記録されている ACCESSDATA コマンドをコピーし、それを使ってスクリプトを更新します。
メモ
データ ソースに接続してインポートを再実行する前に、コネクターのキャッシュを消去することで、既存の一連のテーブル名を削除します。
データ アクセス ウィンドウの[既存の接続]タブで、接続名の横にある[
>キャッシュの消去]を選択します。 - フィールド指定の更新 データ ソースまたは ODBC ドライバーのテーブル スキーマの変更と一致するように、スクリプト本体内のフィールド指定を更新しなければならない場合もあります。必要に応じてフィールド名、フィールドのデータ型、およびフィールド長とレコード長を変更します。
- フィルター処理の結果の確認 データ インポートの一環として適用したフィルター処理の結果も確認する必要があります。インポートのフィルター処理によってレコードを正しく追加または除外できたかどうかを確認します。
Twitter データ コネクターの変更内容
Twitter データ コネクターに加えられた具体的な変更内容を次に挙げます。
| Analytics のバージョン | 変更 |
|---|---|
|
14.2 |
DirectMessagesSent および DirectMessagesReceived テーブルが削除され、新しいテーブル、DirectMessages に取って代わられました。 |
|
Tweets テーブルの IdLong フィールドのデータ型が、long から string に変更されました。 |