本頁面由 Cloud Translation API 翻譯而成。

使用 ML.TRANSCRIBE 函式轉錄音訊檔案

本文說明如何搭配遠端模型使用 ML.TRANSCRIBE 函式，從物件資料表轉錄音訊檔案。

支援的地點

您必須在下列任一位置中建立此程序中使用的遠端模型：

asia-northeast1
asia-south1
asia-southeast1
australia-southeast1
eu
europe-west1
europe-west2
europe-west3
europe-west4
northamerica-northeast1
us
us-central1
us-east1
us-east4
us-west1

您必須在與遠端模型相同的區域中執行 ML.TRANSCRIBE 函式。

所需權限

如要使用 Speech-to-Text 辨識器，您需要具備下列角色：
- speech.recognizers.create
- speech.recognizers.get
- speech.recognizers.recognize
- speech.recognizers.update
如要建立連結，您必須具備下列角色的成員資格：
- roles/bigquery.connectionAdmin
如要使用 BigQuery ML 建立模型，您必須具備下列權限：
- bigquery.jobs.create
- bigquery.models.create
- bigquery.models.getData
- bigquery.models.updateData
- bigquery.models.updateMetadata
如要執行推論，您需要具備下列權限：
- 物件資料表上的 bigquery.tables.getData
- 模型的 bigquery.models.getData
- bigquery.jobs.create

事前準備

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the BigQuery, BigQuery Connection API, and Speech-to-Text APIs.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the BigQuery, BigQuery Connection API, and Speech-to-Text APIs.

Enable the APIs

建立辨識器

Speech-to-Text 支援稱為辨識器的資源。辨識器代表儲存且可重複使用的辨識設定。您可以建立辨識器，將應用程式的轉錄稿或流量以邏輯方式分組。

您可以選擇是否建立語音辨識工具。如果您選擇建立語音辨識器，請記下辨識器的專案 ID、位置和辨識器 ID，以便在 CREATE MODEL 陳述式中使用，如 SPEECH_RECOGNIZER 所述。如果您選擇不建立語音辨識器，則必須為 ML.TRANSCRIBE 函式的 recognition_config 引數指定值。

您只能在語音辨識器或您提供的 recognition_config 值中使用 chirp 轉錄模型。

建立資料集

建立 BigQuery 資料集來容納資源：

控制台

前往 Google Cloud 控制台的「BigQuery」頁面。

前往「BigQuery」頁面
在「Explorer」窗格中，按一下專案名稱。
依序點選「View actions」(查看動作) >「Create dataset」(建立資料集)。
在「Create dataset」頁面上執行下列操作：
- 在「Dataset ID」(資料集 ID) 部分，輸入資料集名稱。
- 在「位置類型」中，選取資料集的位置。
- 點選「建立資料集」。

bq

如要建立新的資料集，請使用 bq mk 指令搭配 --location 標記：
```
bq --location=LOCATION mk -d DATASET_ID
```
更改下列內容：
- LOCATION：資料集的位置。
- DATASET_ID 是您要建立的資料集 ID。
確認資料集已建立：
```
bq ls
```

建立連線

如果您已設定具備適當權限的預設連線，可以略過這個步驟。

為遠端模型建立Cloud 資源連線，並取得連線的服務帳戶。請在與您在上一個步驟中建立的資料集相同的位置建立連線。

選取下列選項之一：

主控台

前往「BigQuery」頁面

前往 BigQuery
在「Explorer」窗格中，按一下「新增資料」：

「Add data」對話方塊隨即開啟。
在「Filter By」窗格中的「Data Source Type」部分，選取「Business Applications」。

或者，您也可以在「Search for data sources」欄位中輸入 Vertex AI。
在「精選資料來源」部分，按一下「Vertex AI」。
按一下「Vertex AI 模型：BigQuery 聯盟」解決方案資訊卡。
在「連線類型」清單中，選取「Vertex AI 遠端模型、遠端函式和 BigLake (Cloud 資源)」。
在「連線 ID」欄位中，輸入連線的名稱。
點選「建立連線」。
按一下「前往連線」。
在「連線資訊」窗格中，複製服務帳戶 ID，以便在後續步驟中使用。

bq

在指令列環境中建立連線：
```
bq mk --connection --location=REGION --project_id=PROJECT_ID \
    --connection_type=CLOUD_RESOURCE CONNECTION_ID
```
--project_id 參數會覆寫預設專案。

更改下列內容：
- REGION：您的連線區域
- PROJECT_ID：您的 Google Cloud 專案 ID
- CONNECTION_ID：連線 ID
建立連線資源時，BigQuery 會建立專屬的系統服務帳戶，並將該帳戶與連線建立關聯。

疑難排解：如果您收到下列連線錯誤，請更新 Google Cloud SDK：
```
Flags parsing error: flag --connection_type=CLOUD_RESOURCE: value should be one of...
```

擷取並複製服務帳戶 ID，以便在後續步驟中使用：

bq show --connection PROJECT_ID.REGION.CONNECTION_ID

輸出結果會與下列內容相似：

name                          properties
1234.REGION.CONNECTION_ID     {"serviceAccountId": "connection-1234-9u56h9@gcp-sa-bigquery-condel.iam.gserviceaccount.com"}

Terraform

使用 google_bigquery_connection 資源。

如要向 BigQuery 進行驗證，請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。

以下範例會在 US 地區中建立名為 my_cloud_resource_connection 的 Cloud 資源連線：


# This queries the provider for project information.
data "google_project" "default" {}

# This creates a cloud resource connection in the US region named my_cloud_resource_connection.
# Note: The cloud resource nested object has only one output field - serviceAccountId.
resource "google_bigquery_connection" "default" {
  connection_id = "my_cloud_resource_connection"
  project       = data.google_project.default.project_id
  location      = "US"
  cloud_resource {}
}

如要在 Google Cloud 專案中套用 Terraform 設定，請完成下列各節中的步驟。

準備 Cloud Shell

啟動 Cloud Shell。
設定要套用 Terraform 設定的預設 Google Cloud 專案。

您只需為每個專案執行這個指令一次，而且可以在任何目錄中執行。
```
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
```
如果您在 Terraform 設定檔中設定明確的值，系統就會覆寫環境變數。

準備目錄

每個 Terraform 設定檔都必須有自己的目錄 (也稱為根模組)。

在 Cloud Shell 中建立目錄，並在該目錄中建立新檔案。檔案名稱必須包含 .tf 副檔名，例如 main.tf。在本教學課程中，檔案稱為 main.tf。
```
mkdir DIRECTORY && cd DIRECTORY && touch main.tf
```
如果您正在參考教學課程，可以複製各個章節或步驟中的程式碼範例。

將範例程式碼複製到新建立的 main.tf 中。

您可以視需要從 GitHub 複製程式碼。如果 Terraform 程式碼片段是端對端解決方案的一部分，建議您採用這種做法。
查看並修改要套用至環境的範例參數。
儲存變更。
初始化 Terraform。這項操作只需對每個目錄執行一次。
```
terraform init
```
如要使用最新版的 Google 供應器，您可以選擇加入 -upgrade 選項：
```
terraform init -upgrade
```

套用變更

檢查設定，確認 Terraform 要建立或更新的資源符合您的預期：
```
terraform plan
```
視需要修正設定。
執行下列指令，並在提示中輸入 yes，即可套用 Terraform 設定：
```
terraform apply
```
等待 Terraform 顯示「Apply complete!」(套用完成) 訊息。
開啟 Google Cloud 專案即可查看結果。在 Google Cloud 控制台中，前往 UI 中的資源，確認 Terraform 已建立或更新這些資源。

將存取權授予服務帳戶

選取下列選項之一：

主控台

前往「IAM & Admin」(IAM 與管理) 頁面。

前往「IAM & Admin」(IAM 與管理)
按一下「授予存取權」。

系統會開啟「Add principals」對話方塊。
在「新增主體」欄位，輸入先前複製的服務帳戶 ID。
按一下「請選取角色」欄位，然後在「篩選器」中輸入 Cloud Speech Client。
按一下 [Add another role] (新增其他角色)。
在「Select a role」(請選擇角色) 欄位中，依序選取「Cloud Storage」和「Storage Object Viewer」(Storage 物件檢視者)。
按一下 [儲存]。

gcloud

使用 gcloud projects add-iam-policy-binding 指令：

gcloud projects add-iam-policy-binding 'PROJECT_NUMBER' --member='serviceAccount:MEMBER' --role='roles/speech.client' --condition=None
gcloud projects add-iam-policy-binding 'PROJECT_NUMBER' --member='serviceAccount:MEMBER' --role='roles/storage.objectViewer' --condition=None

請依指示取代下列項目：

PROJECT_NUMBER：專案編號。
MEMBER：先前複製的服務帳戶 ID。

如未授予權限，就會發生 Permission denied 錯誤。

建立物件資料表

針對 Cloud Storage 中的一組音訊檔案建立物件資料表。物件表中的音訊檔案必須是支援的類型。

物件資料表使用的 Cloud Storage 值區，應位於您打算建立模型並呼叫 ML.TRANSCRIBE 函式的專案中。如果您想在不同專案中呼叫 ML.TRANSCRIBE 函式，而該專案不包含物件資料表使用的 Cloud Storage 值區，則必須授予 service-A@gcp-sa-aiplatform.iam.gserviceaccount.com 服務帳戶值區層級的儲存空間管理員角色。

建立模型

建立遠端模型，其中包含 CLOUD_AI_SPEECH_TO_TEXT_V2 的 REMOTE_SERVICE_TYPE：

CREATE OR REPLACE MODEL
`PROJECT_ID.DATASET_ID.MODEL_NAME`
REMOTE WITH CONNECTION {DEFAULT | `PROJECT_ID.REGION.CONNECTION_ID`}
OPTIONS (
  REMOTE_SERVICE_TYPE = 'CLOUD_AI_SPEECH_TO_TEXT_V2',
  SPEECH_RECOGNIZER = 'projects/PROJECT_NUMBER/locations/LOCATION/recognizers/RECOGNIZER_ID'
);

請依指示取代下列項目：

PROJECT_ID：您的專案 ID。
DATASET_ID：包含模型的資料集 ID。
MODEL_NAME：模型名稱。
REGION：連線使用的區域。
CONNECTION_ID：連線 ID，例如 myconnection。
在 Google Cloud 控制台查看連線詳細資料時，連線 ID 是「連線 ID」中顯示的完整連線 ID 最後一節的值，例如 projects/myproject/locations/connection_location/connections/myconnection。
PROJECT_NUMBER：含有語音辨識器的專案專案編號。您可以在 Google Cloud 控制台的「資訊主頁」頁面中，找到「Project info」資訊卡中的這個值。
LOCATION：語音辨識器使用的地點。您可以在 Google Cloud 控制台的「List recognizers」頁面「Location」欄位中找到這個值。
RECOGNIZER_ID：語音辨識器 ID。您可以在 Google Cloud 控制台的「List recognizers」頁面「ID」欄位中找到這個值。
這個選項並非必要。如果您未指定值，系統會使用預設辨識器。在這種情況下，您必須為 ML.TRANSCRIBE 函式的 recognition_config 參數指定值，才能為預設辨識器提供設定。

您只能在您提供的 recognition_config 值中使用 chirp 轉錄模型。

轉錄音訊檔案

使用 ML.TRANSCRIBE 函式轉錄音訊檔案：

SELECT *
FROM ML.TRANSCRIBE(
  MODEL `PROJECT_ID.DATASET_ID.MODEL_NAME`,
  TABLE `PROJECT_ID.DATASET_ID.OBJECT_TABLE_NAME`,
  RECOGNITION_CONFIG => ( JSON 'recognition_config')
);

請依指示取代下列項目：

PROJECT_ID：您的專案 ID。
DATASET_ID：包含模型的資料集 ID。
MODEL_NAME：模型名稱。
OBJECT_TABLE_NAME：物件資料表的名稱，其中包含要處理的音訊檔案 URI。
recognition_config：JSON 格式的 RecognitionConfig 資源。
如果您已使用 SPEECH_RECOGNIZER 選項為遠端模型指定辨識器，就無法指定 recognition_config 值。

如果您尚未使用 SPEECH_RECOGNIZER 選項為遠端模型指定辨識器，則必須指定 recognition_config 值。這個值可用於為預設辨識器提供設定。

您只能在您提供的 recognition_config 值中使用 chirp 轉錄模型。

範例

範例 1

以下範例會轉錄 audio 資料表所代表的音訊檔案，但不會覆寫辨識器的預設設定：

SELECT *
FROM ML.TRANSCRIBE(
  MODEL `myproject.mydataset.transcribe_model`,
  TABLE `myproject.mydataset.audio`
);

以下範例會轉錄 audio 資料表所代表的音訊檔案，並為預設辨識器提供設定：

SELECT *
FROM ML.TRANSCRIBE(
  MODEL `myproject.mydataset.transcribe_model`,
  TABLE `myproject.mydataset.audio`,
  recognition_config => ( JSON '{"language_codes": ["en-US" ],"model": "chirp","auto_decoding_config": {}}')
);

後續步驟

如要瞭解 BigQuery ML 中的模型推論，請參閱「模型推論總覽」。
如要瞭解每個模型類型支援的 SQL 陳述式和函式，請參閱「每個模型的端對端使用者歷程」。