wordpressのget_resultsとqueryの違いとは？

Question

wordpressのget_resultsとqueryの違いとはなんでしょうか？
どういう使い分けを想定されているのでしょうか？

思いついたものとしては、

複数レコードを取得したいときはget_resultsを使う↓

// 複数レコードを取得
global $wpdb;
$query = "SELECT * FROM $wpdb->posts WHERE name='鈴木';"; // name は非ユニーク
$rows = $wpdb->get_results($query, ARRAY_A);
foreach($rows as $row) {
   $id = $row['ID'];
   echo $id ;
}

そして、単一カラムの値や、COUNTした件数など単一の値を取得したいときはqueryを使う↓

// 単一カラムの値を取得
global $wpdb;
$query = "SELECT ID FROM $wpdb->posts WHERE name='鈴木';"; // name はユニーク
$val = $wpdb->query($query, ARRAY_A);
echo $val;

// COUNTした件数を取得
global $wpdb;
$query = "SELECT COUNT(*) FROM $wpdb->posts WHERE name='鈴木';"; // name は非ユニーク
$val = $wpdb->query($query, ARRAY_A);
echo $val;

という風な使い分けになるのかな？と考えたのですが、こんな感じでしょうか？
実際にご活用なさっている方のご意見をうかがえましたら幸いです。

Answer 1

get_results()は内部的にはquery()を使っています

データの変更がしたいのであって結果が欲しいわけではないクエリ
COUNTに限らず欲しい結果が行ではないクエリというのはままあります

insert,replace,update,deleteなどであっても
wpdbに備わっているメソッドでは対応できないような処理もあります

そういうのにquery使います

Comments

[gakkie]

ありがとうございます！

・データ変更の場合
・行が欲しいわけではない場合
にqueyrが適当で、

逆に言えば
・行の取得の場合
にget_resultsという理解でよさそうでしょうか。

[KazuhiroHatano]

行の取得をしたいならget_resultsって理解でおよそ良いと思います

ソースを見た方が使い分け方がわかるかもしれません

https://core.trac.wordpress.org/browser/tags/5.6/src/wp-includes/wp-db.php#L2671

[gakkie]

こういう方はソースから掘っていくのですね。ありがとうございます。勉強になりました。