全部產品
Search
文件中心

Simple Log Service:通過PHP SDK使用SQL獨享版

更新時間:Jun 30, 2024

本文介紹通過PHP SDK使用SQL獨享版的程式碼範例。

前提條件

  • 已建立RAM使用者並完成授權。具體操作,請參見建立RAM使用者並完成授權

  • 已配置環境變數ALIBABA_CLOUD_ACCESS_KEY_IDALIBABA_CLOUD_ACCESS_KEY_SECRET。具體操作,請參見在Linux、macOS和Windows系統配置環境變數

    重要
    • 阿里雲帳號的AccessKey擁有所有API的存取權限,建議您使用RAM使用者的AccessKey進行API訪問或日常營運。

    • 強烈建議不要把AccessKey ID和AccessKey Secret儲存到工程代碼裡,否則可能導致AccessKey泄露,威脅您帳號下所有資源的安全。

  • 已完成PHP SDK安裝。更多資訊,請參見安裝PHP SDK

背景資訊

Log Service提供SQL獨享版,用於增強SQL分析能力,支援千億行資料的計算。更多資訊,請參見開啟SQL獨享版

Log Service提供Aliyun_Log_Models_LogStoreSqlRequest介面和Aliyun_Log_Models_ProjectSqlRequest介面,協助您更簡單的使用SQL獨享版。

  • Aliyun_Log_Models_LogStoreSqlRequest介面:在指定Logstore中使用SQL獨享版。該介面支援的查詢和分析文法相容標準的SQL92文法,格式為查詢語句|分析語句,其中分析語句採用標準的SQL92文法。

  • Aliyun_Log_Models_ProjectSqlRequest介面:在指定Project中使用SQL獨享版。該介面支援的查詢和分析文法為標準的SQL92文法,即您的過濾條件和查詢時間要寫在SQL分析語句的WHERE語句中。

說明

如果您執行分析操作時,需要先過濾一部分資料再分析,建議您使用查詢語句|分析語句文法,效率更高,即推薦使用Aliyun_Log_Models_LogStoreSqlRequest介面。

程式碼範例

程式碼範例如下,更多資訊,請參見Aliyun Log PHP SDK

<?PHP
require_once realpath(dirname(__FILE__) . './aliyun-log-php-sdk-master/Log_Autoload.php');
class test
{

    public static function main()
    {
        // Log Service的服務入口。此處以杭州為例,其它地區請根據實際情況填寫。
        $endpoint = 'cn-hangzhou.log.aliyuncs.com';
        // 本樣本從環境變數中擷取AccessKey ID和AccessKey Secret。
        $accessKeyId = getenv('ALIBABA_CLOUD_ACCESS_KEY_ID');
        $accessKey = getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET');
        // Project名稱。
        $project = 'aliyun-test-project';
        // Logstore名稱。
        $logstore = 'aliyun-test-logstore';
        // STS token。
        $token = '';
        // 建立Log ServiceClient。
        $client = new Aliyun_Log_Client($endpoint, $accessKeyId, $accessKey, $token);

        // 在指定的Logstore內執行SQL分析。  
        $from = time() - 3600;
        $to = time();
        $query = "* | select count(0)";
        $request = new Aliyun_Log_Models_LogStoreSqlRequest($project, $logstore, $from, $to, $query, true);
        try {
            $response = $client->executeLogStoreSql($request);
            foreach ($response->getLogs() as $log) {
                print $log->getTime() . "\t";
                foreach ($log->getContents() as $key => $value) {
                    print $key . ":" . $value . "\t";
                }
                print "\n";
            }
            // 列印計算結果的統計資訊。
            // 處理的日誌行數。
            print "proccesedRows:" . $response->getProcessedRows() . "\n";
            // SQL分析執行的時間長度。
            print "elapsedMilli:" . $response->getElapsedMilli() . "\n";
            // 開啟SQL獨享版後,執行SQL分析所花費的CPU時間,單位為秒。SQL獨享版按照CPU時間計費,更多資訊,請參見計費項目。
            print "cpuSec:" . $response->getCpuSec() . "\n";
            // 開啟SQL獨享版後,執行SQL分析所使用的CPU核心數。
            print "cpuCores:" . $response->getCpuCores() . "\n";

        } catch (Aliyun_Log_Exception $ex) {
            logVarDump($ex);
        } catch (Exception $ex) {
            logVarDump($ex);
        }

        // 在指定的Project內執行SQL分析。
        $query = "select count(0) from gs-api where __time__ > to_unixtime(now()) - 300 and __time__ < to_unixtime(now())";
        $request = new Aliyun_Log_Models_ProjectSqlRequest($project, $query, True);
        try {
            $response = $client->executeProjectSql($request);
            #$response = $client->getProjectLogs($request);
            foreach ($response->getLogs() as $log) {
                print $log->getTime() . "\t";
                foreach ($log->getContents() as $key => $value) {
                    print $key . ":" . $value . "\t";
                }
                print "\n";
            }
            // 列印計算結果的統計資訊。
            // 處理的日誌行數。
            print "proccesedRows:" . $response->getProcessedRows() . "\n";
            // SQL分析執行的時間長度。
            print "elapsedMilli:" . $response->getElapsedMilli() . "\n";
            // 開啟SQL獨享版後,執行SQL分析所花費的CPU時間,單位為秒。SQL獨享版按照CPU時間計費,更多資訊,請參見計費項目。
            print "cpuSec:" . $response->getCpuSec() . "\n";
            // 開啟SQL獨享版後,執行SQL分析所使用的CPU核心數。
            print "cpuCores:" . $response->getCpuCores() . "\n";
            print "requestId:" . $response->getRequestId() . "\n";

        } catch (Aliyun_Log_Exception $ex) {
            logVarDump($ex);
        } catch (Exception $ex) {
            logVarDump($ex);
        }
    }
}
test::main();
  • Aliyun_Log_Models_LogStoreSqlRequest介面

    調用Aliyun_Log_Models_LogStoreSqlRequest介面使用SQL獨享版,介面格式為:

    $from = time()-3600;
    $to = time();
    $query = "* | select count(0)";
    $request = new Aliyun_Log_Models_LogStoreSqlRequest($project,$logstore,$from,$to,$query,$powerSql);

    各個參數說明如下表所示。

    參數名稱

    類型

    是否必選

    樣本

    說明

    $project

    String

    不涉及

    Project名稱。

    在建立Client時,已定義$project,此處無需配置。

    $logstore

    String

    不涉及

    Logstore名稱。

    在建立Client時,已定義$logstore,此處無需配置。

    $from

    Long

    time()-3600

    查詢起始時間。Unix時間戳記格式,表示從1970-1-1 00:00:00 UTC計算起的秒數。

    $to

    Long

    time()

    查詢結束時間點。Unix時間戳記格式,表示從1970-1-1 00:00:00 UTC計算起的秒數。

    $query

    String

    "* | select count(method)"

    Log Service查詢和分析語句,格式為查詢語句|分析語句。更多資訊,請參見基礎文法

    Log Service預設返回100行結果,您也可以使用LIMIT子句指定返回結果的行數。更多資訊,請參見LIMIT子句

    $powerSql

    Boolean

    true

    是否使用SQL獨享版。更多資訊,請參見開啟SQL獨享版

    • true:使用SQL獨享版。

    • false(預設值):使用SQL普通版。

  • Aliyun_Log_Models_ProjectSqlRequest介面

    調用Aliyun_Log_Models_ProjectSqlRequest介面使用SQL獨享版,介面格式如下:

    $query = "select count(0) from sls_operation_log where __time__ > to_unixtime(now()) - 300 and __time__ < to_unixtime(now())";
    $request = new Aliyun_Log_Models_ProjectSqlRequest($project,$query,$powerSql);   

    各個參數說明如下表所示。

    參數名稱

    類型

    是否必選

    樣本

    說明

    $project

    String

    不涉及

    Project名稱。

    在建立Client時,已定義$project,此處無需配置。

    $query

    String

    " select count(method) from sls_operation_log where __time__ > to_unixtime(now()) - 300 and __time__ < to_unixtime(now())"

    標準的SQL語句,即您的過濾條件和查詢時間要寫在SQL分析語句的WHERE語句中。

    Log Service預設返回100行結果,您也可以使用LIMIT子句指定返回結果的行數。更多資訊,請參見LIMIT子句

    $powerSql

    Boolean

    true

    是否使用SQL獨享版。更多資訊,請參見開啟SQL獨享版

    • true:使用SQL獨享版。

    • false(預設值):使用SQL普通版。