ODBC Driver for SharePoint

Build 20.0.7654

macOS DSN の構成

このセクションでは、macOS でODBC 接続をセットアップしDSN を設定する方法を示します:

macOS の最小バージョン

CData ODBC Driver for SharePoint 本製品 にはmacOS Sierra (10.12) 以上が必要です。

ドライバーのライセンス

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

cd "/Applications/CData ODBC Driver for SharePoint/bin"
sudo ./install-license <key>

名前とパスワードを入力するよう求められます。これらは、あなたの名前とマシンのパスワードを指します。

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

macOS では、CData ODBC Driver for SharePoint はFilemaker Pro、Microsoft Excel、Tableau のような他の多くの製品と同様に、iODBC ドライバーマネージャー用にあらかじめ設定されています。iODBC の最新バージョンは、iODBC サイトで入手できます。

ドライバーのインストールでは、iODBC にドライバーを登録しシステムDSN を作成します。これは、ODBC 接続をサポートするあらゆるツールやアプリケーションで使用できます。

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

DSN の設定

DSN の設定には、iODBC と同時にインストールされたGUI のiODBC アドミニストレータ64-bit を使用できます。ODBC マネージャーは、ODBC ドライバーのビット数と一致している必要があります。最新のCData ODBC Driver for SharePoint のバージョンは64-bit のみです。また、iODBC コンフィギュレーションファイルを編集することもできます。

ユーザーDSN またはシステムDSN を構成できます。ユーザーデータソースは、ユーザーアカウントに制限されています。システムデータソースは、すべてのユーザーがアクセスできます。

iODBC アドミニストレータでのDSN の設定

Launchpad からiODBC アドミニストレータ64-bit を起動することで、ユーザーDSN を作成できます。

ドライバーによってインストールされたシステムDSN を変更する、またはシステムDSN を作成するには、iODBC アドミニストレータ64-bit を昇格権限で起動します。それには、次のコマンドをターミナルに入力します。

sudo /Applications/iODBC/iODBC\ Administrator64.app/Contents/MacOS/iODBC\ Administrator64
iODBC アドミニストレータ64-bit を起動すると、CData SharePoint Source がSystem タブにリストされます。 DSN を選んで[設定]ボタンをクリックし、接続プロパティを名前と値のペアで設定します。

自分でDSN を作成するには、代わりに[User]か[System]タブで[Add]をクリックし、CData ODBC Driver for SharePoint オプションを選択します。

SharePoint への接続

グローバルSharepoint サイト内のすべてのLists およびDocuments を操作するには、URL をSite Collection に設定します。サイト内のLists およびDocuments のみを操作するには、URL を特定のサイトに設定します。

URLサンプルURL
サイトhttps://teams.contoso.com/teamA or https://teamA.contoso.com
サイトコレクションhttps://teams.contoso.com

URL の提供に加え、次の接続プロパティセットのどれかを使ってSharePoint に認証します。以下のように、デフォルト値を使用するとほとんどの環境で簡単に接続できます。

SharePoint Online への認証

SharePointEdition を"SharePoint Online" に設定し、User およびPassword をSharePoint へのログオンに使用するクレデンシャルに設定します。例えば、Microsoft Online Services アカウントへのクレデンシャルです。

次のSSO(シングルサインオン)アイデンティティプロバイダーもサポートされています:Azure Active Directory、OneLogin、およびOKTA。

  • SSO

    SharePoint Online でSSO を有効化している場合には、User およびPassword に加えて、UseSSO をtrue に設定します。

    もしユーザーアカウントのドメインがアイデンティティプロバイダーに設定されたドメインと異なる場合には、SSODomain をアイデンティティプロバイダーで設定されたドメインに設定します。 このプロパティは、AD FS、OneLogin、およびOKTA で必要な場合があります。

SharePoint On Premises への認証

以下の認証タイプを使用するには、SharePointEdition を"SharePoint OnPremise" に設定します。

  • Windows (NTLM)

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

  • Kerberos およびKerberos Delegation

    Kerberos を認証するには、AuthScheme をNEGOTIATE に設定します。必要があれば、User およびPassword を設定します。Kerberos Delegation を使う場合にAuthScheme をKERBEROSDELEGATION に設定します。

    KerberosKDCKerberosSPN、およびKerberosRealm では、Kerberos 認証のコンポーネントを制御できます。

  • Forms

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

MSI 認証による認証

Azure VM 上でSharePoint を実行している場合は、Managed Service Identity(MSI)の資格情報を利用して接続が可能です。

  • AuthSchemeAzureMSI に設定。

MSI 資格情報が認証用に自動的に取得されます。

OAuth の設定

iODBC アドミニストレータ64-bit などの一部のツールでは、OAuth ブラウザフローを完了するために次の接続プロパティを設定する必要があります。これらのツールから認証を行う場合は、DSN に次の接続プロパティを追加してOAuth フローが正しく実行されるようにする必要があります。

KeywordValue
OtherCheckPromptMode=False

iODBC INI ファイルでのDSN の設定

odbc.ini でDSN を設定します。ODBC ドライバーをodbcinst.ini に登録します。

odbc.ini

ODBC データソースを、odbc.ini ファイルのセクションに定義します。ユーザーデータソースにアクセスできるのは、odbc.ini ファイルがホームフォルダに格納されているユーザーアカウントだけです。システムデータソースは、すべてのユーザーがアクセスできます。

PrivilegesPath
User/Users/myuser/Library/ODBC/odbc.ini
System/Library/ODBC/odbc.ini

iODBC のシステム全体の設定を変更するには、権限を上げる必要があります。そのためには、root またはsudo コマンドを使用できます。次に例を示します。

sudo nano /Library/ODBC/odbc.ini

データソースへの接続に必要な接続プロパティに加えて、Driver プロパティでodbcinst.ini ファイルのドライバー定義またはドライバーライブラリへのパスを指定します。

[CData SharePoint Source]
Driver = CData ODBC Driver for SharePoint
User=MyUserAccount
Password=MyPassword
Auth Scheme=NTLM
URL=http://sharepointserver/mysite

さらに、ODBC データソースセクション内で、DSN をodbcinst.ini ファイルで定義されたドライバーに設定する必要があります。例えば、ドライバーのインストール時に作成されるDSN のエントリーは次のとおりです。

[ODBC Data Sources]
CData SharePoint Source = CData ODBC Driver for SharePoint

odbcinst.ini

パスを本製品 ライブラリに変更する場合は、インストールされたドライバー定義を変更する必要があります。

ODBC ドライバーを登録するには、odbcinst.ini ファイルを変更します。iODBC では、ドライバーは一つのユーザーアカウントでのみ、またはシステム全体で利用可能です。

PrivilegesPath
User/Users/myuser/Library/ODBC/odbcinst.ini
System/Library/ODBC/odbcinst.ini

ドライバーは、odbcinst.ini ファイルのセクションに定義されます。セクション名はドライバーの名前を指定します。このセクションでは、Driver プロパティはドライバーライブラリへのパスを指定します。ドライバーライブラリは、インストールディレクトリの[lib]サブフォルダにある.dylib ファイルです。デフォルトでは、/Applications/CData ODBC Driver for SharePoint 内に格納されます。

[CData ODBC Driver for SharePoint]
Driver = /Applications/CData ODBC Driver for SharePoint/lib/libsharepointodbc.dylib

ODBC ドライバーセクションには、ドライバー名が "Installed" に設定されたプロパティも含まれている必要があります。次に例を示します。

[ODBC Drivers]
CData ODBC Driver for SharePoint = Installed

接続のテスト

ほとんどのiODBC インストールで利用可能なiODBC デモを使って、SharePoint に接続しSQL クエリを実行できます。

iODBC デモ

iODBC デモから接続するには次の手順を実行してください。

  • Launchpad を開き"iODBC" を検索します。
  • ANSI ODBC API のみが使用可能なアプリケーションからSharePoint に接続する場合は、iODBC Demo Ansi をクリックします。それ以外の場合は、iODBC Demo Unicode をクリックします。
  • [Environment]メニューで[Open Connection]をクリックします。
  • 対応するタブでDSN を選択し、接続をテストします。
これで、SQL メニューで[Execute SQL]をクリックすることで&service; にSQL ステートメントを実行できます。

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

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

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

[Driver]
AnsiCodePage = 932

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

ドライバーをアンインストールする最も簡単な方法は、ターミナルを開いて、インストールディレクトリにあるuninstall.sh スクリプトを実行します。次に例を示します。

cd "/Applications/CData ODBC Driver for SharePoint"
sudo ./uninstall.sh

Note:このスクリプトはインストールディレクトリから実行される必要があります。

Copyright (c) 2020 CData Software, Inc. - All rights reserved.
Build 20.0.7654