# Qlik 指令碼追蹤提示

使用 QlikView 或 Qlik Sense 連接器剖析記錄檔時，Qlik Lineage Connectors 將會在讀取 Qlik 指令碼中的 CONNECT TO 陳述式時嘗試識別資料庫類型。根據連線類型，這可能無法識別資料庫類型，但您可以透過指令碼新增此資訊。

所有 Qlik Lineage Connectors 在本機偵測到的參考資源會傳送至 Qlik Cloud 作為 Qlik 資源識別碼 (QRI)。QRI 包含關於資料來源類型、格式或資料儲存平台的資訊，及其在網路上和該網路節點內的正式路徑。

## 連線追蹤提示

將其他資訊傳送至 Qlik Lineage Connectors 會透過 TRACE 陳述式進行。此命令會將評論新增至將透過 Qlik Lineage Connectors 讀取的記錄檔。新增此資訊將會形成更精確的 QRI，這可在不同的 Qlik Lineage Connectors 執行個體和可從 Qlik Cloud 直接存取的其他資源偵測到。

### 追蹤提示範例

Qlik Lineage Connectors 對其他連線資訊的追蹤提示按照此格式：

```
TRACE !!qlc "Connect" "connection_name" "default_database" "default_schema" "database_type"; 
LIB CONNECT TO 'Database_tenant.region.provider.com';
```

追蹤提示將會作為中繼資料新增至連線，按照連線陳述式的任何查詢將會使用此提示提升每個資源的資訊。

追蹤包括下列元素：

* `!!qlc`
  * 此為通知 Qlik Lineage Connectors 下列資訊很重要的旗標。
* `"Connect"`
  * 此關鍵字向 Qlik Lineage Connectors 指示下一個處理的 CONNECT 陳述式的其他資訊。
* `"connection_name"`
  * 此為連線的名稱。這可以是機器的地址或描述性名稱。此名稱會將所有後續 SQL 查詢組成群組，對於形成處理譜系圖表中每個資源的 QRI 十分關鍵。這也有助於讓內部部署存取的資料與基於 Qlik Cloud 的查詢保持一致，確保參考相同的資源。

    提示備註使用資料庫位址和連接埠號碼 (如相關)。
* 「`default_database`」和「`default_schema`」
  * 對於在 connect 陳述式之後執行的查詢，通常會省略資料庫和結構描述詳細資訊，視資料庫系統而定。可以進行此省略，因為連線字串已包含必要的資料庫和結構描述資訊。Qlik Lineage Connectors 將會自動使用指定的資料庫和結構描述，用於沒有明確納入此資訊的查詢。
  * [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/QlikLineageConnectors/connectors/qlik-script-tracehints.htm)
    #### 沒有資料庫和結構描述的查詢
    ```

    LIB CONNECT TO ERP_Database';
    SQL SELECT Order, Product, Qty, Amount FROM SalesTable;
    ```

    查詢中不提供資料庫和結構描述，因為這在連線中或在資料庫端設定。
  * [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/QlikLineageConnectors/connectors/qlik-script-tracehints.htm)
    #### 新增了追蹤提示的查詢
    ```

    TRACE !!qlc “erp_1.company.com” “PROD” “dbo” “sqlserver”;
    ```
    ```
    LIB CONNECT TO ERP_Database';
    SQL SELECT Order, Product, Qty, Amount FROM SalesTable;
    ```

    明確陳述資料庫和/或結構描述的查詢將有優勢，不會依賴預設值。
* 「database\_type」
  * 根據物件庫是使用不同的連線類型或僅依賴 OLEDB/ODBC，Qlik Lineage Connectors 在正確識別資料庫類型時可能會遇到挑戰。為了解決這點，您可以手動設定資料庫類型，覆寫 Qlik Lineage Connectors 自動偵測。

    [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/QlikLineageConnectors/connectors/qlik-script-tracehints.htm)
    #### 支援的值設定

    Athena

    Azure SQL

    Azure Synapse

    Cassandra

    Couchbase

    Databricks

    Drill

    DynamoDB

    GBQ

    Hive

    Impala

    Marketo

    MongoDB

    MySQL

    Oracle

    Phoenix

    PostgreSQL

    Presto

    Redshift

    Salesforce

    SAP BW

    SAP HANA

    SAP SQL

    Snowflake

    SQL Server

    Teradata

    Unknown