

 Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 Python UDF 將繼續正常運作至 2026 年 6 月 30 日。如需詳細資訊，請參閱[部落格文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 Apple macOS 上使用 Amazon Redshift ODBC 驅動程式
<a name="odbc20-install-config-mac"></a>

您必須在存取 Amazon Redshift 資料倉儲的用戶端電腦上安裝 Amazon Redshift ODBC 驅動程式。對於您安裝驅動程式的每個電腦，下列最低需求如下：
+ 機器上的根存取。
+ Apple macOS 系統需求：
  + 需要 64 位元版本的 Apple macOS 11.7 版或更新版本 （例如 Apple macOS Big Sur、Monterey、Ventura 或更新版本）。Redshift ODBC 驅動程式僅支援 64 位元用戶端應用程式。
  + 150 MB 的可用磁碟空間
  + 驅動程式支援使用 iODBC 3.52.9\$1 或 unixODBC 2.3.7\$1 建置的應用程式。

# 下載並安裝 Amazon Redshift ODBC 驅動器
<a name="odbc20-install-mac"></a>

使用下列程序，在 Apple macOS 下載並安裝 Amazon Redshift ODBC 驅動程式。僅在您執行的第三方應用程式經認證可與 Amazon Redshift 搭配使用，且該應用程式需要特定驅動程式時，才使用不同的驅動程式。

若要下載並安裝 ODBC 驅動程式：

1. 下載下列驅動程式：[64 位元 ODBC 驅動程式 2.1.15.0 版](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.15.0/AmazonRedshiftODBC-64-bit.2.1.15.0.universal.pkg) 

   x86\$164 和 arm64 架構都支援此驅動程式。此驅動程式的名稱是 **Amazon Redshift ODBC 驅動程式 (x64)**。

1. 檢閱 [Amazon Redshift ODBC 驅動程式 2.x 版授權](https://github.com/aws/amazon-redshift-odbc-driver/blob/master/LICENSE)。

1. 按兩下 .pkg 檔案，然後依照精靈中的步驟安裝驅動程式。或者，執行下列命令：

   ```
   sudo installer -pkg PKGFileName -target /
   ```

   將 取代`PKGFileName`為 pkg 套件檔案名稱。例如，下列命令示範安裝 64 位元驅動程式：

   ```
   sudo installer -pkg ./AmazonRedshiftODBC-64-bit.X.X.XX.X.universal.pkg -target /
   ```

# 使用 ODBC 驅動器管理員設定 ODBC 驅動器
<a name="odbc20-config-mac"></a>

在 Mac 上，您可以使用 ODBC 驅動程式管理員來設定 ODBC 連線設定。ODBC 驅動程式管理員使用組態檔案來定義及設定 ODBC 資料來源和驅動程式。您使用的 ODBC 驅動程式管理員視您使用的作業系統而定。

## 使用 iODBC 或 unixODBC 驅動程式管理員設定 ODBC 驅動程式
<a name="odbc20-config-iodbc-mac"></a>

需要下列檔案才能設定 Amazon Redshift ODBC 驅動程式：
+ ` amazon.redshiftodbc.ini `
+ ` odbc.ini `
+ ` odbcinst.ini `

 如果是安裝到預設位置，則 `amazon.redshiftodbc.ini` 組態檔案位於 `/opt/amazon/redshiftodbcx64`。

 此外，在 `/opt/amazon/redshiftodbcx64` 下，您可以找到 `odbc.ini` 和 `odbcinst.ini` 範例檔案。您可以使用這些檔案做為設定 Amazon Redshift ODBC 驅動程式和資料來源名稱 (DSN) 的範例。所安裝目錄中的範例檔案僅供當作範例。

 不建議使用 Amazon Redshift ODBC 驅動程式安裝目錄來存放組態檔案。如果您後來重新安裝 Amazon Redshift ODBC 驅動程式，或升級為更新版本，安裝目錄會遭到覆寫。您會遺失對安裝目錄中的檔案所做的任何變更。

 若要避免這種情況，請將 `odbc.ini``odbcinst.ini`和 `amazon.redshiftodbc.ini` 檔案複製到安裝目錄以外的目錄。如果您將這些檔案複製到使用者的主目錄，請在這些檔案名稱的開頭新增句點 (.)，使其成為隱藏檔案。

 修改檔案以新增 DSN 組態資訊。建立新檔案時，您也需要設定環境變數，以指定這些組態檔案的位置。

以下是設定環境變數的範例：

```
export ODBCINI=/Library/ODBC/odbc.ini
export ODBCSYSINI=/Library/ODBC
export ODBCINSTINI=${ODBCSYSINI}/odbcinst.ini
```

對於命令列應用程式：將匯出命令新增至 shell 啟動檔案 （例如 `~/.bash_profile`或 `~/.zshrc`)。

如需驅動程式管理員的支援版本，請參閱[此處](https://docs.aws.amazon.com/redshift/latest/mgmt/odbc20-install-config-mac.html) 

### 在 Apple macOS 上使用資料來源名稱 (DSN) 設定連線
<a name="odbc20-dsn-mac"></a>

在使用資料來源名稱 (DSN) 連線至資料存放區時，請設定 `odbc.ini` 檔案來定義資料來源名稱 (DSN)。設定 `odbc.ini` 檔案中的屬性以建立 DSN，指定 Redshift 資料倉儲的連線資訊。

在 Apple macOS 上，使用下列格式：

```
[ODBC Data Sources]
driver_name=dsn_name

[dsn_name]
Driver=path/driver_file
Host=cluster_endpoint
Port=port_number
Database=database_name
locale=locale
```

下列範例顯示 Apple macOS 上`odbc.ini`具有 64 位元 ODBC 驅動程式的 組態。

```
[ODBC Data Sources]
Amazon_Redshift_x64=Amazon Redshift ODBC Driver (x64)

[Amazon_Redshift_x64]
Driver=/opt/amazon/redshiftodbcx64/librsodbc64.dylib
Host=examplecluster.abc123xyz789.us-west-2.redshift.amazonaws.com
Port=5932
Database=dev
locale=en-US
```

### 在 Apple macOS 上設定沒有 DSN 的連線
<a name="odbc20-no-dsn-mac"></a>

 若要透過沒有 DSN 的連線連線至 Redshift 資料倉儲，請在 `odbcinst.ini` 檔案中定義驅動程式。然後，在應用程式中提供無 DSN 的連線字串。

在 Apple macOS 上，使用下列格式：

```
[ODBC Drivers]
driver_name=Installed
...
                            
[driver_name]
Description=driver_description
Driver=path/driver_file
    
...
```

下列範例顯示 Apple macOS 上`odbcinst.ini`具有 64 位元 ODBC 驅動程式的 組態。

```
[ODBC Drivers]
Amazon Redshift ODBC Driver (x64)=Installed

[Amazon Redshift ODBC Driver (x64)]
Description=Amazon Redshift ODBC Driver (64-bit)
Driver=/opt/amazon/redshiftodbcx64/librsodbc64.dylib
```