在查询中使用时间戳函数

可以对“时间戳”和“持续时间”值执行各种算术运算。

如果要跟进示例,请参阅运行查询的示例数据以查看示例数据并使用脚本加载示例数据进行测试。这些脚本将创建示例中使用的表,并将数据加载到表中。

如果要跟进示例,请参阅运行查询的示例数据以查看示例数据,并了解如何使用 OCI 控制台创建示例表和使用 JSON 文件加载数据。

提取表达

EXTRACT 表达式从时间戳中提取组件。

extract_expression ::= EXTRACT "(" id FROM expression ")"

FROM 关键字后的表达式最多只能返回一个时间戳或 NULL。如果此表达式的结果为 NULL 或空,则 EXTRACT 的结果也分别为 NULL 或空。否则,将返回 ID 指定的组件。此 ID 必须是以下关键字之一:YEAR、MONTH、DAY、HOUR、MINUTE、SECOND、MILLISECOND、MICROSECOND、NANOSECOND、WEEK、ISOWEEK。

示例 1:票号为 1762383911861 的客户的全名和行李到达年份是什么。

SELECT fullName,
EXTRACT (YEAR FROM CAST (bag.bagInfo.bagArrivalDate AS Timestamp(0)))
AS YEAR FROM BaggageInfo bag
WHERE ticketNo=1762383911861

解释:首先使用 CAST 将 bagArrivalDate 转换为 TIMESTAMP,然后从时间戳中提取 YEAR 组件。

输出:

{"fullName":"Joanne Diaz","YEAR":2019}

示例 2:检索 2019 年 2 月 10:00 至 10:00 之间通过 MIA 旅行的所有袋子。

SELECT bag.bagInfo[].tagNum,bag.bagInfo[].flightLegs[].fltRouteSrc,
$t1 AS HOUR FROM BaggageInfo bag,
EXTRACT(HOUR FROM CAST (bag.bagInfo[0].bagArrivalDate AS Timestamp(0))) $t1,
EXTRACT(YEAR FROM CAST (bag.bagInfo[0].bagArrivalDate AS Timestamp(0))) $t2,
EXTRACT(MONTH FROM CAST (bag.bagInfo[0].bagArrivalDate AS Timestamp(0))) $t3
WHERE bag.bagInfo[].flightLegs[].fltRouteSrc=any "MIA" AND
$t2=2019 AND $t3=02 AND ($t1>10 AND $t1<20)

解释:您想知道 2019 年 2 月 10:00 至 10:00 之间通过 MIA 飞行的航班的详细信息。您在此处使用多个筛选条件。首先,飞行应该起源或穿越 MIA。抵达年份应为 2019 年,到达月份应为 2(二月)。然后,如果到达的小时在上午 10:00 到晚上 10:00(20 小时)之间,则进行筛选。

输出:

{"tagNum":"17657806255240","fltRouteSrc":["MIA","LAX"],"HOUR":16}
{"tagNum":"17657806292518","fltRouteSrc":["MIA","LAX"],"HOUR":16}

示例 3:预订代码为 PQ1M8N 的乘客在哪一年和哪一年收到行李?

SELECT fullName,
EXTRACT(YEAR FROM CAST (bag.bagInfo.bagArrivalDate AS Timestamp(0))) AS YEAR,
EXTRACT(MONTH FROM CAST (bag.bagInfo.bagArrivalDate AS Timestamp(0))) AS MONTH
FROM BaggageInfo bag WHERE bag.confNo="PQ1M8N"

解释:您首先使用 CAST 将 bagArrivalDate 转换为 TIMESTAMP,然后从时间戳中提取 YEAR 组件和 MONTH 组件。

输出:

{"fullName":"Kendal Biddle","YEAR":2019,"MONTH":3}

示例 4:根据到达月份对行李数据进行分组,并显示当月到达的行李数。

SELECT EXTRACT(MONTH FROM CAST ($bag_arr_date AS Timestamp(0))) AS MONTH,
count(EXTRACT(MONTH FROM CAST ($bag_arr_date AS Timestamp(0)))) AS COUNT
FROM BaggageInfo $bag, $bag.bagInfo[].bagArrivalDate $bag_arr_date
GROUP BY EXTRACT(MONTH FROM CAST ($bag_arr_date AS Timestamp(0)))

解释:您希望根据行李到达的月份对数据进行分组。使用不嵌套数组来平整数据。bagInfo 数组是展平的,从数组中提取袋到达日期的值。然后,使用 CAST 将 bagArrivalDate 转换为 TIMESTAMP,然后从时间戳中提取 YEAR 组件和 MONTH 组件。然后,使用 count 函数获取每月对应的总行李数。

注意:数据中的一种假设是,所有行李都在同一年到达。因此,您仅根据月份对数据进行分组。

输出:

{"MONTH":2,"COUNT":11}
{"MONTH":3,"COUNT":10}

timestamp_add() 函数

将持续时间添加到时间戳值并返回新时间戳。持续时间可以为正,也可以为负。结果类型为 TIMESTAMP(9)

语法:

TIMESTAMP(9) timestamp_add(TIMESTAMP timestamp, STRING duration)

语义

注: UNIT 关键字不区分大小写。

示例 1:在航空公司应用程序中,延迟 5 分钟的缓冲区被视为“准时”。对于票号为 1762399766476 的乘客,在第一端打印估计到达时间,缓冲区为 5 分钟。

SELECT timestamp_add(bag.bagInfo.flightLegs[0].estimatedArrival, "5 minutes")
AS ARRIVAL_TIME FROM BaggageInfo bag
WHERE ticketNo=1762399766476

解释:在航空公司应用程序中,客户可以有任意数量的航班行程,具体取决于源和目的地。在上面的查询中,您将提取估计到达的行程的“第一段”。因此,将提取 flightsLeg 数组的第一个记录,并从该数组中提取 estimatedArrival 时间,并向其添加一个 "5 minutes" 的缓冲区并显示该时间。

输出:

{"ARRIVAL_TIME":"2019-02-03T06:05:00.000000000Z"}

注:

estimatedArrival 是字符串。如果列具有 ISO-8601 格式的 STRING 值,则该列将由 SQL 运行时自动转换为 TIMESTAMP 数据类型。

ISO8601 描述了国际公认的表示日期、时间和持续时间的方式。

语法:带有时间的日期:YYYY-MM-DDThh:mm:ss[.s[s[s[s[s[s]]]][Z|(+|-)hh:mm]

其中

示例 1a:为票号为 1762399766476 的乘客打印每条腿的估计到达时间,缓冲区为 5 分钟。

SELECT $s.ticketno, $value as estimate,
timestamp_add($value, '5 minute') AS add5min
FROM baggageinfo $s,
$s.bagInfo.flightLegs.estimatedArrival as $value
WHERE ticketNo=1762399766476

解释:您希望在每个行程上显示 estimatedArrival 时间。每个客户的腿数可以不同。因此,在上面的查询中使用变量引用,并且不嵌套 baggageInfo 数组和 flightLegs 数组来执行查询。

输出:

{"ticketno":1762399766476,"estimate":"2019-02-03T06:00:00Z",
"add5min":"2019-02-03T06:05:00.000000000Z"}
{"ticketno":1762399766476,"estimate":"2019-02-03T08:22:00Z",
"add5min":"2019-02-03T08:27:00.000000000Z"}

示例 2:上周到达了多少个袋子?

SELECT count(*) AS COUNT_LASTWEEK FROM baggageInfo bag
WHERE EXISTS bag.bagInfo[$element.bagArrivalDate < current_time()
AND $element.bagArrivalDate > timestamp_add(current_time(), "-7 days")]

解释:您获取航空公司应用程序在上周处理的袋子的计数。一个客户可以有多个包(即 bagInfo 数组可以有多个记录)。bagArrivalDate 的值应介于今天和过去 7 天之间。对于 bagInfo 数组中的每条记录,您需要确定袋子到达时间是否介于现在和一周前之间。函数 current_time 现在为您提供了时间。EXISTS 条件用作用于确定包是否在上周有到达日期的筛选器。count 函数确定此时段内的袋子总数。

输出:

{"COUNT_LASTWEEK":0}

示例 3:查找在接下来的 6 小时内到达的袋子数。

SELECT count(*) AS COUNT_NEXT6HOURS FROM baggageInfo bag
WHERE EXISTS bag.bagInfo[$element.bagArrivalDate > current_time()
AND $element.bagArrivalDate < timestamp_add(current_time(), "6 hours")]

解释:您将得到航空公司应用程序将在未来 6 小时内处理的袋子的计数。客户可以有多个包(即 bagInfo 数组可以有多个记录)。bagArrivalDate 应介于当前时间与接下来的 6 小时之间。对于 bagInfo 数组中的每条记录,您需要确定袋子到达时间是否介于现在和六小时后之间。函数 current_time 现在为您提供了时间。EXISTS 条件用作用于确定包是否在接下来的六个小时内具有到达日期的筛选器。count 函数确定此时段内的袋子总数。

输出:

{"COUNT_NEXT6HOURS":0}

timestamp_diff() 和 get_duration() 函数

timestamp_diff()

返回两个时间戳值之间的毫秒数。结果类型为 LONG

语法:

LONG timestamp_diff(TIMESTAMP timestamp1, TIMESTAMP
      timestamp2)

语义:

get_duration()

将给定毫秒数转换为持续时间字符串。结果类型为 STRING

语法:

STRING get_duration(LONG duration_millis)

语义:

示例:

示例 1:行李在一条腿上登机并到达票号为 1762355527825 的乘客的下一行程之间的持续时间是多少?

SELECT $s.ticketno, $bagInfo.bagArrivalDate, $flightLeg.flightDate,
get_duration(timestamp_diff($bagInfo.bagArrivalDate, $flightLeg.flightDate)) AS diff
FROM baggageinfo $s,
$s.bagInfo[] AS $bagInfo, $bagInfo.flightLegs[] AS $flightLeg
WHERE ticketNo=1762355527825

解释:在航空公司应用程序中,每个客户在其源和目标之间可以有不同数量的跃点/跃点。在此查询中,确定每个飞行腿之间所用的时间。这取决于每个飞行段的 bagArrivalDateflightDate 之间的差异。要确定持续时间(天、小时或分钟),请将 timestamp_diff 函数的结果传递给 get_duration 函数。

输出:

{"bagArrivalDate":"2019-03-22T10:17:00Z","flightDate":"2019-03-22T07:00:00Z",
"diff":"3 hours 17 minutes"}
{"bagArrivalDate":"2019-03-22T10:17:00Z","flightDate":"2019-03-22T07:23:00Z",
"diff":"2 hours 54 minutes"}
{"bagArrivalDate":"2019-03-22T10:17:00Z","flightDate":"2019-03-22T08:23:00Z",
"diff":"1 hour 54 minutes"}

要确定持续时间(以毫秒为单位),请仅使用 timestamp_diff 函数。

SELECT $s.ticketno, $bagInfo.bagArrivalDate, $flightLeg.flightDate,
timestamp_diff($bagInfo.bagArrivalDate, $flightLeg.flightDate) AS diff
FROM baggageinfo $s,
$s.bagInfo[] AS $bagInfo,
$bagInfo.flightLegs[] AS $flightLeg
WHERE ticketNo=1762355527825

示例 2:从办理登机手续到为票号为 176234463813 的乘客在登机时扫描行李需要多长时间?

SELECT $flightLeg.flightNo,
$flightLeg.actions[contains($element.actionCode, "Checkin")].actionTime AS checkinTime,
$flightLeg.actions[contains($element.actionCode, "BagTag Scan")].actionTime AS bagScanTime,
get_duration(timestamp_diff(
    $flightLeg.actions[contains($element.actionCode, "Checkin")].actionTime,
    $flightLeg.actions[contains($element.actionCode, "BagTag Scan")].actionTime
)) AS diff
FROM baggageinfo $s,
$s.bagInfo[].flightLegs[] AS $flightLeg
WHERE ticketNo=176234463813 AND
starts_with($s.bagInfo[].routing, $flightLeg.fltRouteSrc)

解释:在行李数据中,每个 flightLeg 都有一个操作数组。操作数组中有三个不同的操作。数组中第一个元素的操作代码是 Checkin/Offload。对于第一个行程,操作代码为“签入”,对于其他行程,操作代码为“在跃点卸载”。数组的第二个元素的操作代码是 BagTag Scan。在上面的查询中,您可以确定袋标签扫描和检入时间之间的操作时间差异。仅当操作代码为 Checkin 或 BagScan 时,才使用 contains 函数筛选操作时间。由于只有第一个航班段有登记入住和行李扫描的详细信息,因此您还可以使用 starts_with 函数过滤数据,以便仅提取源代码 fltRouteSrc。要确定持续时间(天、小时或分钟),请将 timestamp_diff 函数的结果传递给 get_duration 函数。

要确定持续时间(毫秒),请仅使用 timestamp_diff 函数。

SELECT $flightLeg.flightNo,
$flightLeg.actions[contains($element.actionCode, "Checkin")].actionTime AS checkinTime,
$flightLeg.actions[contains($element.actionCode, "BagTag Scan")].actionTime AS bagScanTime,
timestamp_diff(
   $flightLeg.actions[contains($element.actionCode, "Checkin")].actionTime,
   $flightLeg.actions[contains($element.actionCode, "BagTag Scan")].actionTime
) AS diff
FROM baggageinfo $s,
$s.bagInfo[].flightLegs[] AS $flightLeg
WHERE ticketNo=176234463813 AND
starts_with($s.bagInfo[].routing, $flightLeg.fltRouteSrc)

输出:

{"flightNo":"BM572","checkinTime":"2019-03-02T03:28:00Z",
"bagScanTime":"2019-03-02T04:52:00Z","diff":"- 1 hour 24 minutes"}

示例 3:对于票号为 1762320369957 的客户袋,需要多长时间才能到达第一个转运点?

SELECT  $bagInfo.flightLegs[1].actions[2].actionTime,
$bagInfo.flightLegs[0].actions[0].actionTime,
get_duration(timestamp_diff($bagInfo.flightLegs[1].actions[2].actionTime,
                            $bagInfo.flightLegs[0].actions[0].actionTime)) AS diff
FROM baggageinfo $s, $s.bagInfo[] AS $bagInfo
WHERE ticketNo=1762320369957

解释:在航空公司应用程序中,每个客户在其源和目标之间可以有不同数量的跃点/跃点。在上面的示例中,确定包到达第一个中转点所花费的时间。在行李数据中,flightLeg 是一个数组。数组中的第一条记录引用了第一个中转点详细信息。第一个记录中的 flightDate 是包离开源的时间,第一个飞行腿记录中的 estimatedArrival 表示它到达第一个中转点的时间。两者之间的差异给出袋子到达第一个中转点所花费的时间。要确定持续时间(天、小时或分钟),请将 timestamp_diff 函数的结果传递给 get_duration 函数。

要确定持续时间(以毫秒为单位),请使用 timestamp_diff 函数。

SELECT  $bagInfo.flightLegs[0].flightDate,
$bagInfo.flightLegs[0].estimatedArrival,
timestamp_diff($bagInfo.flightLegs[0].estimatedArrival,
             $bagInfo.flightLegs[0].flightDate) AS diff
FROM baggageinfo $s, $s.bagInfo[] AS $bagInfo
WHERE ticketNo=1762320369957

输出:

{"flightDate":"2019-03-12T03:00:00Z","estimatedArrival":"2019-03-12T16:00:00Z","diff":"13 hours"}
{"flightDate":"2019-03-12T03:00:00Z","estimatedArrival":"2019-03-12T16:40:00Z","diff":"13 hours 40 minutes"}

使用 QueryRequest API 的示例

您可以使用 QueryRequest API 和应用 SQL 函数从 NoSQL 表提取数据。

要执行查询,请使用 NoSQLHandle.query() API。

Download the full code SQLFunctions.java from the examples here.

 //Fetch rows from the table
private static void fetchRows(NoSQLHandle handle,String sqlstmt) throws Exception {
   try (
      QueryRequest queryRequest = new QueryRequest().setStatement(sqlstmt);
      QueryIterableResult results = handle.queryIterable(queryRequest)){
      for (MapValue res : results) {
         System.out.println("\t" + res);
      }
   }
}
String ts_func1="SELECT timestamp_add(bag.bagInfo.flightLegs[0].estimatedArrival, "5 minutes")"+
                         " AS ARRIVAL_TIME FROM BaggageInfo bag WHERE ticketNo=1762341772625";
System.out.println("Using timestamp_add function ");
fetchRows(handle,ts_func1);
String ts_func2="SELECT $s.ticketno, $bagInfo.bagArrivalDate, $flightLeg.flightDate, "+
                "get_duration(timestamp_diff($bagInfo.bagArrivalDate, $flightLeg.flightDate)) AS diff "+
                 "FROM baggageinfo $s, $s.bagInfo[] AS $bagInfo, $bagInfo.flightLegs[] AS $flightLeg "+
                 "WHERE ticketNo=1762344493810";
System.out.println("Using get_duration and timestamp_diff function ");
fetchRows(handle,ts_func2);

要执行查询,请使用 borneo.NoSQLHandle.query() 方法。

Download the full code SQLFunctions.py from the examples here.

# Fetch data from the table
def fetch_data(handle,sqlstmt):
   request = QueryRequest().set_statement(sqlstmt)
   print('Query results for: ' + sqlstmt)
   result = handle.query(request)
   for r in result.get_results():
      print('\t' + str(r))
 ts_func1 = '''SELECT timestamp_add(bag.bagInfo.flightLegs[0].estimatedArrival, "5 minutes")
                 AS ARRIVAL_TIME FROM BaggageInfo bag WHERE ticketNo=1762341772625'''
print('Using timestamp_add function:')
fetch_data(handle,ts_func1)

ts_func2 = '''SELECT $s.ticketno, $bagInfo.bagArrivalDate, $flightLeg.flightDate,
              get_duration(timestamp_diff($bagInfo.bagArrivalDate, $flightLeg.flightDate)) AS diff
              FROM baggageinfo $s,
              $s.bagInfo[] AS $bagInfo, $bagInfo.flightLegs[] AS $flightLeg
              WHERE ticketNo=1762344493810'''
print('Using get_duration and timestamp_diff function:')
fetch_data(handle,ts_func2)

要执行查询,请使用 Client.Query 函数。

Download the full code SQLFunctions.go from the examples here.

 //fetch data from the table
func fetchData(client *nosqldb.Client, err error, tableName string, querystmt string)(){
   prepReq := &nosqldb.PrepareRequest{
		Statement: querystmt,
   }
   prepRes, err := client.Prepare(prepReq)
   if err != nil {
      fmt.Printf("Prepare failed: %v\n", err)
      return
   }
   queryReq := &nosqldb.QueryRequest{
		 PreparedStatement: &prepRes.PreparedStatement,   }
   var results []*types.MapValue
   for {
      queryRes, err := client.Query(queryReq)
      if err != nil {
         fmt.Printf("Query failed: %v\n", err)
  	return
      }
      res, err := queryRes.GetResults()
      if err != nil {
         fmt.Printf("GetResults() failed: %v\n", err)
  	return
      }
      results = append(results, res...)
      if queryReq.IsDone() {
         break
      }
   }
   for i, r := range results {
      fmt.Printf("\t%d: %s\n", i+1, jsonutil.AsJSON(r.Map()))
   }
}
ts_func1 := `SELECT timestamp_add(bag.bagInfo.flightLegs[0].estimatedArrival, "5 minutes")
                AS ARRIVAL_TIME FROM BaggageInfo bag WHERE ticketNo=1762341772625`
fmt.Printf("Using timestamp_add function::\n")
fetchData(client, err,tableName,ts_func1)

ts_func2 := `SELECT $s.ticketno, $bagInfo.bagArrivalDate, $flightLeg.flightDate,
             get_duration(timestamp_diff($bagInfo.bagArrivalDate, $flightLeg.flightDate)) AS diff
             FROM baggageinfo $s,
             $s.bagInfo[] AS $bagInfo, $bagInfo.flightLegs[] AS $flightLeg
             WHERE ticketNo=1762344493810`
fmt.Printf("Using get_duration and timestamp_diff function:\n")
fetchData(client, err,tableName,ts_func2)

要执行查询,请使用 query 方法。

JavaScript:此处的示例下载完整代码 SQLFunctions.js

  //fetches data from the table
async function fetchData(handle,querystmt) {
   const opt = {};
   try {
      do {
         const result = await handle.query(querystmt, opt);
         for(let row of result.rows) {
            console.log('  %O', row);
         }
         opt.continuationKey = result.continuationKey;
      } while(opt.continuationKey);
   } catch(error) {
      console.error('  Error: ' + error.message);
   }
}

TypeScript:此处的示例下载完整代码 SQLFunctions.ts

interface StreamInt {
   acct_Id: Integer;
   profile_name: String;
   account_expiry: TIMESTAMP;
   acct_data: JSON;
}
/* fetches data from the table */
async function fetchData(handle: NoSQLClient,querystmt: string) {
   const opt = {};
   try {
      do {
         const result = await handle.query<StreamInt>(querystmt, opt);
         for(let row of result.rows) {
            console.log('  %O', row);
         }
         opt.continuationKey = result.continuationKey;
      } while(opt.continuationKey);
   } catch(error) {
      console.error('  Error: ' + error.message);
   }
}
const ts_func1 = `SELECT timestamp_add(bag.bagInfo.flightLegs[0].estimatedArrival, "5 minutes")
                  AS ARRIVAL_TIME FROM BaggageInfo bag WHERE ticketNo=1762341772625`
console.log("Using timestamp_add function:");
await fetchData(handle,ts_func1);

const ts_func2 = `SELECT $s.ticketno, $bagInfo.bagArrivalDate, $flightLeg.flightDate,
                  get_duration(timestamp_diff($bagInfo.bagArrivalDate, $flightLeg.flightDate)) AS diff
                  FROM baggageinfo $s,
                  $s.bagInfo[] AS $bagInfo, $bagInfo.flightLegs[] AS $flightLeg
                  WHERE ticketNo=1762344493810`
console.log("Using get_duration and timestamp_diff function:");
await fetchData(handle,ts_func2);

要执行查询,可以调用 QueryAsync 方法或调用 GetQueryAsyncEnumerable 方法并迭代生成的异步枚举。

Download the full code SQLFunctions.cs from the examples here.

private static async Task fetchData(NoSQLClient client,String querystmt){
   var queryEnumerable = client.GetQueryAsyncEnumerable(querystmt);
   await DoQuery(queryEnumerable);
}

private static async Task DoQuery(IAsyncEnumerable<QueryResult<RecordValue>> queryEnumerable){
   Console.WriteLine("  Query results:");
   await foreach (var result in queryEnumerable) {
      foreach (var row in result.Rows)
      {
         Console.WriteLine();
         Console.WriteLine(row.ToJsonString());
      }
   }
}
private const string ts_func1 =@"SELECT timestamp_add(bag.bagInfo.flightLegs[0].estimatedArrival, ""5 minutes"")
                                       AS ARRIVAL_TIME FROM BaggageInfo bag WHERE ticketNo=1762341772625";
Console.WriteLine("\nUsing timestamp_add function!");
await fetchData(client,ts_func1);

private const string ts_func2 =@"SELECT $s.ticketno, $bagInfo.bagArrivalDate, $flightLeg.flightDate,
                                       get_duration(timestamp_diff($bagInfo.bagArrivalDate, $flightLeg.flightDate)) AS diff
                                       FROM baggageinfo $s,
                                       $s.bagInfo[] AS $bagInfo, $bagInfo.flightLegs[] AS $flightLeg
                                       WHERE ticketNo=1762344493810";
Console.WriteLine("\nUsing get_duration and timestamp_diff function!");
await fetchData(client,ts_func2);

相关主题