ODBC Driver for Microsoft SharePoint Excel

Build 24.0.9062

Linux DSN の構成

このセクションでは、以下のいくつかのLinux ディストリビューションでODBC 接続をセットアップしDSN を設定する方法を説明します：Ubuntu のようなDebian ベースのシステム、Red Hat Enterprise Linux (RHEL)、およびFedora のようなRed Hat Linux プラットフォーム。

Linux の最小バージョン

Red Hat ベースおよびDebian ベースシステムでサポートされる最小バージョンは以下のとおりです。

OSMin. Version
Ubuntu18.04
Debian10
RHEL8
Fedora28
SUSE15

ドライバー依存関係のインストール

必要な依存関係をインストールするには、次のコマンドをルートとしてまたはsudo で実行します。

  • Debian/Ubuntu: 
    apt-get install libc6 libstdc++6 zlib1g libgcc1
  • RHEL/Fedora: 
    yum install glibc libstdc++ zlib libgcc

ドライバーのインストール

標準のパッケージ管理システムを使用してドライバーをインストールできます。

Ubuntu のようなDebian ベースのシステムでは、次のコマンドをroot またはsudo で実行します。 

dpkg -i /path/to/driver/setup/Microsoft SharePoint ExcelODBCDriverforUnix.deb

RPM パッケージ形式をサポートするシステムでは、次のコマンドをroot またはsudo で実行します。 

rpm -ivh /path/to/driver/Microsoft SharePoint ExcelODBCDriverforUnix.rpm

ドライバーのライセンス

次のコマンドを実行して本製品 のライセンスを取得します。評価版をアクティベートするには、<key> の入力を省略してください。 

cd /opt/cdata/cdata-odbc-driver-for-excelservices/bin/
sudo ./install-license.sh <key>

ドライバーマネージャー経由の接続

ドライバーマネージャーはドライバーをロードし、アプリケーションからドライバーに関数呼び出しを渡します。本製品 をドライバーマネージャーに登録して、ドライバーマネージャーのコンフィギュレーションファイルにDSN を定義する必要があります。

本製品 のインストールでは、本製品 をunixODBC ドライバーマネージャーに登録し、システムDSN を作成します。UnixODBC ドライバーマネージャーは、Python やその他多くのアプリケーションから使用できます。アプリケーションに別のドライバーマネージャーが組み込まれている可能性があります。

DSN の作成

unixODBC をインストールしてDSN を設定するには、unixODBC の使用 を参照してください。OBIEE、Informatica、およびSAS に接続するDSN を作成するには、DataDirect ドライバーマネージャーの使用 を参照してください。

このセクションでは、SharePoint Online およびSharePoint On Premises への接続に関する詳細について説明します。

ワークブックへの接続

使用しているSharePoint のエディションに関わらず、File をExcel ワークブックに設定します。このパスは次のプロパティからの相対パスです。

  • Library：デフォルトでは、Shared Documents ライブラリが使用されます。このプロパティを使って、組織内の別のドキュメントライブラリを指定できます。例えば、OneDrive for Business に接続する場合は、このプロパティを"Documents" に設定します。
  • Folder：このプロパティを使って、ライブラリ内のサブフォルダへのパスを指定できます。パスはLibrary で指定されたライブラリ名と関連があります。

テーブルとしてのスプレッドシートデータへの接続

本製品 は、基底のAPI の使用可能なオブジェクトに基づいて使用可能なテーブルを検出します。

API は異なるAPI オブジェクトを表示します。スプレッドシートの構成とSharePoint のバージョンに基づいてAPI を選択します。

  • OData： OData API を使用すると、Excel で［挿入］->［テーブル］をクリックして作成されたExcel テーブルオブジェクト（範囲やスプレッドシートではありません）から定義されたテーブルにアクセスできます。OData API に接続する際、ワークブックにテーブルオブジェクトが定義されていない場合は、本製品 がテーブルを返さないことがあります。テーブルとしてスプレッドシートまたは範囲に接続するには、UseRESTAPI をtrue に設定します。
  • REST： REST API を使用すると、Excel テーブルオブジェクト、範囲、およびスプレッドシートから定義されたテーブルへのアクセスを可能にします。これはデフォルトのAPI です。範囲およびスプレッドシートから多数の行をリクエストすることはREST API によって制限されており、本製品 では返される行数をデフォルトで100に制限しています。また本製品 は、デフォルトで1行目からカラム名を検出します。これを無効にするには、Header を設定します。

DefineTables を追加設定すると、Excel の範囲の構文を使用して、範囲に基づいてテーブルを定義できます。大きすぎる範囲は、API によって制限されます。

本製品 がテーブルを検出してそれらをクエリする方法について、詳しくはData Model を参照してください。

SharePoint オンプレミスへの接続

Url をサーバー名もしくはIP アドレスに設定します。さらに、SharePointVersion および認証値を設定します。

SharePoint OnPremise を認証するには、AuthScheme を認証タイプに設定し、必要に応じてUser およびPassword を設定します。

Note：SharePoint On-Premises 2010に接続する場合は、 UseRESTAPI をtrue に設定する必要があります。

  • Windows（NTLM）

    これは最も一般的な認証タイプです。そのため、本製品 はNTLM をデフォルトとして使用するように事前設定されています。Windows のUser およびPassword を設定して接続します。

  • Kerberos

    Kerberos で認証する方法についての詳細は、Kerberos の使用 を参照してください。

  • Forms

    この設定で、Active Directory の代わりにカスタム認証メソッドによる認証が可能になります。この認証タイプを使用するには、AuthScheme をFORMS に設定し、User およびPassword を設定します。

  • ADFS

    AuthScheme をADFS に設定します。次の接続プロパティを設定する必要があります。

    • User：ADFS ユーザーに設定。
    • Password：ユーザーのADFS パスワードに設定。
    • SSOLoginURL：ADFS サーバーのWS-Trust エンドポイントに設定。
    次のSSOProperties がADFS への認証に必要です。
    • RelyingParty：SharePoint のADFS サーバー上の証明書利用者の識別子の値です。
    以下は接続文字列の例です。 
    AuthScheme=ADFS;User=ADFSUserName;Password=ADFSPassword;SSOLoginURL=https://<authority>/adfs/services/trust/2005/usernamemixed;SSO Properties ='RelyingParty=urn:sharepoint:sp2016;';

  • Anonymous Access

    Set the AuthScheme to NONE along with the URL.

ドライバーエンコーディングの設定

ODBC ドライバーは、ODBC ドライバーマネージャーで使用するエンコーディングを指定する必要があります。デフォルトでは、Unix 用のCData ODBC ドライバーはunixODBC と互換性のあるUTF-16 を使用するように設定されていますが、他のドライバーマネージャーでは代替エンコーディングが必要な場合があります。

また、ANSI ODBC API を使用するアプリケーションからODBC ドライバーを使用している場合は、ANSI コードページを設定する必要があります。例えば、ANSI アプリケーションに日本語の文字をインポートするには、設定ファイル'/opt/cdata/cdata-odbc-driver-for-excelservices/lib/cdata.odbc.excelservices.ini' でコードページを指定できます。 

[Driver]
AnsiCodePage = 932

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 24.0.9062