TweetStream
Twitter に流れている公開データをクエリします。
ビュー固有の情報
TweetStream は、処理が終了させられるまで継続して読み出される公開ツイートのストリームです。
Select
次のフィールドで結果セットをフィルタリングできます。
Follow | ユーザーID のカンマ区切りのリストで、ストリームに配信されるツイートをフォローしているユーザーを示します。 |
Track | フレーズを含むストリームでツイートを配信するために使われるカンマ区切りのフレーズのリスト。 |
Language | カンマ区切りのリストで指定された言語で書かれたツイートを返します。'en'、'fr'、'ja' のようなBCP 47 言語識別子を使用する必要があります。入力されたcoordinates が正しくない場合、Twitter は"406 Not Acceptable" エラーを返します。 |
Locations | ツイートをフィルタリングする緯度経度ペアのカンマ区切りのリスト。少なくとも2組の緯度経度の座標を使用する必要があり、最初のペアには、検索する地域の南西の境界を示します。 |
BackfillCount | ストリームエンドポイントに再接続する際に、BackfillCount パラメータが含まれると接続されていなかったときに見逃したメッセージを再現します。使用できる値は1 から 150000 もしくは -1から -150000 の整数です。正の数が指定された場合、バックフィル値がクライアントに渡された後にはストリームはライブ値へ戻されます。負の数が指定された場合、バックフィル値がクライアントに渡された後にはストリームは切断されます。このフィルタは、以下のアクセス権の 昇格したユーザーにのみ許可されます:Firehose、Links、Birddog、およびShadow。ロールがこのフィルタをサポートしていない場合、Twitter は"416 Requested Range Not Satisfiable" エラーを返します。 |
Filter_Level | 返されるツイートのレベル。デフォルト値はNONE で、すべてのツイートを含みます。 |
SELECT * FROM TweetStream WHERE Follow = '51192312'
Follow、Track、もしくはLanguage がいずれも指定されていない場合、すべての公開ツイートから小さい数のランダムなサンプルツイートが返されます。他のフィルタを使用しても、Twitter のストリーミング結果には影響しません。
ツイートの本文に'Assembly' という単語を含むツイートを多数取得します。
SELECT * FROM TweetStream WHERE Track = 'Assembly' AND Filter_Level='low'
次のフィルタは、ニューヨーク市から発信されたすべてのツイートを取得します。
SELECT * FROM TweetStream WHERE Locations = '-74,40,-73,41'
'fillet' という単語を含むフランス語または英語のツイートを取得します。切断されている場合は、50ツイート後に取得を中止します。
SELECT * FROM TweetStream WHERE Track = 'fillet' AND Language = 'fr,en' AND BackfillCount='-50'
Columns
Name | Type | Description |
ID | String | ステータスアップデートまたはツイートのID。既存のツイートをリツイートするために挿入する場合は、この値を設定してください。 |
Created_At | Datetime | ツイートが作成された時刻。 |
Text | String | ツイートのテキスト。 |
Lang | String | ツイートの作成に使用された言語コード。 |
Source | String | ツイートのソース。 |
Favorited | Boolean | このツイートがお気に入りに登録されているかどうかを示すboolean。 |
Favorite_Count | Integer | このツイートがお気に入りに登録されたおよその回数。 |
Retweeted | Boolean | このツイートがリツイートされているかどうかを示すboolean。 |
Retweet_Count | Integer | ツイートがリツイートされた回数。 |
Retweeted_Status_Id | String | このツイートによってリツイートされたツイートのID。現在のツイートがリツイートでない場合は、空。 |
Truncated | Boolean | このツイートが切り詰められているかどうかを示すboolean。 |
Filter_Level | String | このツイートをストリームできる、使用可能なFilter_Level パラメータの最大値を示します。 |
Possibly_Sensitive | String | このフィールドは、ツイートにリンクが含まれる場合にのみ利用できます。このフィールドの意味はツイートの内容自体には関連しません。これは、ツイートに含まれるURL に、慎重に扱うべき内容と判定された内容またはメディアが含まれている可能性があることを示すインジケータです。 |
Contributors | String | 正式のツイート作成者の代わってツイートの作成に携わるユーザーを示すユーザーオブジェクト(通常は1つのみ)のJSON コレクション。 |
Coordinates_Coordinates | String | ツイートの地理座標です(経度、緯度の順)。 |
Coordinates_Type | String | 必要な場合の座標の種類。 |
Place_Full_Name | String | ツイート場所のフルネーム(市と州)。 |
Place_Country | String | ツイートが発信された国名。 |
Current_User_Retweet_Id | String | このツイートの認証ユーザー自身のリツイート(存在する場合)のツイートIDを示します。 |
In_Reply_To_Status_Id | String | このツイートが別のツイートへの応答である場合に、元のステータスのIDを表します。 |
In_Reply_To_User_Id | String | このツイートが別のツイートへの応答である場合に、元のユーザーのIDを表します。 |
From_User_Id | String | ツイートを行ったユーザーのID。これをWHERE 句で使用して、指定されたユーザーのツイートを取得できます。 |
From_User_Screen_Name | String | ツイートを行ったユーザーの画面名。これをWHERE 句で使用して、指定されたユーザーのツイートを取得できます。 |
From_User_Name | String | ツイートを行ったユーザーの名前。 |
From_User_Location | String | ツイートを行ったユーザーの場所。 |
From_User_Profile_URL | String | ツイートを行ったユーザーのURL。SearchTerms が指定されている場合、これは返されません。 |
From_User_Profile_Image_Url | String | ツイート元ユーザーのプロフィール画像のURL。 |
User_Mentions | String | ツイート内の他のユーザーの@ツイート。JSON集計として返されます。 |
URLs | String | ツイート内のURL。XML集計として返されます。 |
Hashtags | String | ツイート内のハッシュタグ。XML集計として返されます。 |
Follow | String | ストリームからどのユーザーのツイートを表示するかを示すユーザーId のカンマ区切りのリスト。保護されたユーザーはサポートされません。 |
Track | String | ストリームで流されるツイートを決定するために使われるカンマ区切りのフレーズ。 |
Language | String | Twitter のアドバンスサーチページに記載されている言語に対応するBCP 47 言語識別子のカンマ区切りのリストに本パラメータを設定することで、指定された言語で書かれたツイートを返します。 |
Locations | String | ツイートをフィルタリングする緯度経度ペアのカンマ区切りのリスト。Search API のようにユーザーフィールドの位置はツイートのフィルタには使われず、要求された地域に地理的に当てはまるツイートだけが含まれます。 |
Pseudo-Columns
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
Name | Type | Description |
BackfillCount | String | ストリームエンドポイントに再接続する際に、BackfillCount パラメータが含まれると接続されていなかったときに見逃したメッセージを再現します。使用できる値は1 から 150000 もしくは -1から -150000 の整数です。正の数が指定された場合、バックフィル値がクライアントに渡された後にはストリームはライブ値へ戻されます。負の数が指定された場合、バックフィル値がクライアントに渡された後にはストリームは切断されます。 |