ACCESSDATA コマンド

さまざまな ODBC 準拠データ ソースからデータをインポートします。

64 ビットと 32 ビットのどちらの ODBC ドライバーを使用するかによって、このコマンドは ACCESSDATA64 または ACCESSDATA32 という形を取ります。

構文

{ACCESSDATA64 | ACCESSDATA32} {CONNECTOR | ODBC {"ドライバー"|"Dsn"|"ファイル"}} NAME 値 <USER ユーザー ID> <PASSWORD 番号 | PROMPT_PASSWORD> <PASSWORD 数値 AS パスワード キー名<...n>> TO テーブル名 CHARMAX 最大フィールド長 MEMOMAX 最大フィールド長 <ALLCHARACTER> <ASYNC> SOURCE (接続設定) <HASH(ソルト値, フィールド)>
SQL_QUERY
(SQL 構文)
END_QUERY

パラメーター

HASH("QZ3x7", "SSN_NO, CC_NO, Last_Name")

例

ACCESSDATA64 CONNECTOR NAME "Amazon Redshift" USER "ACL_user" PROMPT_PASSWORD TO "Entitlement_History.FIL" CHARMAX 50 MEMOMAX 100 SOURCE( boolsaschar=0;cachesize=100;database=usage;declarefetchmode=0;maxbytea=255;maxlongvarchar=8190;maxvarchar=255;port=5439;servername=acl_test.highbond.com;singlerowmode=1;sslmode=require;textaslongvarchar=0;usemultiplestatments=0;useunicode=1)
  SQL_QUERY(
    SELECT
      "entitlement_history"."organization" AS "organization",
      "entitlement_history"."user_email" AS "user_email",
      "entitlement_history"."plan_id" AS "plan_id",
      "entitlement_history"."date_from" AS "date_from",
      "entitlement_history"."date_to" AS "date_to"
    FROM
      "prm"."entitlement_history" "entitlement_history"
  ) END_QUERY

ACCESSDATA32 ODBC "Driver" NAME "Microsoft Access Driver (*.mdb)" TO "Invoices.FIL" CHARMAX 50 MEMOMAX 100 SOURCE( dbq=C:\Users\lachlan_murray\Documents\ACL Data\Sample Data Files\Sample.mdb;defaultdir=C:\Users\lachlan_murray\Documents\ACL Data\Sample Data Files;driverid=281;fil=MS Access;maxbuffersize=2048;maxscanrows=8;pagetimeout=5;safetransactions=0;threads=3;usercommitsync=Yes)
  SQL_QUERY(
    SELECT
      `Customer`.`CustID` AS `CustID`,
      `Customer`.`Company` AS `Company`,
      `Customer`.`Address` AS `Address`,
      `Customer`.`City` AS `City`,
      `Customer`.`Region` AS `Region`,
      `Customer`.`PostalCode` AS `PostalCode`,
      `Customer`.`Country` AS `Country`,
      `Customer`.`Phone` AS `Phone`,
      `Orders`.`OrderID` AS `OrderID`,
      `Orders`.`CustID` AS `Orders_CustID`,
      `Orders`.`ProdID` AS `ProdID`,
      `Orders`.`OrderDate` AS `OrderDate`,
      `Orders`.`Quantity` AS `Quantity`,
      `Product`.`ProdID` AS `Product_ProdID`,
      `Product`.`ProdName` AS `ProdName`,
      `Product`.`UnitPrice` AS `UnitPrice`,
      `Product`.`Descript` AS `Descript`,
      `Product`.`ShipWt` AS `ShipWt`
    FROM
      (`Customer` `Customer`
    INNER JOIN
      `Orders` `Orders`
      ON `Customer`.`CustID` = `Orders`.`CustID`
      )
    INNER JOIN
      `Product` `Product`
      ON `Orders`.`ProdID` = `Product`.`ProdID`
    WHERE
    (
      `Customer`.`Region` = 'BC'
      OR `Customer`.`Region` = 'WA'
    )
  ) END_QUERY

ACCESSDATA32 ODBC "Dsn" NAME "Excel Files" TO "Trans_April_15_cutoff.FIL" CHARMAX 50 MEMOMAX 100 SOURCE( dbq=C:\Users\lachlan_murray\Documents\ACL Data\Sample Data Files\Trans_April.xls;defaultdir=C:\Users\lachlan_murray\Documents\ACL Data\Sample Data Files;driverid=1046;maxbuffersize=2048;pagetimeout=5)
  SQL_QUERY(
    SELECT
      `Trans_Apr_`.`CARDNUM` AS `CARDNUM`,
      `Trans_Apr_`.`AMOUNT` AS `AMOUNT`,
      `Trans_Apr_`.`TRANS_DATE` AS `TRANS_DATE`,
      `Trans_Apr_`.`CODES` AS `CODES`,
      `Trans_Apr_`.`CUSTNO` AS `CUSTNO`,
      `Trans_Apr_`.`DESCRIPTION` AS `DESCRIPTION`
    FROM
      `Trans_Apr$` `Trans_Apr_`
    WHERE
      (
          `Trans_Apr_`.`TRANS_DATE` <= {ts '2003-04-15 00:00:00'}
      )
  ) END_QUERY

備考

このコマンドの動作の詳細については、データ アクセス ウィンドウの作業を参照してください。

ACCESSDATA でパスワード定義を使用する

一般的に、ACCESSDATA コマンドで接続するデータソースでは、パスワード、トークン、または他のシークレット認証値を使用した認証が必要です。一部のデータソースでは、複数の認証値が必要です。

ACCESSDATA コマンドの一部として、複数のパスワード定義を指定してこの認証を提供できます。パスワード定義はパスワードや認証値自体ではありません。どちらかというと、パスワード変数のようなものであり、以前に入力されたパスワードや認証値を安全に保存します。ACCESSDATA コマンドでパスワード定義を指定すると、SOURCE で指定された接続設定で、実際のパスワードをクリアテキストに表示しないようにすることができます。

パスワード定義の作成

インポート スクリプトでは、パスワード定義を作成した後に、ACCESSDATA コマンドで定義を使用できます。

Analytics で使用するパスワード定義の作成については、PASSWORD コマンドを参照してください。Analytics

ロボットで使用するパスワード定義の作成については、PASSWORD タグを参照してください。Robots

パスワード定義を指定する 2 つのオプション

ACCESSDATA でパスワード定義を指定するときには 2 つのオプションがあります。

• PASSWORD数値単一のパスワードが必要なデータ ソースに対して、単一のパスワード定義を指定します。
• PASSWORD 数値 AS パスワード キー名 繰り返し使用して、複数の認証値が必要なデータソースで複数のパスワード定義を指定できます。

PASSWORD 1
ACCESSDATA64 CONNECTOR NAME "Concur" PASSWORD 1 TO "Concur_data_import.FIL" CHARMAX 50 MEMOMAX 100 SOURCE( auth_accesstoken=[$pwd];auth_type=OAuth 2.0;enabledoublebuffer=1;host=www.concursolutions.com;useencryptedendpoints=1;userparam=all)
  SQL_QUERY( 
    SELECT
      "List_Items"."Level_7_Code" AS "Level_7_Code",
      "List_Items"."Name" AS "Name",
      "List_Items"."Level_10_Code" AS "Level_10_Code",
      "List_Items"."Level_8_Code" AS "Level_8_Code",
      "List_Items"."URI" AS "URI",
      "List_Items"."Id" AS "Id",
      "List_Items"."Level_3_Code" AS "Level_3_Code",
      "List_Items"."List_Id" AS "List_Id",
      "List_Items"."Level_4_Code" AS "Level_4_Code",
      "List_Items"."Level_1_Code" AS "Level_1_Code",
      "List_Items"."Parent_Id" AS "Parent_Id",
      "List_Items"."Level_2_Code" AS "Level_2_Code",
      "List_Items"."Level_5_Code" AS "Level_5_Code",
      "List_Items"."Level_6_Code" AS "Level_6_Code",
      "List_Items"."Level_9_Code" AS "Level_9_Code" 
    FROM
      "Concur"."List_Items" "List_Items"
  ) END_QUERY

COMMENT
//ANALYTIC TYPE IMPORT Twitter データをインポート
//PASSWORD 1 OAuth クライアント ID を入力：
//PASSWORD 2 OAuth クライアント シークレットを入力：
//PASSWORD 3 OAuth アクセス トークンを入力：
//PASSWORD 3 OAuth アクセス トークン シークレットを入力：
//RESULT TABLE Twitter_user_data
END

ACCESSDATA64 CONNECTOR NAME "Twitter" PASSWORD 1 AS oauthclientid PASSWORD 2 AS oauthclientsecret PASSWORD 3 AS oauthaccesstoken PASSWORD 4 AS oauthaccesstokensecret TO "Twitter_user_data.FIL" CHARMAX 50 MEMOMAX 100 SOURCE( oauthclientid=;oauthclientsecret=;oauthaccesstoken=;oauthaccesstokensecret=;readonly=true;drivertype=ACL Connector for Twitter;connectonopen=true;convertdatetimetogmt=true;limitkeysize=255;maptolongvarchar=-1;maptowvarchar=true;uppercaseidentifiers=false;supportenhancedsql=true;proxyauthscheme=BASIC;proxyautodetect=true;_persist_=encrypted-dp{AQA ... kX3E8yyh05HoG1rH4bm1lhwudUQ==}})
  SQL_QUERY( 
    SELECT
      "Users"."ID" AS "ID",
      "Users"."Name" AS "Name",
      "Users"."Screen_Name" AS "Screen_Name",
      "Users"."Location" AS "Location",
      "Users"."Profile_URL" AS "Profile_URL",
      "Users"."Lang" AS "Lang",
      "Users"."Created_At" AS "Created_At",
      "Users"."Friends_Count" AS "Friends_Count",
      "Users"."Followers_Count" AS "Followers_Count",
      "Users"."Favourites_Count" AS "Favourites_Count",
      "Users"."Statuses_Count" AS "Statuses_Count",
      "Users"."Time_Zone" AS "Time_Zone",
      "Users"."Following" AS "Following",
      "Users"."Contributors_Enabled" AS "Contributors_Enabled",
      "Users"."Follow_Request_Sent" AS "Follow_Request_Sent",
      "Users"."Listed_Count" AS "Listed_Count",
      "Users"."Description" AS "Description",
      "Users"."Default_Profile" AS "Default_Profile"
    FROM
      "Twitter"."Users" "Users"
  ) END_QUERY

複数のパスワード定義で動作するように ACCESSDATA を構成する

複数のパスワード定義で動作するように ACCESSDATA コマンドを構成するには、コマンドに PASSWORD パラメーターを挿入し、SOURCE パラメーターのパスワード キー名を PASSWORD パラメーターにコピーします。

1. Analytics でデータ アクセス ウィンドウを使用して、複数の認証値が必要なデータソースからデータをインポートします。
2. ログの ACCESSDATA コマンドをスクリプト エディターで開いているスクリプトにコピーします。

   一般的に、1 つの認証値のみが SOURCE パラメーターでマスク（[$pwd]）されます。追加の値はクリアテキストで表示されます。例：

   SOURCE( oauthclientid=cXQ ... dR4;oauthclientsecret=QUt ... beo;oauthaccesstoken=913 ... cPn;oauthaccesstokensecret=[$pwd]; ... )

3. SOURCE パラメーターからクリアテキスト認証値を削除し、パスワード キー名と等号のみを残します。

   例：

   SOURCE( oauthclientid=;oauthclientsecret=;oauthaccesstoken=;oauthaccesstokensecret=[$pwd]; ... )

   メモ

   認証値は、PASSWORD コマンドまたは PASSWORD アナリティクス タグで作成されたパスワード定義を使用してユーザーが指定する必要があります。詳細については、パスワード定義の作成を参照してください。

4. 省略可能。マスクされた認証値の 1 つのパスワード キー名から [$pwd] を削除します。

   このパスワード キー名では、2 つの方法のいずれかを使用して、ACCESSDATA コマンドでパスワード定義を指定できます。詳細については、パスワード定義を指定する 2 つのオプションを参照してください。

5. PROMPT_PASSWORD パラメーターを ACCESSDATA コマンドから削除します。
6. PROMPT_PASSWORD を削除した場所に PASSWORD パラメーターを挿入し、SOURCE パラメーターのパスワード キー名をコピーして PASSWORD パラメーターに貼り付けます。

   例：

   ACCESSDATA64 CONNECTOR NAME "Twitter" PASSWORD 1 AS oauthclientid PASSWORD 2 AS oauthclientsecret PASSWORD 3 AS oauthaccesstoken PASSWORD 4 AS oauthaccesstokensecret ... SOURCE( oauthclientid=;oauthclientsecret=;oauthaccesstoken=;oauthaccesstokensecret=; ... )

   重要

   パスワード キー名は、SOURCE パラメーターと PASSWORD パラメーターで同じでなければなりません。異なる場合、ACCESSDATA コマンドが失敗します。

7. マスクされた認証値のパスワード キー名から [$pwd] を削除しなかった場合、単一のパスワード定義を指定する方法を使用します。

   例：

   ACCESSDATA64 CONNECTOR NAME "Twitter" PASSWORD 1 AS oauthclientid PASSWORD 2 AS oauthclientsecret PASSWORD 3 AS oauthaccesstoken PASSWORD 4 ... SOURCE( oauthclientid=;oauthclientsecret=;oauthaccesstoken=;oauthaccesstokensecret=[$pwd]; ... )

   結果 ACCESSDATA コマンドと個別に作成されたパスワード定義をインポートスクリプトで使用できます。SOURCE 接続設定にはクリアテキストの認証値は表示されません。

多要素認証は適切ではありません

多要素認証（MFA）が必要データソースにアクセスするには、ACCESSDATA コマンドを使用することはできません。スクリプトはこの方法で認証することができません。MFA で保護されたデータにアクセスする必要がある場合は、MFA が必要ではない汎用作業者アカウントの使用が組織で許可されているかどうかを確認してください。

データ コネクターの更新

Analytics またはロボット エージェントをアップグレードする場合は、いずれかの Analytics データ コネクターを使ってデータをインポートするスクリプト（ACCESSDATA コマンド）をテストする必要があります。

データ ソースまたは ODBC ドライバーのサード パーティ ベンダーが加えた変更により、1 つまたは複数のデータ コネクターを更新しなければならない可能性があります。スクリプトに作り込んだデータ接続を引き続き正常に動作させるには、それを更新する必要があります。

• インポートの再実行 接続機能を最も簡単に更新する方法は、更新されたバージョンの Analytics のデータ アクセス ウィンドウを使って、インポートを手動で実行することです。ログに記録されている ACCESSDATA コマンドをコピーし、それを使ってスクリプトを更新します。

  メモ

  データ ソースに接続してインポートを再実行する前に、コネクターのキャッシュを消去することで、既存の一連のテーブル名を削除します。

  データ アクセス ウィンドウの［既存の接続］タブで、接続名の横にある［ >キャッシュの消去］を選択します。

• フィールド指定の更新 データ ソースまたは ODBC ドライバーのテーブル スキーマの変更と一致するように、スクリプト本体内のフィールド指定を更新しなければならない場合もあります。必要に応じてフィールド名、フィールドのデータ型、およびフィールド長とレコード長を変更します。
• フィルター処理の結果の確認 データ インポートの一環として適用したフィルター処理の結果も確認する必要があります。インポートのフィルター処理によってレコードを正しく追加または除外できたかどうかを確認します。

ODBC 接続設定と SQL インポート文の作成

ODBC 接続設定と SQL インポート文は例に示すように通常、きわめて長く複雑です。

ACCESSDATA コマンドのこれらの部分を最も簡単に作成するには、まず Analytics の Data Access ウィンドウを使ってターゲットのデータ ソースに接続してからデータをインポートします。次に、ログから、接続設定やインポート文など ACCESSDATA コマンド全体をコピーし、必要に応じてこのコマンドをカスタマイズします。

ACCESSDATA ログ ファイル

2 つのログ ファイルは ACCESSDATA コマンドに関連付けられたトランザクションを記録し、データ接続が失敗した場合にトラブルシューティングで使用できます。

• ServerDataAccess.log はデータをインポートする前のすべての作業とエラーを記録します

  場所：C:\Users\<ユーザー アカウント>\AppData\Local\ACL\ACL for Windows\Data Access\ServerDataAccess.log

  メモ

  ServerDataAccess.log の "Server" は Analytics がインストールされているコンピューターでローカルに実行されている Analytics のデータ アクセス コンポーネントを参照します。

• DataAccess.log には、インポート操作に関する情報と、

  場所 ..\&lt;Analytics プロジェクト フォルダー&gt;\DataAccess.log

  にインポートしようとしているデータが含まれる Analytics プロジェクトに関する情報が記録されます。

ACCESSDATA でハッシュ化されたデータを ACLScript HASH( ) 関数でハッシュ化されたデータと比較する

ハッシュ データの未加工値を読み取れない場合でも、データの結合または分析時に役立ちます。

インポート中に ACCESSDATA でハッシュ化された値を、ACLScript の HASH( ) 関数を使用してハッシュ化された値と比較する場合は、Analytics の数値または日付時刻フィールドを文字値に変換し、データをハッシュ化する前に前後のスペースを切り取る必要があります。

文字に変換するときには、日付時刻フィールドは次の形式を使用する必要があります。

• 日付時刻 "YYYY-MM-DD hh:mm:ss"
• 日付 "YYYY-MM-DD"
• 時刻 "hh:mm:ss"

次の例は、STRING( ) および ALLTRIM( ) 関数を使用して、ACLScript's HASH( ) 関数を使用して値をハッシュ化する前に、数値のクレジットカード番号フィールドをを文字データに変換します。

COMMENT ACL HASH 関数は、データのインポート後に使用されます
HASH(ALLTRIM(STRING(CC_No, 16)), "QZ3x7")

Analytics 値をハッシュ化すると、ACCESSDATA コマンドインポートの一部としてハッシュ化された値を比較できます。

複数の SAPテーブルの並列でのインポート

複数の SAP テーブルを後続の分析の基礎としてAnalytics にインポートする必要がある場合、最も迅速で効率的な方法は、Analytics にインポートする前に SAP システムからテーブルを並列で、または非同期でダウンロードすることです。非同期ダウンロードに指定できるテーブルの合計数に制限はありませんが、一度に同時にダウンロードできるテーブルは 5 つのみです。

スクリプト作成のガイドライン

以下のガイドラインに従って、SAPテーブルの並列ダウンロードとそれに続くインポートをスクリプト化します。

• ACCESSDATA コマンドのブロック ACCESSDATA コマンドのブロックを作成します（ダウンロードする SAP テーブルごとに 1 つのコマンド）。ACCESSDATA コマンドのブロックは、他のタイプの ACLScript コマンドが間に入っていない、連続したものでなければなりません。

• 正しいビット版の使用 64 ビット版の ACCESSDATA コマンド (ACCESSDATA64) を使用します。32 ビット版の SAP GUI for Windows がインストールされている場合は、ACCESSDATA32 を使用できます。ただし、メモリ例外の可能性を避けるため、ACCESSDATA64 を使用することを推奨します。64 ビット版の SAP GUI がインストールされている場合は、ACCESSDATA64 を使用する必要があります。SAP GUI の詳細については、「ACLコネクター (SAP) の設定」を参照してください。

  ACCESSDATA コマンドの同じブロック内で ACCESSDATA64 と ACCESSDATA32 を混在させることはできません。

• ASYNC パラメーター 各 ACCESSDATA コマンドは ASYNC パラメーターを使用する必要があります。コマンドブロックの中に、非同期と同期の SAP ダウンロードを混在させることはできません。

• 接続文字列 ブロック内のすべてのコマンドは、同じ接続文字列を使用して同じ SAP サーバーに接続する必要があります。

• GETSAPDATA コマンド 最後の ACCESSDATA コマンドの直後に GETSAPDATA コマンドが続きます。他のどのタイプの ACLScript コマンドも間に入れることはできません（ただし COMMENT コマンドを除く）。

  SAP テーブルの並列ダウンロード後に、GETSAPDATA はダウンロードによって生成された Analytics テーブルを Analytics プロジェクトにインポートします。ACCESSDATA コマンドのブロック内のいずれかのダウンロード操作が失敗した場合、GETSAPDATA コマンドは失敗し、一部の SAP テーブルが正常にダウンロードされた場合でも、テーブルはプロジェクトに追加されません。

COMMENT：3 つの SAP テーブルの並列でのダウンロード

ACCESSDATA64 CONNECTOR NAME "SAP" USER "irosario" PASSWORD 1 TO "T001.FIL" CHARMAX 50 MEMOMAX 100 ASYNC SOURCE(server=192.0.2.255;client=800;language=EN;instancenumber=01;variablestringlength=256;TemporaryWorkingDirectory=Default)
  SQL_QUERY(
    SELECT * FROM T001
  ) END_QUERY

ACCESSDATA64 CONNECTOR NAME "SAP" USER "irosario" PASSWORD 1 TO "T002.FIL" CHARMAX 50 MEMOMAX 100 ASYNC SOURCE(server=192.0.2.255;client=800;language=EN;instancenumber=01;variablestringlength=256;TemporaryWorkingDirectory=Default)
  SQL_QUERY(
    SELECT * FROM T002
  ) END_QUERY

ACCESSDATA64 CONNECTOR NAME "SAP" USER "irosario" PASSWORD 1 TO "T003.FIL" CHARMAX 50 MEMOMAX 100 ASYNC SOURCE(server=192.0.2.255;client=800;language=EN;instancenumber=01;variablestringlength=256;TemporaryWorkingDirectory=Default)
  SQL_QUERY(
    SELECT * FROM T003
  ) END_QUERY

COMMENT：3 つのダウンロードしたテーブルの Analytics プロジェクトへのインポート

GETSAPDATA