🥇การทำงานอัตโนมัติของเซิร์ฟเวอร์ SQL ใน Jenkins: คืนผลลัพธ์ที่สวยงาม

อีกครั้ง สานต่อประเด็นการจัด ผลิตภัณฑ์ Zero Touch ภายใต้ระบบ RDS. DBA ในอนาคตจะไม่สามารถเชื่อมต่อกับเซิร์ฟเวอร์ PROD ได้โดยตรง แต่จะสามารถใช้งานได้ เจนกิ้นส์ งานสำหรับชุดการดำเนินงานที่จำกัด DBA เปิดตัวงานและหลังจากนั้นไม่นานก็ได้รับจดหมายพร้อมรายงานความสำเร็จของการดำเนินการนี้ มาดูวิธีนำเสนอผลลัพธ์เหล่านี้แก่ผู้ใช้กัน

ข้อความธรรมดา

เริ่มจากเรื่องเล็กน้อยที่สุดกันก่อน วิธีแรกนั้นง่ายมากจนไม่มีอะไรจะพูดถึงจริงๆ (ต่อไปนี้ผู้เขียนจะใช้งาน FreeStyle):

ตร.ซม ทำบางสิ่งบางอย่างและเรานำเสนอให้กับผู้ใช้ เหมาะสำหรับงานสำรองข้อมูล เช่น:

อย่าลืมว่าภายใต้การสำรอง/กู้คืน RDS นั้นเป็นแบบอะซิงโครนัส ดังนั้นคุณต้องรอ:

declare @rds table
  (id int, task_type varchar(128), database_name sysname, pct int, duration int, 
   lifecycle varchar(128), taskinfo varchar(max) null, 
   upd datetime, cre datetime,
   s3 varchar(256), ovr int, KMS varchar(256) null)
waitfor delay '00:00:20' 
insert into @rds exec msdb.dbo.rds_task_status @db_name='{db}'
select @xid=max(id) from @rds

again:
waitfor delay '00:00:02'
delete from @rds
insert into @rds exec msdb.dbo.rds_task_status @db_name='{db}' 
# {db} substituted with db name by powershell
select @stat=lifecycle,@info=taskinfo from @rds where id=@xid
if @stat not in ('ERROR','SUCCESS','CANCELLED') goto again

วิธีที่สอง CSV

ทุกสิ่งที่นี่ก็ง่ายมากเช่นกัน:

อย่างไรก็ตาม วิธีการนี้จะใช้ได้ก็ต่อเมื่อข้อมูลที่ส่งคืนใน CSV เป็น "แบบง่าย" เท่านั้น ตัวอย่างเช่น หากคุณพยายามส่งคืนรายการข้อความค้นหาที่ใช้ CPU เข้มข้นของ TOP N ในลักษณะนี้ CSV จะ "กัดกร่อน" เนื่องจากข้อความค้นหาอาจมีอักขระใดก็ได้ - เครื่องหมายจุลภาค เครื่องหมายคำพูด และแม้แต่การขึ้นบรรทัดใหม่ ดังนั้นเราจึงต้องการสิ่งที่ซับซ้อนกว่านี้

สัญญาณที่สวยงามใน HTML

ฉันจะให้ข้อมูลโค้ดแก่คุณทันที

$Header = @"
<style>
TABLE {border-width: 1px; border-style: solid; border-color: black; border-collapse: collapse;}
TH {border-width: 1px; padding: 3px; border-style: solid; border-color: black; background-color: #6495ED;}
TD {border-width: 1px; padding: 3px; border-style: solid; border-color: black;}
</style>
"@
  
$Result = invoke-Sqlcmd -ConnectionString $jstr -Query "select * from DbInv" `
  | Select-Object -Property * -ExcludeProperty "ItemArray", "RowError", "RowState", "Table", "HasErrors"
if ($Result -eq $null) { $cnt = 0; }
elseif ($Result.getType().FullName -eq "System.Management.Automation.PSCustomObject") { $cnt = 1; }
else { $cnt = $Result.Rows.Count; } 
if ($cnt -gt 0) {
  $body = "<h2>My table</h2>"
  $Result | ConvertTo-HTML -Title "Rows" -Head $header -body $body `
    | Out-File "res.log" -Append -Encoding UTF8
  } else {
    "<h3>No data</h3>" | Out-File "res.log" -Append -Encoding UTF8
  }

อย่างไรก็ตาม ให้ใส่ใจกับบรรทัดที่มี System.Management.Automation.PSCustomObject มันวิเศษมาก หากมีบรรทัดเดียวในตาราง แสดงว่ามีปัญหาบางอย่างเกิดขึ้น วิธีแก้ปัญหานี้นำมาจากอินเทอร์เน็ตโดยไม่มีความเข้าใจมากนัก ผลลัพธ์ที่ได้จะมีรูปแบบดังนี้:

การวาดกราฟ

คำเตือน: รหัสประหลาดด้านล่าง!
มีคำถามตลก ๆ บนเซิร์ฟเวอร์ SQL ที่แสดง CPU ในช่วง N นาทีสุดท้าย - ปรากฎว่า Comrade Major จำทุกอย่างได้! ลองทำแบบทดสอบนี้:

DECLARE @ts_now bigint = (SELECT cpu_ticks/(cpu_ticks/ms_ticks) 
  FROM sys.dm_os_sys_info WITH (NOLOCK)); 
SELECT TOP(256) 
  DATEADD(ms, -1 * (@ts_now - [timestamp]), GETDATE()) AS [EventTime],
  SQLProcessUtilization AS [SQLCPU], 
  100 - SystemIdle - SQLProcessUtilization AS [OtherCPU]
FROM (SELECT record.value('(./Record/@id)[1]', 'int') AS record_id, 
  record.value('(./Record/SchedulerMonitorEvent/SystemHealth/SystemIdle)[1]', 'int') 
    AS [SystemIdle], 
  record.value('(./Record/SchedulerMonitorEvent/SystemHealth/ProcessUtilization)[1]', 'int') 
    AS [SQLProcessUtilization], [timestamp] 
  FROM (SELECT [timestamp], CONVERT(xml, record) AS [record] 
  FROM sys.dm_os_ring_buffers WITH (NOLOCK)
  WHERE ring_buffer_type = N'RING_BUFFER_SCHEDULER_MONITOR' 
    AND record LIKE N'%<SystemHealth>%') AS x) AS y 
ORDER BY 1 DESC OPTION (RECOMPILE);

ตอนนี้ใช้การจัดรูปแบบนี้ ($Fragment ตัวแปร)

<table style="width: 100%"><tbody><tr style="background-color: white; height: 2pt;">
  <td style="width: SQLCPU%; background-color: green;"></td>
  <td style="width: OtherCPU%; background-color: blue;"></td>
  <td style="width: REST%; background-color: #C0C0C0;"></td></tr></tbody>
</table>

เราสามารถสร้างเนื้อหาของจดหมายได้:

$Result = invoke-Sqlcmd -ConnectionString $connstr -Query $Query `
  | Select-Object -Property * -ExcludeProperty `
  "ItemArray", "RowError", "RowState", "Table", "HasErrors"
if ($Result.HasRows) {
  foreach($item in $Result) 
    { 
    $time = $itemEventTime 
    $sqlcpu = $item.SQLCPU
    $other = $itemOtherCPU
    $rest = 100 - $sqlcpu - $other
    $f = $fragment -replace "SQLCPU", $sqlcpu
    $f = $f -replace "OtherCPU", $other
    $f = $f -replace "REST", $rest
    $f | Out-File "res.log" -Append -Encoding UTF8
    }

ซึ่งจะมีลักษณะดังนี้:

ใช่แล้ว คุณนายรู้เรื่องวิปริตมาก! น่าสนใจที่โค้ดนี้ประกอบด้วย: Powershell (เขียนอยู่ในนั้น), SQL, Xquery, HTML น่าเสียดายที่เราไม่สามารถเพิ่ม Javascript ลงใน HTML ได้ (เนื่องจากมีไว้สำหรับการเขียน) แต่การขัดโค้ด Python (ซึ่งสามารถใช้ใน SQL) ถือเป็นหน้าที่ของทุกคน!

เอาต์พุตการติดตามตัวสร้างโปรไฟล์ SQL

เป็นที่ชัดเจนว่าการติดตามจะไม่พอดีกับ CSV เนื่องจากฟิลด์ TextData แต่การแสดงตารางการติดตามในตัวอักษรก็เป็นเรื่องแปลกเช่นกัน เนื่องจากขนาดและเนื่องจากข้อมูลนี้มักจะใช้สำหรับการวิเคราะห์เพิ่มเติม ดังนั้นเราจึงดำเนินการดังต่อไปนี้: เราโทรผ่าน เรียกใช้-SqlCmd สคริปต์บางอย่างในส่วนลึกที่ทำเสร็จแล้ว

select 
  SPID,EventClass,TextData,
  Duration,Reads,Writes,CPU,
  StartTime,EndTime,DatabaseName,HostName,
  ApplicationName,LoginName
   from ::fn_trace_gettable ( @filename , default )

ต่อไป เพื่อน บนเซิร์ฟเวอร์ที่ DBA เข้าถึงได้ จะมีฐานข้อมูล Traces พร้อมเทมเพลตเปล่า แผ่น Model พร้อมที่จะยอมรับคอลัมน์ที่ระบุทั้งหมด เราคัดลอกโมเดลนี้ไปยังตารางใหม่ที่มีชื่อเฉพาะ:

$dt = Get-Date -format "yyyyMMdd"
$tm = Get-Date -format "hhmmss"
$tableName = $srv + "_" + $dt + "_" + $tm
$copytab = "select * into " + $tableName + " from Model"
invoke-SqlCmd -ConnectionString $tstr -Query $copytab

และตอนนี้เราสามารถเขียนร่องรอยของเราลงไปได้โดยใช้ Data.SqlClient.SqlBulkCopy - ฉันได้ยกตัวอย่างข้างต้นแล้ว ใช่ เป็นการดีที่จะปกปิดค่าคงที่ใน TextData:

# mask data
foreach ($Row in $Result)
{ 
  $v = $Row["TextData"]
  $v = $v -replace "'([^']{2,})'", "'str'" -replace "[0-9][0-9]+", '999'
  $Row["TextData"] = $v
}

เราแทนที่ตัวเลขที่มีความยาวมากกว่าหนึ่งอักขระด้วย 999 และเราแทนที่สตริงที่ยาวมากกว่าหนึ่งอักขระด้วย 'str' ตัวเลขตั้งแต่ 0 ถึง 9 มักถูกใช้เป็นธง และเราไม่ได้แตะต้องตัวเลขเหล่านั้น เช่นเดียวกับสตริงว่างและอักขระเดี่ยว - 'Y', 'N' ฯลฯ มักจะพบอยู่ในหมู่พวกเขา

มาเติมสีสันให้ชีวิตเรากันเถอะ (อย่างเคร่งครัด 18+)

ในตาราง คุณมักจะต้องการเน้นเซลล์ที่ต้องการความสนใจ ตัวอย่างเช่น FAILS การกระจายตัวในระดับสูง เป็นต้น แน่นอนว่าสามารถทำได้ใน SQL เปล่า สร้าง HTML โดยใช้ PRINT และตั้งค่าประเภทไฟล์เป็น HTML ใน Jenkins:

declare @body varchar(max), @chunk varchar(max)
set @body='<font face="Lucida Console" size="3">'
set @body=@body+'<b>Server name: '+@@servername+'</b><br>'
set @body=@body+'<br><br>'
set @body=@body+'<table><tr><th>Job</th><th>Last Run</th><th>Avg Duration, sec</th><th>Last Run, Sec</th><th>Last Status</th></tr>'
print @body

DECLARE tab CURSOR FOR SELECT '<tr><td>'+name+'</td><td>'+
  LastRun+'</td><td>'+
  convert(varchar,AvgDuration)+'</td><td>'+
  convert(varchar,LastDuration)+'</td><td>'+
    case when LastStatus<>'Succeeded' then '<font color="red">' else '' end+
      LastStatus+
      case when LastStatus<>'Succeeded' then '</font>' else '' end+
     +'</td><td>'
  from #j2
OPEN tab;  
FETCH NEXT FROM tab into @chunk
WHILE @@FETCH_STATUS = 0  
BEGIN
  print @chunk
  FETCH NEXT FROM tab into @chunk;  
END  
CLOSE tab;  
DEALLOCATE tab;
print '</table>'

ทำไมฉันถึงเขียนโค้ดดังกล่าว?

แต่มีวิธีแก้ปัญหาที่สวยงามกว่านี้ แปลงเป็น HTML ไม่อนุญาตให้เราระบายสีเซลล์ แต่เราสามารถทำได้หลังจากนั้น ตัวอย่างเช่น เราต้องการเลือกเซลล์ที่มีระดับการกระจายตัวมากกว่า 80 และมากกว่า 90 มาเพิ่มสไตล์กันดีกว่า:

<style>
.SQLmarkup-red { color: red; background-color: yellow; }
.SQLmarkup-yellow { color: black; background-color: #FFFFE0; }
.SQLmarkup-default { color: black; background-color: white; }
</style>

ในแบบสอบถาม เราจะเพิ่มคอลัมน์จำลอง ก่อนหน้านั้นทันที คอลัมน์ที่เราอยากจะลงสี ควรเรียกคอลัมน์ SQLmarkup-บางสิ่งบางอย่าง:

case  
  when ps.avg_fragmentation_in_percent>=90.0 then 'SQLmarkup-red'
  when ps.avg_fragmentation_in_percent>=80.0 then 'SQLmarkup-yellow'
  else 'SQLmarkup-default' 
  end as [SQLmarkup-1], 
ps.avg_fragmentation_in_percent,

ตอนนี้เมื่อได้รับ HTML ที่สร้างโดย Powershell แล้ว เราจะลบคอลัมน์จำลองออกจากส่วนหัว และในเนื้อหาของข้อมูล เราจะถ่ายโอนค่าจากคอลัมน์ไปยังสไตล์ ทำได้โดยใช้การทดแทนเพียงสองครั้ง:

$html = $html `
  -replace "<th>SQLmarkup[^<]*</th>", "" `
  -replace "<td>SQLmarkup-(.+?)</td><td>",'<td class="SQLmarkup-$1">'

ผล:

ไม่หรูหราเหรอ? แม้ว่าไม่ แต่สีนี้ทำให้ฉันนึกถึงบางสิ่งบางอย่าง

ที่มา: will.com

ระบบอัตโนมัติของเซิร์ฟเวอร์ SQL ใน Jenkins: คืนผลลัพธ์ที่สวยงาม