「SQLの仕様(旧)」の編集履歴(バックアップ)一覧はこちら
「SQLの仕様(旧)」(2014/11/10 (月) 16:17:46) の最新版変更点
追加された行は緑色になります。
削除された行は赤色になります。
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">
<strong>概略</strong></div>
<p>本スキンsm02ではSQL(っぽい)の構文を使ってプレイリスト作成とプレイリストの列指定ができます。<br />
SQLについて非常に大雑把に説明すると、データベース操作を行う為のデータベース言語です。<br />
Windows Media
Player(以下、WMPと略)のライブラリはデータベースみたいなものなので、SQL構文でプレイリスト作成やデータ出力機能を作ってみました。<br />
以降、SQLと記述した場合、断り書きがない限り、本スキンの独自SQLをさします。</p>
<p>SQLを知らない方にとっては、やや難解な機能かもしれません。<br />
サンプルを試してもよくわからない場合、本機能は無視してもいいと思います。<br />
既にSQLを知っている方は容易く習得できるはずですが、本スキンには独自仕様もあります。<br />
特にwhere句には独自仕様が多いので注意してください。<br />
他に独自仕様としてexpand句やoption句なんてものもあります。</p>
<p>一応ですが、本スキンの構文解析の精度が低い上に、WMPの制約や本スキンの仕様、不具合等により<br />
「このSQL文は正しいはずなのにエラーになるぞ?」<br />
「このSQL文おかしいけどエラーにならないぞ?」<br />
「このSQL文の検索結果おかしくない?」<br />
「エラーメッセージがわかりにくい!」<br />
等の事は十分起こりえます。<br />
ご了承ください。</p>
<p> </p>
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">
<strong>SQLの構文と内容</strong></div>
<p>select 列名[, 列名, ...]</p>
<p> from テーブル名<br />
where 列名 [=<>等] 値 [[and|or] 列名 [=<>等]値 ...]<br />
order by 列名 [asc|desc] [,列名 [asc|desc] ...]<br />
option タイプ [値, ...]</p>
<p>または</p>
<p>select 列名[, 列名, ...]<br />
expand 再生リスト名[, 再生リスト名, ...]<br />
where 列名 [=<>等] 値 [[and|or] 列名 [=<>等]値 ...]<br />
order by 列名 [asc|desc] [,列名 [asc|desc] ...]<br />
option タイプ [値, ...]</p>
<p><br />
◆「from テーブル名」部分<br />
ライブラリ登録されているファイルの取得元テーブルを指定します。<br />
指定できるテーブルは以下の通りです<br />
audio:音楽ファイル<br />
video:動画ファイル<br />
photo:画像ファイル<br />
playlist:プレイリスト<br />
other:その他(MIDI等)<br />
※from句とexpand句は併用できません。<br />
※expand句と異なり、テーブルは1つのみ設定可能です。</p>
<p>// 音楽ファイルを取得<br />
select name from audio</p>
<p><br />
◆「expand 再生リスト名」部分<br />
ライブラリ登録されている再生リスト、再生中のプレイリスト、ブックマーク等を取得元に指定します。<br />
指定できるパターンは以下の通りです。<br />
・登録済の再生リスト名 (''で囲ってください)<br />
・all (固定値:登録済の全ての再生リスト)<br />
・random (固定値:登録済の再生リストからランダム)<br />
・current (固定値:現在再生中のプレイリスト)<br />
・playlistview (固定値:SQL検索画面のプレイリストビューに設定されたプレイリスト)<br />
・bookmark1~20(固定値:ブックマーク1~ブックマーク20を含むプレイリスト)<br />
・stackboard (固定値:スタックボード)<br />
※from句とexpand句は併用できません。<br />
※同じファイルが複数個所に登録されている場合、マージされ1つになります。</p>
<p>// 「BestMusic」という再生リストからデータを取得<br />
select name expand 'BestMusic'</p>
<p>// 「My List」という再生リストを<br />
select name expand 'My List'</p>
<p>// 「GoodSong」「BetterSong」という再生リストからデータを取得<br />
select name expand 'GoodSong', 'BetterSong'</p>
<p>// 「洋楽」から始まる再生リストからデータを取得<br />
select name expand '洋楽%'</p>
<p>// 「2014」を含む再生リストからデータを取得<br />
select name expand '%2014%'</p>
<p>// 全ての再生リストからデータを取得<br />
select name expand all</p>
<p>//ランダムな 再生リストからデータを取得<br />
select name expand random</p>
<p>// 再生中のプレイリストからデータを取得<br />
select name expand current</p>
<p>// SQL検索画面のプレイリストビューに設定されたのプレイリストリストからデータを取得<br />
select name expand playlistview</p>
<p>// 1番目のブックマークを含むプレイリストからデータを取得<br />
select name expand bookmark1</p>
<p>// 15番目のブックマークを含むプレイリストからデータを取得<br />
select name expand bookmark15</p>
<p>// スタックボードからデータを取得<br />
select name expand stackboard</p>
<p><br />
◆「select 列名,[, 列名, ...]」部分<br />
プレイリストに表示する列です。<br />
ファイル出力の場合は出力する列です。<br />
列名は","区切りで複数登録できます。<br />
利用できる列名は、SQL列定義.xlsおよび本スキンのヘルプ機能で確認できます。</p>
<p>// 全ての音楽ファイルを取得し、name, length列を表示<br />
select name, length from audio</p>
<p>列名の代わりに"*"を指定できます。<br />
"*"を指定した場合は、テーブル毎に組み込んだ列を表示します。<br />
(※一般的なSQLでは指定テーブルの全列を表示しますが、本SQLは異なります)</p>
<p>// * を使う<br />
select * from audio</p>
<p>また列にconvert関数が利用できます。※詳細は後述の「convert関数について」を参照してください</p>
<p>またas句を使うと列に別名を設定できます。<br />
別名内にスペース( )やカンマ(,)を使う場合は別名を''で囲ってください。</p>
<p>// name, lengthに別名を付ける<br />
select name as タイトル, length as 時間 from audio<br />
// name, lengthに別名を付ける(スペースやカンマを使う)<br />
select name as 'なまえ,です', length as 'さいせい 時間', rating as '☆は''あなたの評価''です' from
audio</p>
<p><br />
◆「order by 列名 [asc|desc] [,列名 [asc|desc] ...]」部分<br />
取得レコードのソート条件を指定します。<br />
省略が可能です。<br />
省略した場合はソートされません。<br />
利用できる列名は、SQL列定義.xlsおよび本スキンのヘルプ機能で確認できます。<br />
列名の後ろにascを指定すれば昇順、descを指定すれば降順にソートされます。<br />
asc|descが未設定の場合は昇順にソートされます。<br />
カンマ記号","で列を区切れば複数のソート条件が設定できます。</p>
<p>// nameを昇順でソート<br />
order by name<br />
order by name asc</p>
<p>// nameを降順でソート<br />
order by name desc</p>
<p>// albumを昇順でソート、nameを降順でソート<br />
order by album asc, name desc</p>
<p>特殊なソートとして[order by shuffle]または[order by random]、[order by reverse]があります。<br />
[order by shuffle]または[order by random]を使うとランダムなソートを行います。<br />
[order by reverse]を使うとソート結果を逆順にします。<br />
randomとshuffleの違いによる機能の違いはありません。</p>
<p>// シャッフル(ランダム)ソート<br />
order by shuffle<br />
order by random</p>
<p>// 逆順に並べ替える<br />
order by reverse</p>
<p> </p>
<p>◆「where 列名 [=<>等] 値 [[and|or] 列名 [=<>等]値 ...]」部分<br />
取得レコードの絞り込み条件を指定します。<br />
where句は省略が可能です。<br />
省略した場合、対象テーブルの全レコードが取得されます。<br />
利用できる列名は、SQL列定義.xlsおよび本スキンのヘルプ機能で確認できます。<br />
「name = 'hoge'」や「playcount > 10」のように条件を指定します。</p>
<p>「列名 演算子(=等) 値」の比較のみ対応しており、「値 = 列名」や<br />
「列名1 = 列名2」のような比較はできません。</p>
<p><br />
列ごとにデータ型と範囲を持っています。<br />
データ型にはnumber(数値),string(文字列),date(日時),boolean(真偽)があります。<br />
文字列型は「列名='値'」のように値を''で囲んでください。<br />
日付型は「列名='2001/10/01'」や「列名='2001/10/01 22:00:00'」のように<br />
値を''で囲み、かつ'yyyy/mm/dd'または'yyyy/mm/dd 24hh:mm:ss'形式で<br />
記述してください。<br />
真偽型は「列名=true」または「列名=false」のように記述してください。</p>
<p>データ型によって利用できる比較演算子が異なります。<br />
数値(=,<>,<=,<.>=.>)<br />
文字列(=,<>,like,notlike)<br />
日付(=,<>,<=,<.>=.>)<br />
真偽(=,<>)<br />
このほかに(is,isnot)が全てのデータ型で利用できます。<br />
(is,isnot)は後述のnullで説明します。</p>
<p>// nameがhoge<br />
where name='hoge'</p>
<p>// playcountが10でない<br />
where playcount<>10</p>
<p>// releasedateが'2010/01/01 13:00:00'以上<br />
where releasedate>='2010/01/01 13:00:00'</p>
<p>// releasedateが'2010/01/01 00:00:00'より大きい<br />
where releasedate>'2010/01/01'</p>
<p>// nameが'い'から始まる。<br />
where name like 'い%'</p>
<p>// nameが'い'から始まらない<br />
where name notlike 'い%'</p>
<p>// urlに'rock'が含まれている<br />
where url like '%rock%'</p>
<p>特別な比較値としてnullがあります。<br />
この値は"データが存在しない"事を表しています。<br />
全てのデータ型で利用できますが、指定可能な比較演算子isまたはisnotだけです。</p>
<p>// データが未設定のreleasedateだけ取得<br />
where releasedate is null</p>
<p>// データが設定されているartistだけ取得<br />
where artist isnot null</p>
<p>なお文字列の場合は「column = ''」と「column is null」は同じ結果になります。</p>
<p>// 2つは同じ結果となる。<br />
where album is null<br />
where album = ''</p>
<p>where album isnot null<br />
where album <> ''</p>
<p>複数の条件を設定する場合はandまたはorを使います。<br />
論理演算子はand > orの優先順位です。<br />
3つ以上の条件を設定する場合は優先順位に気を付けてください。<br />
本スキンでは()が未対応です。</p>
<p>// playcountが10以上かつplaycountが20未満のレコードを検索<br />
where playcount >= 10 and playcount < 20</p>
<p>// playcountが30以上またはratingが99のレコードを取得<br />
where playcount >= 30 or rating = 99</p>
<p>// 「playcountが30以上」または「ratingが99かつnameが'あ'で始まる」レコードを取得<br />
where playcount >= 30 or rating = 99 and name like 'あ%'</p>
<p>// 「ratingが0より大きく50以下かつnameが'b'で始まる」または「ratingが99かつnameが'a'で始まる」<br />
// レコードを取得<br />
where rating > 0 and rating <= 50 and name like 'b%' or rating = 99 and
name like 'a%'</p>
<p><br />
◆「option [totallength|top | limit | randomselectfrom | expandplaylist] [値,
...]」部分<br />
取得レコードに対するオプション操作を指定します。<br />
省略が可能です。</p>
<p>・totallength<br />
先頭レコードから合計再生時間[秒]指定による取得レコードの絞込み。<br />
where句・order by句が設定している場合、その検索結果に対して<br />
絞り込みを行います。</p>
<p>// 取得レコードの合計再生時間を1時間(3600秒)以下に絞り込みます。<br />
option totallength 3600<br />
option totallength toMinute(60)<br />
option totallength toHour(1)</p>
<p>・top<br />
先頭レコードから件数指定による取得レコードの絞込み。<br />
where句・order by句が設定している場合、その検索結果に対して<br />
絞り込みを行います。</p>
<p>// 先頭レコードから20件取得します。<br />
option top 20</p>
<p>・limit<br />
先頭レコードから位置指定[0始まり]、件数指定のによる取得レコードの絞込み。<br />
where句・order by句が設定している場合、その検索結果に対して<br />
絞り込みを行います。</p>
<p>// 3件目のレコードから10件取得します。<br />
option limit 2, 10 ※3, 10ではありません! "0,1,2"で3件目のレコード</p>
<p>・randomselectfrom 列名<br />
指定列名のランダムな値を使った取得レコードの絞込み。<br />
where句・order by句が設定している場合、その検索結果に対して<br />
絞り込みを行います。<br />
※後述のRandomValue()の説明も別途参照してください。</p>
<p>// album列に存在するランダムな値を基に、取得レコードを絞り込む<br />
option randomselectfrom album</p>
<p>// artist列に存在するランダムな値を基に、取得レコードを絞り込む<br />
option randomselectfrom artist</p>
<p>・expandplaylist<br />
from playlistを指定したとき限定。<br />
selectを実行すると通常はメディアファイルが取得されますが、<br />
from playlistの場合は、プレイリストを頂点とするツリー構造にメディアファイルが<br />
配置されています。<br />
このプレイリストを通常のselectと同じようにフラットな状態に展開します</p>
<p>// from playlistで全てのプレイストを取得し、取得したプレイリストを展開します。<br />
select * from playlist option expandplaylist</p>
<p>// from playlistで全てのプレイストを取得(option expandplaylistを使わない場合)<br />
// ※↑のSQLと実行結果を比較してみてください。<br />
select * from playlist</p>
<p> </p>
<p>-------------------------------------<br />
レコードの抽出条件の注意点や制約<br />
-------------------------------------<br />
<条件式の記述順><br />
[列名][比較演算子][値]の順で記述してください。<br />
一般的なSQLでは、[値][比較演算子][列名]や[列名][比較演算子][列名]<br />
などの可能ですが、本スキンは未対応です。</p>
<p>○where name = 'aaa'<br />
×where 'aaa' = name<br />
×where name = album</p>
<p><複数条件設定について><br />
現機能では()に未対応です。<br />
論理演算子はand > orの優先順位です。<br />
○where name='aaa'<br />
○where name='aaa' and playcount>10<br />
○where name='aaa' or name='bbb'<br />
○where name='aaa' or name='bbb' and playcount>10<br />
×where (name='aaa' or name='bbb') and playcount>10 // ()に未対応</p>
<p><null比較><br />
一般的なSQLではnullでない場合、[is not]と記述しますが<br />
本SQLでは[isnot]と記述します。<br />
○where name isnot null<br />
×where name is not null</p>
<p><文字列><br />
文字列データの比較で'を値に含めたいときは''と記述してください。<br />
○where name = 'I''m a student.'<br />
×where name = 'I'm a student.'</p>
<p>検索時に大文字・小文字の区別はしません<br />
name = 'you'<br />
name = 'You'<br />
name = 'YOU'<br />
上記の検索結果の場合、大文字・小文字関係なくyouというnameを検索します。<br />
なお文字列のデータ比較の詳細は後述しています。</p>
<p>後方一致(name like '%xyz')はサポートしていません。</p>
<p>一般的なSQLでは部分一致しない場合、[not like]と記述しますが、<br />
本SQLでは[notlike]と記述します。<br />
○name notlike 'あ%'<br />
×name not like 'あ%'</p>
<p> </p>
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">
<strong>WHERE句利用時の補足</strong></div>
<p>length 秒単位<br />
// 10秒以上<br />
length >= 10<br />
// 2分以上<br />
length >= 120<br />
length >= toMinute(2)<br />
// 1時間以上<br />
length >= 3600<br />
length >= toHour(1)<br />
※to~関数についての詳細は、後述の「to~関数について」を参照してください</p>
<p>freamrate fps単位<br />
// 20fps以上<br />
freamrate >= 20</p>
<p>filesize バイト単位<br />
// 1KB以上<br />
filesize >= 1024<br />
filesize >= toKB(1)<br />
// 1MB以上(1024*1024 = 1048576 byte)<br />
filesize >= 1048576<br />
filesize >= toMB(1)<br />
// 1GB以上(1024*1024*1024 = 1073741824 byte)<br />
filesize >= 1073741824<br />
filesize >= toGB(1)<br />
※to~関数についての詳細は、後述の「to~関数について」を参照してください</p>
<p>rating 特殊設定(ratingautoも()内の数値以外は同じ)<br />
☆0 0(0)<br />
☆1 1-12(1)<br />
☆2 13-37(25)<br />
☆3 38-62(50)<br />
☆4 63-86(75)<br />
☆5 87-99(99)<br />
// ☆2つを指定(確実に取得したい場合)<br />
rating >= 13 and rating <= 37<br />
// ☆2つを指定(ratingの場合データ不整合なければこちらでもOK。ratingautoの場合は70などの場合もある)<br />
rating = 25<br />
// toStar関数で☆4以上を指定<br />
rating >= toStar(4)<br />
※to~関数についての詳細は、後述の「to~関数について」を参照してください</p>
<p>日付型(lastplayeddate, adddateなど)<br />
// 日付指定<br />
lastplayeddate >= '2011/01/01'<br />
// 日時指定<br />
lastplayeddate >= '2011/01/01 15:01:09'<br />
// today系関数で指定 ※詳細は後述の「today系関数について」を参照してください<br />
lastplayeddate >= TodayFirst()</p>
<p>現在再生中のメディアの該当する属性値を利用する<br />
// 現在再生中のメディアのアーティストの属性値を指定<br />
artist = CurrentValue()<br />
// 現在再生中のメディアの再生時間よりも長い曲を指定<br />
length >= CurrentValue()</p>
<p>ランダムな値を利用する<br />
// artistにランダムな値を設定する<br />
artist = RandomValue()</p>
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">
<strong>四則演算・()・in・between・not・サブクエリ・count(*)・max()・group
by等について</strong></div>
<p>未対応です。</p>
<p> </p>
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">
<strong>データ比較について(where句)</strong></div>
<p>データ比較は「大文字・小文字は区別しない」「全角・半角は区別する」<br />
「ひらがな、カタカナは区別する」という仕様になっています。<br />
order by句(後述)とデータ比較方法が異なるので注意してください。<br />
※where句は、MS提供コンポーネント(Queryオブジェクト)を使って<br />
データ取得を行っている為、MS仕様に準じています。<br />
※Windows8-WMP12で確認した結果なので例えばWMP11では異なる仕様<br />
となるかもしれません。</p>
<p>// 上と下は同じ結果になる<br />
where name = 'abcd'<br />
where name = 'ABcD'</p>
<p>// 上と下は別の結果になる<br />
where name = 'Aあ'<br />
where name = 'Aア'</p>
<p> </p>
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">
<strong>ソート順について(order by句)</strong></div>
<p>ソート条件は以下のようになっています。</p>
<ul><li>数値型データは数値として判定</li>
<li>真偽型データは文字として判定</li>
<li>日付型データは1970年からの経過時間を基に判定</li>
<li>文字列型データはエクスプローラに近いソート
<ul><li>・大文字・小文字を区別しない</li>
<li>・全角・半角を区別しない</li>
<li>・ひらがな、カタカナを区別しない</li>
<li>・ハイフン(-)は無視。</li>
<li>・文字列内の数値は数値として扱う。</li>
<li>・SJISコードでソート。</li>
<li>・etc.</li>
</ul></li>
</ul><p>where句(前述)とデータ比較方法が異なるので注意してください。</p>
<p>//audioのname列(文字列)に下のようなレコードがある時に...<br />
AbcdE<br />
bgm10<br />
ABCD<br />
BGM01<br />
bgm2<br />
あまい<br />
abefg<br />
かたち<br />
イス<br />
王国<br />
影(音読み:エイ、訓読み:かげ)</p>
<p>// nameを昇順ソート検索を行うと...<br />
select name from audio order by name asc</p>
<p>//こんな感じにソートされます。<br />
ABCD<br />
AbcdE<br />
abefg<br />
BGM01<br />
bgm2<br />
bgm10<br />
あまい<br />
イス<br />
かたち<br />
影(音読み:エイ、訓読み:かげ)<br />
王国</p>
<p> </p>
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">
<strong>その他の制約</strong></div>
<p> </p>
<ul><li>
WMP11以降に提供されている組込み関数を内部で使用している為、WMP11以降でなければ動作しません。※本スキンはWMP11以降にのみ対応しています。<br />
※Windows8-WMP12でのみ動作確認</li>
<li>OSとWMPとの組合せによって使用不可の列があるようです。</li>
<li>selectの列数が多い場合、プレイリスト表示で指定した列の一部が表示されない可能性があります。(WMPの仕様?)</li>
<li>初めての検索時や全件出力等の重たい処理により数分間、WMP固まる事があります。</li>
<li>
歌詞・コメントなど幾つかの列はWMPの組込み関数内でwhere句の処理ができない為、スキン側で代替処理を行っています。これら列のwhere句による条件指定は、他の列と比べて著しく処理が遅くなる場合があります。</li>
<li>
結果タブへ検索結果を出力する場合はプレイリスト出力に比べて更に処理が重くなります。取得レコード件数や表示列数が多い場合は、非常に時間がかかります。特に「タブ区切り」の場合、WMPが数分~数十分固まる程、処理時間がかかります。</li>
<li>expand句による再生リスト指定は非常に重くなることがあります。</li>
<li>実行履歴は本スキンの終了またはWindows Media Playerの終了により消去されます。</li>
<li>
システム的な制約があるため、実行したSQLを保存する機能は作らない事にしました。SQL文を残したい場合、メモ帳などを使い手動でバックアップを取ってください。</li>
</ul><p> </p>
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">
<strong>概略</strong></div>
<p>本スキンsm02ではSQL(っぽい)の構文を使ってプレイリスト作成とプレイリストの列指定ができます。<br />
SQLについて非常に大雑把に説明すると、データベース操作を行う為のデータベース言語です。<br />
Windows Media
Player(以下、WMPと略)のライブラリはデータベースみたいなものなので、SQL構文でプレイリスト作成やデータ出力機能を作ってみました。<br />
以降、SQLと記述した場合、断り書きがない限り、本スキンの独自SQLをさします。</p>
<p>SQLを知らない方にとっては、やや難解な機能かもしれません。<br />
サンプルを試してもよくわからない場合、本機能は無視してもいいと思います。<br />
既にSQLを知っている方は容易く習得できるはずですが、本スキンには独自仕様もあります。<br />
特にwhere句には独自仕様が多いので注意してください。<br />
他に独自仕様としてexpand句やoption句なんてものもあります。</p>
<p>一応ですが、本スキンの構文解析の精度が低い上に、WMPの制約や本スキンの仕様、不具合等により<br />
「このSQL文は正しいはずなのにエラーになるぞ?」<br />
「このSQL文おかしいけどエラーにならないぞ?」<br />
「このSQL文の検索結果おかしくない?」<br />
「エラーメッセージがわかりにくい!」<br />
等の事は十分起こりえます。<br />
ご了承ください。</p>
<p> </p>
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">
<strong>SQLの構文と内容</strong></div>
<p>select 列名[, 列名, ...]</p>
<p> from テーブル名<br />
where 列名 [=<>等] 値 [[and|or] 列名 [=<>等]値 ...]<br />
order by 列名 [asc|desc] [,列名 [asc|desc] ...]<br />
option タイプ [値, ...]</p>
<p>または</p>
<p>select 列名[, 列名, ...]<br />
expand 再生リスト名[, 再生リスト名, ...]<br />
where 列名 [=<>等] 値 [[and|or] 列名 [=<>等]値 ...]<br />
order by 列名 [asc|desc] [,列名 [asc|desc] ...]<br />
option タイプ [値, ...]</p>
<p><br />
◆「from テーブル名」部分<br />
ライブラリ登録されているファイルの取得元テーブルを指定します。<br />
指定できるテーブルは以下の通りです<br />
audio:音楽ファイル<br />
video:動画ファイル<br />
photo:画像ファイル<br />
playlist:プレイリスト<br />
other:その他(MIDI等)<br />
※from句とexpand句は併用できません。<br />
※expand句と異なり、テーブルは1つのみ設定可能です。</p>
<p>// 音楽ファイルを取得<br />
select name from audio</p>
<p><br />
◆「expand 再生リスト名」部分<br />
ライブラリ登録されている再生リスト、再生中のプレイリスト、ブックマーク等を取得元に指定します。<br />
指定できるパターンは以下の通りです。<br />
・登録済の再生リスト名 (''で囲ってください)<br />
・all (固定値:登録済の全ての再生リスト)<br />
・random (固定値:登録済の再生リストからランダム)<br />
・current (固定値:現在再生中のプレイリスト)<br />
・playlistview (固定値:SQL検索画面のプレイリストビューに設定されたプレイリスト)<br />
・bookmark1~20(固定値:ブックマーク1~ブックマーク20を含むプレイリスト)<br />
・stackboard (固定値:スタックボード)<br />
※from句とexpand句は併用できません。<br />
※同じファイルが複数個所に登録されている場合、マージされ1つになります。</p>
<p>// 「BestMusic」という再生リストからデータを取得<br />
select name expand 'BestMusic'</p>
<p>// 「My List」という再生リストを<br />
select name expand 'My List'</p>
<p>// 「GoodSong」「BetterSong」という再生リストからデータを取得<br />
select name expand 'GoodSong', 'BetterSong'</p>
<p>// 「洋楽」から始まる再生リストからデータを取得<br />
select name expand '洋楽%'</p>
<p>// 「2014」を含む再生リストからデータを取得<br />
select name expand '%2014%'</p>
<p>// 全ての再生リストからデータを取得<br />
select name expand all</p>
<p>//ランダムな 再生リストからデータを取得<br />
select name expand random</p>
<p>// 再生中のプレイリストからデータを取得<br />
select name expand current</p>
<p>// SQL検索画面のプレイリストビューに設定されたのプレイリストリストからデータを取得<br />
select name expand playlistview</p>
<p>// 1番目のブックマークを含むプレイリストからデータを取得<br />
select name expand bookmark1</p>
<p>// 15番目のブックマークを含むプレイリストからデータを取得<br />
select name expand bookmark15</p>
<p>// スタックボードからデータを取得<br />
select name expand stackboard</p>
<p><br />
◆「select 列名,[, 列名, ...]」部分<br />
プレイリストに表示する列です。<br />
ファイル出力の場合は出力する列です。<br />
列名は","区切りで複数登録できます。</p>
<p>// 全ての音楽ファイルを取得し、name, length列を表示<br />
select name, length from audio</p>
<p>列名の代わりに"*"を指定できます。<br />
"*"を指定した場合は、テーブル毎に組み込んだ列を表示します。<br />
(※一般的なSQLでは指定テーブルの全列を表示しますが、本SQLは異なります)</p>
<p>// * を使う<br />
select * from audio</p>
<p>また列にconvert関数が利用できます。※詳細は後述の「convert関数について」を参照してください</p>
<p>またas句を使うと列に別名を設定できます。<br />
別名内にスペース( )やカンマ(,)を使う場合は別名を''で囲ってください。</p>
<p>// name, lengthに別名を付ける<br />
select name as タイトル, length as 時間 from audio<br />
// name, lengthに別名を付ける(スペースやカンマを使う)<br />
select name as 'なまえ,です', length as 'さいせい 時間', rating as '☆は''あなたの評価''です' from
audio</p>
<p><br />
◆「order by 列名 [asc|desc] [,列名 [asc|desc] ...]」部分<br />
取得レコードのソート条件を指定します。<br />
省略が可能です。<br />
省略した場合はソートされません。<br />
列名の後ろにascを指定すれば昇順、descを指定すれば降順にソートされます。<br />
asc|descが未設定の場合は昇順にソートされます。<br />
カンマ記号","で列を区切れば複数のソート条件が設定できます。</p>
<p>// nameを昇順でソート<br />
order by name<br />
order by name asc</p>
<p>// nameを降順でソート<br />
order by name desc</p>
<p>// albumを昇順でソート、nameを降順でソート<br />
order by album asc, name desc</p>
<p>特殊なソートとして[order by shuffle]または[order by random]、[order by reverse]があります。<br />
[order by shuffle]または[order by random]を使うとランダムなソートを行います。<br />
[order by reverse]を使うとソート結果を逆順にします。<br />
randomとshuffleの違いによる機能の違いはありません。</p>
<p>// シャッフル(ランダム)ソート<br />
order by shuffle<br />
order by random</p>
<p>// 逆順に並べ替える<br />
order by reverse</p>
<p> </p>
<p>◆「where 列名 [=<>等] 値 [[and|or] 列名 [=<>等]値 ...]」部分<br />
取得レコードの絞り込み条件を指定します。<br />
where句は省略が可能です。<br />
省略した場合、対象テーブルの全レコードが取得されます。<br />
「name = 'hoge'」や「playcount > 10」のように条件を指定します。</p>
<p>「列名 演算子(=等) 値」の比較のみ対応しており、「値 = 列名」や<br />
「列名1 = 列名2」のような比較はできません。</p>
<p><br />
列ごとにデータ型と範囲を持っています。<br />
データ型にはnumber(数値),string(文字列),date(日時),boolean(真偽)があります。<br />
文字列型は「列名='値'」のように値を''で囲んでください。<br />
日付型は「列名='2001/10/01'」や「列名='2001/10/01 22:00:00'」のように<br />
値を''で囲み、かつ'yyyy/mm/dd'または'yyyy/mm/dd 24hh:mm:ss'形式で<br />
記述してください。<br />
真偽型は「列名=true」または「列名=false」のように記述してください。</p>
<p>データ型によって利用できる比較演算子が異なります。<br />
数値(=,<>,<=,<.>=.>)<br />
文字列(=,<>,like,notlike)<br />
日付(=,<>,<=,<.>=.>)<br />
真偽(=,<>)<br />
このほかに(is,isnot)が全てのデータ型で利用できます。<br />
(is,isnot)は後述のnullで説明します。</p>
<p>// nameがhoge<br />
where name='hoge'</p>
<p>// playcountが10でない<br />
where playcount<>10</p>
<p>// releasedateが'2010/01/01 13:00:00'以上<br />
where releasedate>='2010/01/01 13:00:00'</p>
<p>// releasedateが'2010/01/01 00:00:00'より大きい<br />
where releasedate>'2010/01/01'</p>
<p>// nameが'い'から始まる。<br />
where name like 'い%'</p>
<p>// nameが'い'から始まらない<br />
where name notlike 'い%'</p>
<p>// urlに'rock'が含まれている<br />
where url like '%rock%'</p>
<p>特別な比較値としてnullがあります。<br />
この値は"データが存在しない"事を表しています。<br />
全てのデータ型で利用できますが、指定可能な比較演算子isまたはisnotだけです。</p>
<p>// データが未設定のreleasedateだけ取得<br />
where releasedate is null</p>
<p>// データが設定されているartistだけ取得<br />
where artist isnot null</p>
<p>なお文字列の場合は「column = ''」と「column is null」は同じ結果になります。</p>
<p>// 2つは同じ結果となる。<br />
where album is null<br />
where album = ''</p>
<p>where album isnot null<br />
where album <> ''</p>
<p>複数の条件を設定する場合はandまたはorを使います。<br />
論理演算子はand > orの優先順位です。<br />
3つ以上の条件を設定する場合は優先順位に気を付けてください。<br />
本スキンでは()が未対応です。</p>
<p>// playcountが10以上かつplaycountが20未満のレコードを検索<br />
where playcount >= 10 and playcount < 20</p>
<p>// playcountが30以上またはratingが99のレコードを取得<br />
where playcount >= 30 or rating = 99</p>
<p>// 「playcountが30以上」または「ratingが99かつnameが'あ'で始まる」レコードを取得<br />
where playcount >= 30 or rating = 99 and name like 'あ%'</p>
<p>// 「ratingが0より大きく50以下かつnameが'b'で始まる」または「ratingが99かつnameが'a'で始まる」<br />
// レコードを取得<br />
where rating > 0 and rating <= 50 and name like 'b%' or rating = 99 and
name like 'a%'</p>
<p><br />
◆「option [totallength|top | limit | randomselectfrom | expandplaylist] [値,
...]」部分<br />
取得レコードに対するオプション操作を指定します。<br />
省略が可能です。</p>
<p>・totallength<br />
先頭レコードから合計再生時間[秒]指定による取得レコードの絞込み。<br />
where句・order by句が設定している場合、その検索結果に対して<br />
絞り込みを行います。</p>
<p>// 取得レコードの合計再生時間を1時間(3600秒)以下に絞り込みます。<br />
option totallength 3600<br />
option totallength toMinute(60)<br />
option totallength toHour(1)</p>
<p>・top<br />
先頭レコードから件数指定による取得レコードの絞込み。<br />
where句・order by句が設定している場合、その検索結果に対して<br />
絞り込みを行います。</p>
<p>// 先頭レコードから20件取得します。<br />
option top 20</p>
<p>・limit<br />
先頭レコードから位置指定[0始まり]、件数指定のによる取得レコードの絞込み。<br />
where句・order by句が設定している場合、その検索結果に対して<br />
絞り込みを行います。</p>
<p>// 3件目のレコードから10件取得します。<br />
option limit 2, 10 ※3, 10ではありません! "0,1,2"で3件目のレコード</p>
<p>・randomselectfrom 列名<br />
指定列名のランダムな値を使った取得レコードの絞込み。<br />
where句・order by句が設定している場合、その検索結果に対して<br />
絞り込みを行います。<br />
※後述のRandomValue()の説明も別途参照してください。</p>
<p>// album列に存在するランダムな値を基に、取得レコードを絞り込む<br />
option randomselectfrom album</p>
<p>// artist列に存在するランダムな値を基に、取得レコードを絞り込む<br />
option randomselectfrom artist</p>
<p>・expandplaylist<br />
from playlistを指定したとき限定。<br />
selectを実行すると通常はメディアファイルが取得されますが、<br />
from playlistの場合は、プレイリストを頂点とするツリー構造にメディアファイルが<br />
配置されています。<br />
このプレイリストを通常のselectと同じようにフラットな状態に展開します</p>
<p>// from playlistで全てのプレイストを取得し、取得したプレイリストを展開します。<br />
select * from playlist option expandplaylist</p>
<p>// from playlistで全てのプレイストを取得(option expandplaylistを使わない場合)<br />
// ※↑のSQLと実行結果を比較してみてください。<br />
select * from playlist</p>
<p> </p>
<p>-------------------------------------<br />
レコードの抽出条件の注意点や制約<br />
-------------------------------------<br />
<条件式の記述順><br />
[列名][比較演算子][値]の順で記述してください。<br />
一般的なSQLでは、[値][比較演算子][列名]や[列名][比較演算子][列名]<br />
などの可能ですが、本スキンは未対応です。</p>
<p>○where name = 'aaa'<br />
×where 'aaa' = name<br />
×where name = album</p>
<p><複数条件設定について><br />
現機能では()に未対応です。<br />
論理演算子はand > orの優先順位です。<br />
○where name='aaa'<br />
○where name='aaa' and playcount>10<br />
○where name='aaa' or name='bbb'<br />
○where name='aaa' or name='bbb' and playcount>10<br />
×where (name='aaa' or name='bbb') and playcount>10 // ()に未対応</p>
<p><null比較><br />
一般的なSQLではnullでない場合、[is not]と記述しますが<br />
本SQLでは[isnot]と記述します。<br />
○where name isnot null<br />
×where name is not null</p>
<p><文字列><br />
文字列データの比較で'を値に含めたいときは''と記述してください。<br />
○where name = 'I''m a student.'<br />
×where name = 'I'm a student.'</p>
<p>検索時に大文字・小文字の区別はしません<br />
name = 'you'<br />
name = 'You'<br />
name = 'YOU'<br />
上記の検索結果の場合、大文字・小文字関係なくyouというnameを検索します。<br />
なお文字列のデータ比較の詳細は後述しています。</p>
<p>後方一致(name like '%xyz')はサポートしていません。</p>
<p>一般的なSQLでは部分一致しない場合、[not like]と記述しますが、<br />
本SQLでは[notlike]と記述します。<br />
○name notlike 'あ%'<br />
×name not like 'あ%'</p>
<p> </p>
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">
<strong>WHERE句利用時の補足</strong></div>
<p>length 秒単位<br />
// 10秒以上<br />
length >= 10<br />
// 2分以上<br />
length >= 120<br />
length >= toMinute(2)<br />
// 1時間以上<br />
length >= 3600<br />
length >= toHour(1)<br />
※to~関数についての詳細は、後述の「to~関数について」を参照してください</p>
<p>freamrate fps単位<br />
// 20fps以上<br />
freamrate >= 20</p>
<p>filesize バイト単位<br />
// 1KB以上<br />
filesize >= 1024<br />
filesize >= toKB(1)<br />
// 1MB以上(1024*1024 = 1048576 byte)<br />
filesize >= 1048576<br />
filesize >= toMB(1)<br />
// 1GB以上(1024*1024*1024 = 1073741824 byte)<br />
filesize >= 1073741824<br />
filesize >= toGB(1)<br />
※to~関数についての詳細は、後述の「to~関数について」を参照してください</p>
<p>rating 特殊設定(ratingautoも()内の数値以外は同じ)<br />
☆0 0(0)<br />
☆1 1-12(1)<br />
☆2 13-37(25)<br />
☆3 38-62(50)<br />
☆4 63-86(75)<br />
☆5 87-99(99)<br />
// ☆2つを指定(確実に取得したい場合)<br />
rating >= 13 and rating <= 37<br />
// ☆2つを指定(ratingの場合データ不整合なければこちらでもOK。ratingautoの場合は70などの場合もある)<br />
rating = 25<br />
// toStar関数で☆4以上を指定<br />
rating >= toStar(4)<br />
※to~関数についての詳細は、後述の「to~関数について」を参照してください</p>
<p>日付型(lastplayeddate, adddateなど)<br />
// 日付指定<br />
lastplayeddate >= '2011/01/01'<br />
// 日時指定<br />
lastplayeddate >= '2011/01/01 15:01:09'<br />
// today系関数で指定 ※詳細は後述の「today系関数について」を参照してください<br />
lastplayeddate >= TodayFirst()</p>
<p>現在再生中のメディアの該当する属性値を利用する<br />
// 現在再生中のメディアのアーティストの属性値を指定<br />
artist = CurrentValue()<br />
// 現在再生中のメディアの再生時間よりも長い曲を指定<br />
length >= CurrentValue()</p>
<p>ランダムな値を利用する<br />
// artistにランダムな値を設定する<br />
artist = RandomValue()</p>
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">
<strong>四則演算・()・in・between・not・サブクエリ・count(*)・max()・group
by等について</strong></div>
<p>未対応です。</p>
<p> </p>
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">
<strong>データ比較について(where句)</strong></div>
<p>データ比較は「大文字・小文字は区別しない」「全角・半角は区別する」<br />
「ひらがな、カタカナは区別する」という仕様になっています。<br />
order by句(後述)とデータ比較方法が異なるので注意してください。<br />
※where句は、MS提供コンポーネント(Queryオブジェクト)を使って<br />
データ取得を行っている為、MS仕様に準じています。<br />
※Windows8-WMP12で確認した結果なので例えばWMP11では異なる仕様<br />
となるかもしれません。</p>
<p>// 上と下は同じ結果になる<br />
where name = 'abcd'<br />
where name = 'ABcD'</p>
<p>// 上と下は別の結果になる<br />
where name = 'Aあ'<br />
where name = 'Aア'</p>
<p> </p>
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">
<strong>ソート順について(order by句)</strong></div>
<p>ソート条件は以下のようになっています。</p>
<ul><li>数値型データは数値として判定</li>
<li>真偽型データは文字として判定</li>
<li>日付型データは1970年からの経過時間を基に判定</li>
<li>文字列型データはエクスプローラに近いソート
<ul><li>・大文字・小文字を区別しない</li>
<li>・全角・半角を区別しない</li>
<li>・ひらがな、カタカナを区別しない</li>
<li>・ハイフン(-)は無視。</li>
<li>・文字列内の数値は数値として扱う。</li>
<li>・SJISコードでソート。</li>
<li>・etc.</li>
</ul></li>
</ul><p>where句(前述)とデータ比較方法が異なるので注意してください。</p>
<p>//audioのname列(文字列)に下のようなレコードがある時に...<br />
AbcdE<br />
bgm10<br />
ABCD<br />
BGM01<br />
bgm2<br />
あまい<br />
abefg<br />
かたち<br />
イス<br />
王国<br />
影(音読み:エイ、訓読み:かげ)</p>
<p>// nameを昇順ソート検索を行うと...<br />
select name from audio order by name asc</p>
<p>//こんな感じにソートされます。<br />
ABCD<br />
AbcdE<br />
abefg<br />
BGM01<br />
bgm2<br />
bgm10<br />
あまい<br />
イス<br />
かたち<br />
影(音読み:エイ、訓読み:かげ)<br />
王国</p>
<p> </p>
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">
<strong>その他の制約</strong></div>
<p> </p>
<ul><li>
WMP11以降に提供されている組込み関数を内部で使用している為、WMP11以降でなければ動作しません。※本スキンはWMP11以降にのみ対応しています。<br />
※Windows8-WMP12でのみ動作確認</li>
<li>OSとWMPとの組合せによって使用不可の列があるようです。</li>
<li>selectの列数が多い場合、プレイリスト表示で指定した列の一部が表示されない可能性があります。(WMPの仕様?)</li>
<li>初めての検索時や全件出力等の重たい処理により数分間、WMP固まる事があります。</li>
<li>
歌詞・コメントなど幾つかの列はWMPの組込み関数内でwhere句の処理ができない為、スキン側で代替処理を行っています。これら列のwhere句による条件指定は、他の列と比べて著しく処理が遅くなる場合があります。</li>
<li>
結果タブへ検索結果を出力する場合はプレイリスト出力に比べて更に処理が重くなります。取得レコード件数や表示列数が多い場合は、非常に時間がかかります。特に「タブ区切り」の場合、WMPが数分~数十分固まる程、処理時間がかかります。</li>
<li>expand句による再生リスト指定は非常に重くなることがあります。</li>
<li>実行履歴は本スキンの終了またはWindows Media Playerの終了により消去されます。</li>
<li>
システム的な制約があるため、実行したSQLを保存する機能は作らない事にしました。SQL文を残したい場合、メモ帳などを使い手動でバックアップを取ってください。</li>
</ul><p> </p>