From f203ab3c982a3cc5955887e1bdfe7075cc0aeab6 Mon Sep 17 00:00:00 2001 From: "Wuwan, Qi" Date: Thu, 15 Feb 2024 08:56:15 +0000 Subject: [PATCH] CSS Bestpractice 20231018 version Reviewed-by: Pruthi, Vineet Co-authored-by: Wuwan, Qi Co-committed-by: Wuwan, Qi --- docs/css/best-practice/ALL_META.TXT.json | 19 ++ docs/css/best-practice/CLASS.TXT.json | 11 + docs/css/best-practice/PARAMETERS.txt | 3 + docs/css/best-practice/css_07_0024.html | 200 ++++++++++++++++++ .../en-us_image_0000001299757424.png | Bin 0 -> 10923 bytes .../caution_3.0-en-us.png | Bin 0 -> 2752 bytes .../public_sys-resources/danger_3.0-en-us.png | Bin 0 -> 2771 bytes .../public_sys-resources/delta.gif | Bin 0 -> 836 bytes .../public_sys-resources/deltaend.gif | Bin 0 -> 834 bytes .../public_sys-resources/icon-arrowdn.gif | Bin 0 -> 1887 bytes .../public_sys-resources/icon-arrowrt.gif | Bin 0 -> 1890 bytes .../public_sys-resources/icon-caution.gif | Bin 0 -> 1086 bytes .../public_sys-resources/icon-danger.gif | Bin 0 -> 1086 bytes .../public_sys-resources/icon-huawei.gif | Bin 0 -> 2767 bytes .../public_sys-resources/icon-note.gif | Bin 0 -> 983 bytes .../public_sys-resources/icon-notice.gif | Bin 0 -> 962 bytes .../public_sys-resources/icon-tip.gif | Bin 0 -> 879 bytes .../public_sys-resources/icon-warning.gif | Bin 0 -> 1086 bytes .../public_sys-resources/note_3.0-en-us.png | Bin 0 -> 1080 bytes .../public_sys-resources/notice_3.0-en-us.png | Bin 0 -> 1672 bytes .../warning_3.0-en-us.png | Bin 0 -> 3164 bytes 21 files changed, 233 insertions(+) create mode 100644 docs/css/best-practice/ALL_META.TXT.json create mode 100644 docs/css/best-practice/CLASS.TXT.json create mode 100644 docs/css/best-practice/PARAMETERS.txt create mode 100644 docs/css/best-practice/css_07_0024.html create mode 100644 docs/css/best-practice/en-us_image_0000001299757424.png create mode 100644 docs/css/best-practice/public_sys-resources/caution_3.0-en-us.png create mode 100644 docs/css/best-practice/public_sys-resources/danger_3.0-en-us.png create mode 100644 docs/css/best-practice/public_sys-resources/delta.gif create mode 100644 docs/css/best-practice/public_sys-resources/deltaend.gif create mode 100644 docs/css/best-practice/public_sys-resources/icon-arrowdn.gif create mode 100644 docs/css/best-practice/public_sys-resources/icon-arrowrt.gif create mode 100644 docs/css/best-practice/public_sys-resources/icon-caution.gif create mode 100644 docs/css/best-practice/public_sys-resources/icon-danger.gif create mode 100644 docs/css/best-practice/public_sys-resources/icon-huawei.gif create mode 100644 docs/css/best-practice/public_sys-resources/icon-note.gif create mode 100644 docs/css/best-practice/public_sys-resources/icon-notice.gif create mode 100644 docs/css/best-practice/public_sys-resources/icon-tip.gif create mode 100644 docs/css/best-practice/public_sys-resources/icon-warning.gif create mode 100644 docs/css/best-practice/public_sys-resources/note_3.0-en-us.png create mode 100644 docs/css/best-practice/public_sys-resources/notice_3.0-en-us.png create mode 100644 docs/css/best-practice/public_sys-resources/warning_3.0-en-us.png diff --git a/docs/css/best-practice/ALL_META.TXT.json b/docs/css/best-practice/ALL_META.TXT.json new file mode 100644 index 00000000..4f6bf53c --- /dev/null +++ b/docs/css/best-practice/ALL_META.TXT.json @@ -0,0 +1,19 @@ +[ + { + "uri":"css_07_0024.html", + "node_id":"css_07_0024.xml", + "product_code":"", + "code":"1", + "des":"Elasticsearch is used as a supplement to relational databases, such as MySQL and GaussDB(for MySQL), to improve the full-text search and high-concurrency ad hoc query cap", + "doc_type":"", + "kw":"Using CSS to Accelerate Database Query and Analysis,Best Practices", + "search_title":"", + "metedata":[ + { + "IsMulti":"No" + } + ], + "title":"Using CSS to Accelerate Database Query and Analysis", + "githuburl":"" + } +] \ No newline at end of file diff --git a/docs/css/best-practice/CLASS.TXT.json b/docs/css/best-practice/CLASS.TXT.json new file mode 100644 index 00000000..763a7311 --- /dev/null +++ b/docs/css/best-practice/CLASS.TXT.json @@ -0,0 +1,11 @@ +[ + { + "desc":"Elasticsearch is used as a supplement to relational databases, such as MySQL and GaussDB(for MySQL), to improve the full-text search and high-concurrency ad hoc query cap", + "product_code":"", + "title":"Using CSS to Accelerate Database Query and Analysis", + "uri":"css_07_0024.html", + "doc_type":"", + "p_code":"", + "code":"1" + } +] \ No newline at end of file diff --git a/docs/css/best-practice/PARAMETERS.txt b/docs/css/best-practice/PARAMETERS.txt new file mode 100644 index 00000000..6da8d5f0 --- /dev/null +++ b/docs/css/best-practice/PARAMETERS.txt @@ -0,0 +1,3 @@ +version="" +language="en-us" +type="" \ No newline at end of file diff --git a/docs/css/best-practice/css_07_0024.html b/docs/css/best-practice/css_07_0024.html new file mode 100644 index 00000000..9c929c74 --- /dev/null +++ b/docs/css/best-practice/css_07_0024.html @@ -0,0 +1,200 @@ + + +

Using CSS to Accelerate Database Query and Analysis

+

Overview

Elasticsearch is used as a supplement to relational databases, such as MySQL and GaussDB(for MySQL), to improve the full-text search and high-concurrency ad hoc query capabilities of the databases.

+

This chapter describes how to synchronize data from a MySQL database to CSS to accelerate full-text search and ad hoc query and analysis. The following figure shows the solution process.

+
Figure 1 Using CSS to accelerate database query and analysis
+
  1. Service data is stored in the MySQL database.
  2. DRS synchronizes data from MySQL to CSS in real time.
  3. CSS is used for full-text search and data query and analysis.
+
+

Prerequisites

  • A CSS cluster and a MySQL database in security mode have been created, and they are in the same VPC and security group.
  • Data to be synchronized exists in the MySQL database. This section uses the following table structure and initial data as an example.
    1. Create a student information table in MySQL.
      CREATE TABLE `student` (
+  `dsc` varchar(100) COLLATE utf8mb4_general_ci DEFAULT NULL,
+  `age` smallint unsigned DEFAULT NULL,
+  `name` varchar(32) COLLATE utf8mb4_general_ci NOT NULL,
+  `id` int unsigned NOT NULL,
+  PRIMARY KEY (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;
      +
    2. Insert the initial data of three students into the MySQL database.
      INSERT INTO student (id,name,age,dsc)
+VALUES 
+('1','Jack Ma Yun','50','Jack Ma Yun is a Chinese business magnate, investor and philanthropist.'),
+('2','will smith','22','also known by his stage name the Fresh Prince, is an American actor, rapper, and producer.'),
+('3','James Francis Cameron','68','the director of avatar');
      +
    +
  • Indexes have been created in the CSS cluster and match the table indexes in the MySQL database.
    The following is an example of the indexes in the cluster in this chapter:
    PUT student
+{
+  "settings": {
+    "number_of_replicas": 0,
+    "number_of_shards": 3
+	},
+  "mappings": {
+    "properties": {
+      "id": {
+        "type": "keyword"
+		},
+      "name": {
+        "type": "short"
+		},
+      "age": {
+        "type": "short"
+		},
+      "desc": {
+        "type": "text"
+		}
+    }
+  }
+}
    +
    +

    Configure number_of_shards and number_of_replicas as needed.

    +
+
+

Procedure

  1. Use DRS to synchronize MySQL data to CSS in real time. For details, see .

    In this example, configure the parameters by following the suggestions in Table 1. +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 1 Synchronization parameters

    Module

    +

    Parameter

    +

    Suggestion

    +

    Create Synchronization Instance > Synchronize Instance Details

    +

    Network Type

    +

    Select VPC.

    +

    Source DB Instance

    +

    Select the RDS for MySQL instance to be synchronized, that is, the MySQL database that stores service data.

    +

    Synchronization Instance Subnet

    +

    Select the subnet where the synchronization instance is located. You are advised to select the subnet where the database instance and the CSS cluster are located.

    +

    Configure Source and Destination Databases > Destination Database

    +

    VPC and Subnet

    +

    Select the VPC and subnet of the CSS cluster.

    +

    IP Address or Domain Name

    +

    Enter the IP address of the CSS cluster. For details, see Obtaining the IP address of a CSS cluster.

    +

    Database Username and Database Password

    +

    Enter the administrator username (admin) and password of the CSS cluster.

    +

    Encryption Certificate

    +

    Select the security certificate of the CSS cluster. If SSL Connection is not enabled, you do not need to select any certificate. For details, see Obtaining the security certificate of a CSS cluster.

    +

    Set Synchronization Task

    +

    Flow Control

    +

    Select No.

    +

    Synchronization Object Type

    +

    Deselect Table structure, because the indexes matching MySQL tables have been created in the CSS cluster.

    +

    Synchronization Object

    +

    Select Tables. Select the database and table name corresponding to CSS.

    +
    NOTE:

    Ensure the type name in the configuration item is the same as the index name, that is, _doc.

    +
    +

    Process Data

    +

    -

    +

    Click Next.

    +
    +
    +
    +

    After the synchronization task is started, wait until the Status of the task changes from Full synchronization to Incremental, indicating real-time synchronization has started.

    +

  2. Check the synchronization status of the database.

    1. Verify full data synchronization.

      Run the following command in Kibana of CSS to check whether full data has been synchronized to CSS:

      +
      GET student/_search
      +
    2. Insert new data in the source cluster and check whether the data is synchronized to CSS.
      For example, insert a record whose id is 4 in the source cluster.
      INSERT INTO student (id,name,age,dsc)
+VALUES 
+('4','Bill Gates','50','Gates III is an American business magnate, software developer, investor, author, and philanthropist.')
      +
      +

      Run the following command in Kibana of CSS to check whether new data is synchronized to CSS:

      +
      GET student/_search
      +
    3. Update data in the source cluster and check whether the data is synchronized to CSS.
      For example, in the record whose id is 4, change the value of age from 50 to 55.
      UPDATE student set age='55' WHERE id=4;
      +
      +

      Run the following command in Kibana of CSS to check whether the data is updated in CSS:

      +
      GET student/_search
      +
    4. Delete data from the source cluster and check whether the data is deleted synchronously from CSS.
      For example, delete the record whose id is 4.
      DELETE FROM student WHERE id=4;
      +
      +

      Run the following command in Kibana of CSS to check whether the data is deleted synchronously from CSS:

      +
      GET student/_search
      +
    +

  3. Verify the full-text search capability of the database.

    For example, run the following command to query the data that contains avatar in dsc in CSS:

    +
    GET student/_search
+{
+  "query": {
+    "match": {
+      "dsc": "avatar"
+    }
+  }
+}
    +

  4. Verify the ad hoc query capability of the database.

    For example, query philanthropist whose age is greater than 40 in CSS.

    +
    GET student/_search
+{
+  "query": {
+    "bool": {
+      "must": [
+        {
+          "match": {
+            "dsc": "philanthropist"
+          }
+        },
+        {
+          "range": {
+            "age": {
+              "gte": 40
+            }
+          }
+        }
+      ]
+    }
+  }
+}
    +

  5. Verify the statistical analysis capability of the database.

    For example, use CSS to collect statistics on the age distributions of all users.

    +
    GET student/_search
+{
+  "size": 0, 
+  "query": {
+    "match_all": {}
+  },
+  "aggs": {
+    "age_count": {
+      "terms": {
+        "field": "age",
+        "size": 10
+      }
+    }
+  }
+}
    +

+
+

Other Operations

  • Obtaining the IP address of a CSS cluster
    1. In the navigation pane on the left, choose Clusters.
    2. In the cluster list, locate a cluster, and obtain the IP address of the CSS cluster from the Private Network Address column. Generally, the IP address format is <host>:<port> or <host>:<port>,<host>:<port>.

      If the cluster has only one node, the IP address and port number of only one node are displayed, for example, 10.62.179.32:9200. If the cluster has multiple nodes, the IP addresses and port numbers of all nodes are displayed, for example, 10.62.179.32:9200,10.62.179.33:9200.

      +
    +
  • Obtaining the security certificate of a CSS cluster
    1. Log in to the CSS management console.
    2. In the navigation pane, choose Clusters. The cluster list is displayed.
    3. Click the name of a cluster to go to the cluster details page.
    4. On the Configuration page, click Download Certificate next to HTTPS Access.
    +
+
+
+ diff --git a/docs/css/best-practice/en-us_image_0000001299757424.png b/docs/css/best-practice/en-us_image_0000001299757424.png new file mode 100644 index 0000000000000000000000000000000000000000..b1e4e6bad52f408474af5aee64e334dae04f87f6 GIT binary patch literal 10923 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Ϙ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 ZPBE~+#0O;Bk7+Q)(ooTXd{DBE`Y%N1t7`xN literal 0 HcmV?d00001 diff --git a/docs/css/best-practice/public_sys-resources/caution_3.0-en-us.png b/docs/css/best-practice/public_sys-resources/caution_3.0-en-us.png new file mode 100644 index 0000000000000000000000000000000000000000..60f60762138fe7d98fa081415cf26a4943897779 GIT binary patch literal 2752 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 literal 0 HcmV?d00001 diff --git a/docs/css/best-practice/public_sys-resources/icon-arrowdn.gif b/docs/css/best-practice/public_sys-resources/icon-arrowdn.gif new file mode 100644 index 0000000000000000000000000000000000000000..379428032932289326e52c2772bd90ba3d88b906 GIT binary patch literal 1887 zcmZ?wbhEHbCgqow z*eU^C3h_d20o>TUVm+{T^pf*)^(zt!^bPe4Kwg3=^!3HBG&dKny0|1L72#g21{a4^ z7NqJ2r55Lx7A2Jm>Ih`8X1|p zSh~8p7&*iAy5uL9=BDPA!1Sgd^t#~G3rY&P1wfl!Qj0RnQd8WD@^clyUbf1_?G{Iz z=0WwQ;C71>PQCg-$LND17Ac}(Lcr7mV#1RxkONQnsd>QEUIa|mjQ{`r{qy_R&mZ5v zef{$J)5j0*-@SeF`qj%9&!0Vg^7zri2lwyYy>t84%^TORUA=Po(!~qs&z(JU`qar2 z$B!L7a`@1}1N-;w-Lrew&K=vgZQZhY)5ZeMTG_VdAT{+S(zE> zX{jm6Nr?&Zaj`McQIQehVWA3>*p!%p5Wn0u7E$th{n6D>ft^YU5&dnB%c=(a~-RV>2EO25SIA CZ-yWM literal 0 HcmV?d00001 diff --git a/docs/css/best-practice/public_sys-resources/icon-arrowrt.gif b/docs/css/best-practice/public_sys-resources/icon-arrowrt.gif new file mode 100644 index 0000000000000000000000000000000000000000..6aaaa11c23e919c4798d7dcd2b1ae98dd35dd316 GIT binary patch literal 1890 zcmZ?wbhEHb7yetOgf{ zR2HP_2c;J0mlh?b0+lO+tSYc_E=o--$uA1Y&(DE{Vn9ZINq%ugeu08>u$h8JcxGNo zetEGbSiP^Wm1kaYNn&1ds;7&s63_&_%*+%k11Cod14Ab>6ALqQLqk^=3j-5FHzP|& zBUd9gQwvj9m|mCsATTyHM;rzL?XHK6w zdE)r7qel)OI(T6JzP)>P@7lRz`?jrHHgDRvVg0(bYgVsXxnlXUrArnsTDV~Tyt#8` z&zd=7`n0K2CQq6;p}()Ur@O1OqrI)QrMaoGp}wxRrn;)KqP(oMq`0WCAU`iRCp#-M zBRwrOB{?ZEAwDiPCORrIB0MZKBseHAz~9f;$J@)(!`;o*#o5Wx!QRf+#@fo#!raW% z#MsEtKwnQ+M_Wr%LtRZ(MOjHvL0(Q)Mp{ZzLR?H#L|8~rfS-?-hntI&gPo0)g_((w zfkE*n3y@@B&;b#k`jUY|nSq%>!ec`MLnAA%oR7zc2TpB#@>)|YCO&lN;uMU!b7Eqm H1A{dHTIz>f literal 0 HcmV?d00001 diff --git a/docs/css/best-practice/public_sys-resources/icon-caution.gif b/docs/css/best-practice/public_sys-resources/icon-caution.gif new file mode 100644 index 0000000000000000000000000000000000000000..079c79b263f4b48089f3b3256154c73e7699593f GIT binary patch literal 1086 zcmW+#YfRQ<6hA3LZMyP?V}KhnEtF{Q4vGxS52AozEVM85nq$#%tv8gRF!3GhgM?_) zd5Luv3SKrXFTGCpn$y>EMGZQ&sWI^~+e%qWysRPK%BSD+f4-fabAGq;|Cf|4nO{(o zMH%#n$oXf^sdM5SJ4e1UbEeM389O82RCB6M#VI=_KP%=$orn{5LVlIau{svV?3jS$ z$Q-F7am0>L02|Q2!ZN1G^Z2J`V#a3VX;G<~iYc3tSAnLeiI}hnc~O{UH5OwwCTPT} zks65+8-W$70S3`f30dfY7}$UY7M95y@-?2QvMPChphYF3!YbtLLIs*E%B)Oq4^fy^ z5+zoGJ>&tI*hU=i4-s$()c}KNsKh9AfEd_-1{V3`d>b_$i;xcz{y>Y0S(uP3>_P>a zLM((Fku(B;E{r2+xJ8u612VCVIG_oJ;Sj0;2GQ7rEa(6+umMf}M1C4=)Odu8AxQWG zEh;Aearj(=d;4Z^LLYN*6+asU?Nbl3^Q%D|{s@6Xj}(aZHwkoj-~bw*1FnSd;0aX! zUW<-TPD&b;6s;@zw7K~4mF9cDuK&BQ;b_N-Cj%R=CnEjde9%~1kk}vYY^@mTTNm%F z?mbrf*~d#iX;?ITDf(MHQdK;&p(ek&e9qe?*&A0E)mG(1s`J*pn^#ttId4vCXjV$j zj464u)2F9Q$V#0!dHk4(FDB#D&wP^f0*q1)G?4!%Xe>;ROD~Oee-}xfJUd+aa_0AK zFP$vgR2te>+%}b$hVw&Ni`yT>F5LNRM@_utk68Piwi5??BLBpCcb8mx|3c*1x!xZJ zKU!7(#h8s(^x)5*w=Z0K{=a9#qeoHU|0&%MiU0rr literal 0 HcmV?d00001 diff --git a/docs/css/best-practice/public_sys-resources/icon-danger.gif b/docs/css/best-practice/public_sys-resources/icon-danger.gif new file mode 100644 index 0000000000000000000000000000000000000000..079c79b263f4b48089f3b3256154c73e7699593f GIT binary patch literal 1086 zcmW+#YfRQ<6hA3LZMyP?V}KhnEtF{Q4vGxS52AozEVM85nq$#%tv8gRF!3GhgM?_) zd5Luv3SKrXFTGCpn$y>EMGZQ&sWI^~+e%qWysRPK%BSD+f4-fabAGq;|Cf|4nO{(o zMH%#n$oXf^sdM5SJ4e1UbEeM389O82RCB6M#VI=_KP%=$orn{5LVlIau{svV?3jS$ z$Q-F7am0>L02|Q2!ZN1G^Z2J`V#a3VX;G<~iYc3tSAnLeiI}hnc~O{UH5OwwCTPT} zks65+8-W$70S3`f30dfY7}$UY7M95y@-?2QvMPChphYF3!YbtLLIs*E%B)Oq4^fy^ z5+zoGJ>&tI*hU=i4-s$()c}KNsKh9AfEd_-1{V3`d>b_$i;xcz{y>Y0S(uP3>_P>a zLM((Fku(B;E{r2+xJ8u612VCVIG_oJ;Sj0;2GQ7rEa(6+umMf}M1C4=)Odu8AxQWG zEh;Aearj(=d;4Z^LLYN*6+asU?Nbl3^Q%D|{s@6Xj}(aZHwkoj-~bw*1FnSd;0aX! zUW<-TPD&b;6s;@zw7K~4mF9cDuK&BQ;b_N-Cj%R=CnEjde9%~1kk}vYY^@mTTNm%F z?mbrf*~d#iX;?ITDf(MHQdK;&p(ek&e9qe?*&A0E)mG(1s`J*pn^#ttId4vCXjV$j zj464u)2F9Q$V#0!dHk4(FDB#D&wP^f0*q1)G?4!%Xe>;ROD~Oee-}xfJUd+aa_0AK zFP$vgR2te>+%}b$hVw&Ni`yT>F5LNRM@_utk68Piwi5??BLBpCcb8mx|3c*1x!xZJ zKU!7(#h8s(^x)5*w=Z0K{=a9#qeoHU|0&%MiU0rr literal 0 HcmV?d00001 diff --git a/docs/css/best-practice/public_sys-resources/icon-huawei.gif b/docs/css/best-practice/public_sys-resources/icon-huawei.gif new file mode 100644 index 0000000000000000000000000000000000000000..a31d60f895af919d33855217ca02daf4093136d7 GIT binary patch literal 2767 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 GE&l)<3Z_>8 literal 0 HcmV?d00001 diff --git a/docs/css/best-practice/public_sys-resources/icon-notice.gif b/docs/css/best-practice/public_sys-resources/icon-notice.gif new file mode 100644 index 0000000000000000000000000000000000000000..409070650a49518feb1624c624d814c3bfa63d2e GIT binary patch literal 962 zcmb7D&r8&C5S<{wSd_qn6)U)w5LOaRh!N}_*49lD)S!dZp@M<3gPIX|@UR9-fz+X3 zAaT9)OY{xZtO-;RC85Vab;JEUNIMS5f^r$7-e%-XK`j{0+N$CsgpRd6B1wp z8dw-cH^rU^H4`&7qgabf)l^K`l!66{q9$U(CKRO5%W5pfY)s&YQ6n`HBR0ZTum%`N zgC%I8hQ+`JG_WvCAt-W$sIn@BKCDG1qQWW^a=`*c7G+i@s0S(ZDv1&+K_2`7O-#cM z=m!ZX1Z#kSG+3e)Jg^wpfCd(Yb5TZ)U=a!DwsG z)Z`|1ejMK4ap%CHj;%+>T6=D++5I=uBbQ$fZ48cf{hV1}9&Njl-I}i7e0#6Hdug@s zsr-57_=gLr&9Ros$k}}M>tJ77=hEJ}iPaZ%8|P+gUbS|Oj}5I{|5nZZc)C1$e*Rj` d`09hYXJ4M@PhCx)dHK8WZo1*|*q+^V@*ncduk8Q; literal 0 HcmV?d00001 diff --git a/docs/css/best-practice/public_sys-resources/icon-tip.gif b/docs/css/best-practice/public_sys-resources/icon-tip.gif new file mode 100644 index 0000000000000000000000000000000000000000..c47bae05c9fd17c02a851d96cfac67bf194498d8 GIT binary patch literal 879 zcmchWKWmj?48@OdDOZPr)a61!OE4yGD)salg#|^Ix$qIEF#uk)V>D{95e^!2r`i+9t# zTMu5YtUcd+@#gp0tDE;9ug>oLIzL$6dOx4-t#2PKExu1KulwoYeD?Os#mVO%AMWih HO|EMGZQ&sWI^~+e%qWysRPK%BSD+f4-fabAGq;|Cf|4nO{(o zMH%#n$oXf^sdM5SJ4e1UbEeM389O82RCB6M#VI=_KP%=$orn{5LVlIau{svV?3jS$ z$Q-F7am0>L02|Q2!ZN1G^Z2J`V#a3VX;G<~iYc3tSAnLeiI}hnc~O{UH5OwwCTPT} zks65+8-W$70S3`f30dfY7}$UY7M95y@-?2QvMPChphYF3!YbtLLIs*E%B)Oq4^fy^ z5+zoGJ>&tI*hU=i4-s$()c}KNsKh9AfEd_-1{V3`d>b_$i;xcz{y>Y0S(uP3>_P>a zLM((Fku(B;E{r2+xJ8u612VCVIG_oJ;Sj0;2GQ7rEa(6+umMf}M1C4=)Odu8AxQWG zEh;Aearj(=d;4Z^LLYN*6+asU?Nbl3^Q%D|{s@6Xj}(aZHwkoj-~bw*1FnSd;0aX! zUW<-TPD&b;6s;@zw7K~4mF9cDuK&BQ;b_N-Cj%R=CnEjde9%~1kk}vYY^@mTTNm%F z?mbrf*~d#iX;?ITDf(MHQdK;&p(ek&e9qe?*&A0E)mG(1s`J*pn^#ttId4vCXjV$j zj464u)2F9Q$V#0!dHk4(FDB#D&wP^f0*q1)G?4!%Xe>;ROD~Oee-}xfJUd+aa_0AK zFP$vgR2te>+%}b$hVw&Ni`yT>F5LNRM@_utk68Piwi5??BLBpCcb8mx|3c*1x!xZJ zKU!7(#h8s(^x)5*w=Z0K{=a9#qeoHU|0&%MiU0rr literal 0 HcmV?d00001 diff --git a/docs/css/best-practice/public_sys-resources/note_3.0-en-us.png b/docs/css/best-practice/public_sys-resources/note_3.0-en-us.png new file mode 100644 index 0000000000000000000000000000000000000000..57a0e1f53377b28fd80ceb393b035f8d9b8b392a GIT binary patch literal 1080 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