Airbyte Gong (已停用)

注意：這個特定連接器的載入器已停用。請改用 AirbyteLoader。

Airbyte 是一個資料整合平台，適用於從 API、資料庫和檔案到資料倉儲和資料湖的 ELT 管道。它擁有最大的 ELT 連接器目錄，可連接到資料倉儲和資料庫。

這個載入器將 Gong 連接器作為文件載入器公開，讓您可以將各種 Gong 物件載入為文件。

安裝

首先，您需要安裝 airbyte-source-gong Python 套件。

%pip install --upgrade --quiet  airbyte-source-gong

範例

請查看 Airbyte 文件頁面，以取得關於如何設定讀取器的詳細資訊。設定物件應遵循的 JSON 結構描述可以在 Github 上找到：https://github.com/airbytehq/airbyte/blob/master/airbyte-integrations/connectors/source-gong/source_gong/spec.yaml。

一般結構如下所示

{
  "access_key": "<access key name>",
  "access_key_secret": "<access key secret>",
  "start_date": "<date from which to start retrieving records from in ISO format, e.g. 2020-10-20T00:00:00Z>",
}

預設情況下，所有欄位都以 metadata 形式儲存在文件中，而文字設定為空字串。透過轉換讀取器傳回的文件來建構文件的文字。

from langchain_community.document_loaders.airbyte import AirbyteGongLoader

config = {
    # your gong configuration
}

loader = AirbyteGongLoader(
    config=config, stream_name="calls"
)  # check the documentation linked above for a list of all streams

API 參考：AirbyteGongLoader

現在您可以使用一般方式載入文件

docs = loader.load()

由於 load 會傳回列表，因此它會封鎖直到所有文件都載入完成。為了更好地控制此過程，您也可以使用 lazy_load 方法，該方法會傳回迭代器。

docs_iterator = loader.lazy_load()

請記住，預設情況下，頁面內容是空的，而 metadata 物件包含記錄中的所有資訊。若要處理文件，請建立一個繼承自基礎載入器的類別，並自行實作 _handle_records 方法。

from langchain_core.documents import Document


def handle_record(record, id):
    return Document(page_content=record.data["title"], metadata=record.data)


loader = AirbyteGongLoader(
    config=config, record_handler=handle_record, stream_name="calls"
)
docs = loader.load()

API 參考：Document

增量載入

某些串流允許增量載入，這表示來源會追蹤已同步的記錄，並且不會再次載入它們。這對於具有大量資料且頻繁更新的來源非常有用。

若要利用此功能，請儲存載入器的 last_state 屬性，並在再次建立載入器時傳入它。這將確保只載入新的記錄。

last_state = loader.last_state  # store safely

incremental_loader = AirbyteGongLoader(
    config=config, stream_name="calls", state=last_state
)

new_docs = incremental_loader.load()

相關

• 文件載入器概念指南 conceptual guide
• 文件載入器操作指南 how-to guides