CData Sync App は、Authorize.net データをデータベース、データレイク、またはデータウェアハウスに継続的にパイプライン化する簡単な方法を提供し、分析、レポート、AI、および機械学習で簡単に利用できるようにします。
Authorize.net コネクタはCData Sync アプリケーションから使用可能で、Authorize.net からデータを取得して、サポートされている任意の同期先に移動できます。
Authorize.net API の最新バージョンです。Transaction Reporting とCustomer Profiles エンドポイントで構成されます。
必須プロパティについては、設定タブを参照してください。
通常必須ではない接続プロパティについては、高度な設定タブを参照してください。
接続の前に、Merchant アカウントにログインし、Account -> Settings に移動します。 アカウントのSecurity Settings セクションにLoginID とTransactionKey が表示されます。
接続するには以下を設定します。
このセクションでは、Authorize.net Sync App の高度な機能を厳選して説明します。
Sync App はユーザー定義ビューの使用をサポートします。これは事前設定されたユーザー定義クエリによって内容が決定される仮想テーブルです。 このビューは、ドライバーに発行されるクエリを直接制御できない場合に有効です。 カスタムビューの作成と設定の概要については、ユーザー定義ビュー を参照してください。
SSL の設定 を使用して、Sync App が証明書のネゴシエーションをどのように扱うかを調整します。さまざまな証明書形式を選択できます。詳しくは、「接続文字列オプション」にあるSSLServerCert プロパティを参照してください。
Windows プロキシとHTTP プロキシを含むファイアウォールとプロキシ に合致するようSync App を設定します。トンネル接続を設定することもできます。
詳しくは、クエリ処理 を参照してください。
デフォルトでは、Sync App はサーバーとのTLS のネゴシエーションを試みます。サーバー証明書は、デフォルトのシステム信頼済み証明書ストアで検証されます。SSLServerCert 接続プロパティを使用して、証明書の検証方法をオーバーライドできます。
別の証明書を指定するには、SSLServerCert 接続プロパティを参照してください。
HTTP プロキシへの認証には、以下のように設定します。
次のプロパティを設定します。
CData Sync App はAuthorize.net API をリレーショナルビュー、もしくは読み取り専用のテーブルとしてモデル化します。これらは、簡単なテキストベースのコンフィギュレーションファイルであるスキーマファイルにて定義されます。
このセクションでは、API の制限および要件について説明します。既定のSupportEnhancedSQL 機能を使って、これらの制限の大半を回避できます。
ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。
クエリは、ビューに対して通常のテーブルと同様に実行することができます。
| Name | Description |
| BatchStatistics | Query BatchStatistics for an Authorize.net merchant account. |
| CustomerProfileDetails | Query Customer Profile Details for Authorize.net merchant account. |
| CustomerProfiles | Query Customer Profile IDs for Authorize.net merchant account. |
| CustomerProfileTransactionList | Query Transactions in a batch for an Authorize.net merchant account. |
| SettledBatchList | Query settled batches for an Authorize.net merchant account. |
| TransactionDetailItems | Query TransactionDetails to retrieve Items for an Authorize.net merchant account. |
| TransactionDetails | Query TransactionDetails for an Authorize.net merchant account. |
| TransactionList | Query Transactions in a batch for an Authorize.net merchant account. |
| UnsettledTransactionList | Query Unsettled Transactions for an Authorize.net merchant account. |
Query BatchStatistics for an Authorize.net merchant account.
BatchId は、WHERE 句でサポートされている唯一使用可能なカラムで、BatchStatistics から結果を取得する必要があります。BatchId は、(=)演算子またはIN 演算子と一緒に使用できます。
SELECT * FROM BatchStatistics WHERE BatchId = '236274'
SELECT * FROM BatchStatistics WHERE BatchId IN ('236274', '237832')
| Name | Type | Statistic | Description |
| BatchId [KEY] | String | The unique batch Id. | |
| AccountType [KEY] | String | The card type for this transaction (including eCheck). Valid values are Visa, MasterCard, AmericanExpress, Discover, JCB, DinersClub, and eCheck. Note a batch will contain either credit card or eCheck statistics, because eCheck transactions go in their own batch.
使用できる値は次のとおりです。Visa, MasterCard, AmericanExpress, Discover, JCB, DinersClub, eCheck | |
| SettlementTime | Datetime | Date and time the batch was settled. | |
| SettlementState | String | The status of the batch. Valid values are settledSuccessfully or error.
使用できる値は次のとおりです。settledSuccessfully, error | |
| PaymentMethod | String | The payment method associated with the batch. Valid values are creditCard or eCheck.
使用できる値は次のとおりです。creditCard, eCheck | |
| MarketType | String | The market type associated with the batch. Valid values are 0 (eCommerce), 1 (MOTO), or 2 (Retail). | |
| Product | String | The product associated with the batch. Valid values are Card Not Present or Card Present.
使用できる値は次のとおりです。Card Not Present, Card Present | |
| ReturnedItemAmount | Decimal | The total amount of all returned items. Only applicable for eCheck transactions. | |
| ReturnedItemCount | Integer | The total count of all returned items. Only applicable for eCheck transactions. | |
| ChargeBackAmount | Decimal | The total amount of all charge backs. Only applicable for credit card transactions. | |
| ChargeBackCount | Integer | The total count of all charge backs. Only applicable for credit card transactions. | |
| CorrectionNoticeCount | Integer | The total count of all correction notices. Only applicable for credit card transactions. | |
| ChargeChargeBackAmount | Decimal | Only applicable for credit card transactions. | |
| ChargeChargeBackCount | Integer | Only applicable for credit card transactions. | |
| BatchStatisticsAmount | Decimal | The total amount of all transactions as returned in the response of a getBatchStatistics call. Only applicable for credit card transactions. | |
| BatchStatisticsCount | Integer | The total count of all transactions as returned in the response of a getBatchStatistics call. Only applicable for credit card transactions. | |
| ChargeReturnedItemsAmount | Decimal | The total amount of returned items purchased using credit cards. | |
| ChargeReturnedItemsCount | Integer | The total count of returned items purchased using credit cards. | |
| RefundReturnedItemsAmount | Decimal | The total amount of returned items that have been refunded. | |
| RefundReturnedItemsCount | Integer | The total count of returned items that have been refunded. | |
| ChargeAmount | Decimal | The total amount of all charge (i.e., Sale) transactions. | |
| ChargeCount | Integer | The total count of all charge transactions. | |
| RefundAmount | Decimal | The total amount of all refund transactions. | |
| RefundCount | Integer | The total count of all refund transactions. | |
| VoidCount | Integer | The total count of all voided transactions. | |
| DeclineCount | Integer | The total count of all declined transactions. | |
| ErrorCount | Integer | The total count of all transactions that resulted in an error. |
Query Customer Profile Details for Authorize.net merchant account.
CustomerProfileId は、WHERE 句でサポートされている唯一使用可能なカラムで、CustomerProfileDetails から結果を取得する必要があります。CustomerProfileId は、(=)演算子またはIN 演算子と一緒に使用できます。
SELECT * FROM CustomerProfileDetails WHERE CustomerProfileId = '1915622429'
SELECT * FROM CustomerProfileDetails WHERE CustomerProfileId IN ('1915622429', '3215422449')
| Name | Type | Statistic | Description |
| MerchantCustomerId | String | Merchant-assigned customer reference ID. Must be unique among all of the customer IDs stored with profiles to be able to retrieve. | |
| CustomerProfileId [KEY] | String | Payment gateway-assigned ID associated with the customer profile.This output is present only for successful requests. | |
| String | Email address associated with the customer profile. | ||
| Description | String | Description of the customer or customer profile. Required only when no values for merchantCustomerId and email are submitted. | |
| FirstName | String | First name associated with customer's billing address. | |
| LastName | String | Last name associated with customer's billing address. | |
| Company | String | Company associated with customer's billing address. | |
| Address | String | Customer's billing address. | |
| City | String | City of customer's billing address. | |
| State | String | State of customer's billing address. | |
| Zip | String | The postal code of customer's billing address. | |
| Country | String | Country of customer's billing address. | |
| PhoneNumber | String | Phone number associated with customer's billing address. | |
| FaxNumber | String | Fax number associated with customer's billing address. | |
| DefaultPaymentProfile | Boolean | Indicates whether this profile is the default.If a customer profile does not have a default payment profile, then the defaultPaymentProfile element is not displayed in the getCustomerProfileResponse.If a profile has multiple payment profiles, the default profile returns defaultPaymentProfile set to true. Non-default profiles do not return defaultPaymentProfile. | |
| CustomerPaymentProfileId | String | Payment gateway assigned ID associated with the customer payment profile. | |
| CardNumber | String | The customer's masked credit card number. All sensitive payment information in the output is masked. | |
| ExpirationDate | String | The expiration date for the customer's credit card. | |
| CardType | String | Type of credit card. Possible values: Visa, Mastercard, AmericanExpress, Discover, JCB, or DinersClub. | |
| IssuerNumber | String | Unique identifier (IIN) for the issuer of the card. This element is only returned if you set the includeIssuerInfo field to true in the request. | |
| IsPaymentToken | Boolean | Indicates whether the payment method used an encrypted token. | |
| AccountType | String | The type of bank account used for the eCheck.net transaction. Possible values: checking, savings, or businessChecking. | |
| RoutingNumber | String | The ABA routing number. | |
| AccountNumber | String | The bank account number. | |
| NameOnAccount | String | Name of the person who holds the bank account. | |
| EcheckType | String | The type of eCheck transaction. Do not use TEL, ARC, or BOC for recurring charges. Possible values:PPD, WEB, or CCD. | |
| BankName | String | The name of the bank. |
Query Customer Profile IDs for Authorize.net merchant account.
| Name | Type | Statistic | Description |
| CustomerProfileId | String | The ID number associated with a customer profile. |
Query Transactions in a batch for an Authorize.net merchant account.
CustomerProfileId は、WHERE 句でサポートされている唯一使用可能なカラムで、CustomerProfileTransactionList から結果を取得する必要があります。CustomerProfileId は、(=)演算子またはIN 演算子と一緒に使用できます。
SELECT * FROM TransactionList WHERE CustomerProfileId = '1915622429'
SELECT * FROM TransactionList WHERE CustomerProfileId IN ('1915622429', '3543535')
| Name | Type | Statistic | Description |
| TransId [KEY] | String | The unique transaction Id. | |
| SubmitTime | Datetime | Date and time the transaction was submitted. | |
| SettlementTimeLocal | Datetime | Date and time the transaction was submitted in local format: YYYY-MM-DDTHH:MM:SS.mmm | |
| TransactionStatus | String | The status of the transaction. | |
| InvoiceNumber | String | The invoice number for the transaction. | |
| FirstName | String | The first name of the customer for the transaction. | |
| LastName | String | The last name of the customer for the transaction. | |
| AccountType | String | The card type for this transaction (including eCheck). Valid values are: Visa, MasterCard, AmericanExpress, Discover, JCB, DinersClub, eCheck.
使用できる値は次のとおりです。Visa, MasterCard, AmericanExpress, Discover, JCB, DinersClub, eCheck | |
| AccountNumber | String | The account number for the transaction. | |
| SettleAmount | Decimal | The amount that was submitted for settlement. | |
| HasReturnedItems | Boolean | Indicates that this transaction contains returned items. | |
| SubscriptionId | String | The subscription Id. | |
| SubscriptionPayNum | Integer | Identifies the number of this transaction, in terms of how many transactions have been submitted for this subscription. | |
| MarketType | String | The market type used to process the transaction. Valid values: 0 (eCommerce), 1 (MOTO), 2 (Retail). | |
| Product | String | The product method used to process the transaction. Valid values: Card Not Present, Card Present.
使用できる値は次のとおりです。Card Not Present, Card Present | |
| MobileDeviceId | String | The unique identifier of the mobile device. | |
| CustomerProfileId | String | The ID number associated with the customer profile. | |
| CustomerPaymentProfileId | String | The ID of the customer payment profile used to charge this transaction. |
Query settled batches for an Authorize.net merchant account.
次のカラムはWHERE 句で指定され、SetteldBatchList テーブルで使われます:IncludeStatistics およびSettlementTime。SettlementTime は'>'、'>='、'<='、および'<' 演算子をサポートしており、範囲を指定することができます。デフォルトの日付範囲は、現在の年度の2年前のUTC 1月1日から現在までです。
クエリでSettlementTime の範囲が設定されていない場合、演算子により31日前もしくは31日後のデータを返します。IncludeStatistics のデフォルト値はfalse です。
IncludeStatistics =true に設定した場合、最初と最後のSettelmentTime を含むすべての範囲のstatistics となります。Statistic であるカラムには、以下のテーブルのStatistic = True というプロパティがあります。
SELECT * FROM SettledBatchList WHERE SettlementTime > '2014-09-01' AND SettlementTime < '2014-09-20' AND IncludeStatistics = 'false'
2年前の1月1日から現時点までのデータを取得します。
SELECT * FROM SettledBatchList
SettlementTime 値より後のデータを取得します。
SELECT * FROM SettledBatchList WHERE SettlementTime > '2014-09-01'
SettlementTime 値より前のデータを取得します。
SELECT * FROM SettledBatchList WHERE SettlementTime <= '2014-09-01'
| Name | Type | Statistic | Description |
| BatchId [KEY] | String | The unique batch Id. | |
| SettlementTime | Datetime | Date and time the batch was settled. | |
| SettlementState | String | The status of the batch. Valid values are settledSuccessfully or error.
使用できる値は次のとおりです。settledSuccessfully, error | |
| PaymentMethod | String | The payment method associated with the batch. Valid values are creditCard or eCheck.
使用できる値は次のとおりです。creditCard, eCheck | |
| MarketType | String | The market type associated with the batch. Valid values are 0 (eCommerce), 1 (MOTO), or 2 (Retail). | |
| Product | String | The product associated with the batch. Valid values are Card Not Present or Card Present.
使用できる値は次のとおりです。Card Not Present, Card Present | |
| TotalCharge | Decimal | True | The total charged amount. |
| TotalRefund | Decimal | True | The total refunded amount. |
| Name | Type | Description |
| IncludeStatistics | Boolean | Identifies whether to retrieve the batch statistics in addition to the basic batch details. The default value is false. |
Query TransactionDetails to retrieve Items for an Authorize.net merchant account.
TransId は、WHERE 句でサポートされている唯一使用可能なカラムで、TransactionDetailItems から結果を取得する必要があります。TransId は、(=)演算子またはIN 演算子と一緒に使用できます。
SELECT * FROM TransactionDetailItems WHERE TransId = '23478353'
SELECT * FROM TransactionDetailItems WHERE TransId IN ('23478353', '23479147')
| Name | Type | Statistic | Description |
| TransId [KEY] | String | The unique transaction Id. | |
| ItemId [KEY] | String | The Id assigned to an item. | |
| BatchId | String | The Id of the batch the transaction is in. | |
| SettlementTime | Datetime | Date and time the transaction was settled. | |
| SettlementState | String | Status of the batch. Valid values: settledSuccessfully, settlementError, pendingSettlement. | |
| ResponseCode | Integer | The overall status of the transaction. Valid values: 1 (Approved), 2 (Declined), 3 (Error), 4 (Held for review).
使用できる値は次のとおりです。1, 2, 3, 4 | |
| InvoiceNumber | String | The invoice number for the transaction. | |
| PurchaseOrderNumber | String | The purchase order number for the transaction. | |
| AuthAmount | Decimal | The amount authorized or refunded. | |
| CustomerId | String | The merchant-assigned customer Id. | |
| CustomerEmail | String | The email address of the customer. | |
| ReturnedItemId | String | The transaction ID for returned item. | |
| ReturnedItemDate | Datetime | Date the item was returned. | |
| ReturnedItemCode | String | The ACH return code. | |
| ReturnedItemDescription | String | A text description of the reason for the return. | |
| ItemName | String | The short description of the item. | |
| ItemDescription | String | The detailed description of the item. | |
| ItemQuantity | Double | The number of items sold. | |
| ItemUnitPrice | Decimal | The cost of the item per unit, excluding tax, freight, and duty. | |
| ItemTaxable | Boolean | Indicates whether the item is subject to tax. |
Query TransactionDetails for an Authorize.net merchant account.
TransId は、WHERE 句でサポートされている唯一使用可能なカラムで、TransactionDetails から結果を取得する必要があります。TransId は、(=)演算子またはIN 演算子と一緒に使用できます。
SELECT * FROM TransactionDetails WHERE TransId = '23478353'
SELECT * FROM TransactionDetails WHERE TransId IN ('23478353', '23479147')
| Name | Type | Statistic | Description |
| TransId [KEY] | String | The unique transaction Id. | |
| RefTransId | String | The transaction Id of the original transaction. This only appears for linked credits (transaction type refundTransaction). | |
| SplitTenderId | String | Identifies the split tender order, if applicable. This only appears for transactions that are part of a larger partial authorization order. | |
| SubmitTime | Datetime | Date and time the transaction was submitted. | |
| TransactionType | String | The type of transaction that was originally submitted. Valid values: authCaptureTransaction, authOnlyTransaction, captureOnlyTransaction, refundTransaction.
使用できる値は次のとおりです。authCaptureTransaction, authOnlyTransaction, captureOnlyTransaction, refundTransaction | |
| TransactionStatus | String | The status of the transaction. | |
| ResponseCode | Integer | The overall status of the transaction. Valid values: 1 (Approved), 2 (Declined), 3 (Error), 4 (Held for review).
使用できる値は次のとおりです。1, 2, 3, 4 | |
| ResponseReasonCode | Integer | A code that represents more details about the result of the transaction. | |
| ResponseReasonDescription | String | A brief description of the result, which corresponds with the response reason code. | |
| AuthCode | String | The authorization or approval code. | |
| AVSResponse | String | Response from the AVS security check. Indicates the result of the AVS filter. | |
| CardCodeResponse | String | Response from the card code security check. Indicates the result of the CCV filter. | |
| CAVVResponse | String | The cardholder authentication verification response code. | |
| FDSFilterAction | String | The action taken for a transaction that triggered one or more of the Advanced Fraud Detection Suite filters. Valid values: reject, decline, hold, authAndHold, report. | |
| FDSFiltersName | String | A comma-separated list of fraud filter names. | |
| FDSFiltersAction | String | A comma-separated list of fraud filter settings. | |
| BatchId | String | The Id of the batch the transaction is in. | |
| SettlementTime | Datetime | Date and time the transaction was settled. | |
| SettlementState | String | Status of the batch. Valid values: settledSuccessfully, settlementError, pendingSettlement.
使用できる値は次のとおりです。settledSuccessfully, settlementError, pendingSettlement | |
| InvoiceNumber | String | The invoice number for the transaction. | |
| Description | String | The description of the transaction. | |
| PurchaseOrderNumber | String | The purchase order number for the transaction. | |
| RequestedAmount | Decimal | The amount requested. This will only be present for partial authorization transactions. For other transactions it is not listed because it is always the same as AuthAmount. | |
| AuthAmount | Decimal | The amount authorized or refunded. | |
| SettleAmount | Decimal | The amount that was submitted for settlement. | |
| TaxAmount | Decimal | The amount of the tax. | |
| TaxName | String | The name of the tax. | |
| TaxDescription | String | The description of the tax. | |
| ShippingAmount | Decimal | The amount charged for shipping. | |
| ShippingName | String | The name of the shipping charges. | |
| ShippingDescription | String | The description of the shipping charges. | |
| DutyAmount | Decimal | The amount of the duty. | |
| DutyName | String | The name of the duty. | |
| DutyDescription | String | The description of the duty. | |
| PrepaidBalanceRemaining | Decimal | The amount remaining on the prepaid card at the time of the transaction. | |
| TaxExempt | Boolean | Indicates whether the item is tax exempt. | |
| CardNumber | String | The credit card number. | |
| CardExpirationDate | String | The expiration date. | |
| CardAccountType | String | The type of credit card. Valid values: Visa, MasterCard, AmericanExpress, Discover, JCB, DinersClub.
使用できる値は次のとおりです。Visa, MasterCard, AmericanExpress, Discover, JCB, DinersClub | |
| BankRoutingNumber | String | The routing number of the bank. | |
| BankAccountNumber | String | The masked bank account number. | |
| BankNameOnAccount | String | The name on the bank account. | |
| BankEcheckType | String | The echeck type used for the transaction. Valid values: PPD, WEB, CCD, TEL.
使用できる値は次のとおりです。PPD, WEB.CCD.TEL | |
| CustomerType | String | The customer type. Valid values: individual, business.
使用できる値は次のとおりです。individual, business | |
| CustomerId | String | The merchant-assigned customer Id. | |
| CustomerEmail | String | The email address of the customer. | |
| BillToFirstName | String | The first name associated with the billing address of the customer. | |
| BillToLastName | String | The last name associated with the billing address of the customer. | |
| BillToCompany | String | The company name associated with the billing address of the customer. | |
| BillToAddress | String | The billing address of the customer. | |
| BillToCity | String | The city of the billing address of the customer. | |
| BillToState | String | The state of the billing address of the customer. | |
| BillToZip | String | The ZIP of the billing address of the customer. | |
| BillToCountry | String | The country of the billing address of the customer. | |
| BillToPhoneNumber | String | The phone number for the billing address of the customer. | |
| BillToFaxNumber | String | The fax number for the billing address of the customer. | |
| ShipToFirstName | String | The first name associated with the shipping address of the customer. | |
| ShipToLastName | String | The last name associated with the shipping address of the customer. | |
| ShipToCompany | String | The company name associated with the shipping address of the customer. | |
| ShipToAddress | String | The shipping address of the customer. | |
| ShipToCity | String | The city of the shipping address of the customer. | |
| ShipToState | String | The state of the shipping address of the customer. | |
| ShipToZip | String | The ZIP of the shipping address of the customer. | |
| ShipToCountry | String | The country of the shipping address of the customer. | |
| SubscriptionId | String | The subscription Id. | |
| SubscriptionPayNum | Integer | Identifies the number of this transaction, in terms of how many transactions have been submitted for this subscription. | |
| SolutionId | String | The solution Id generated by Authorize.net and provided to the solution provider. | |
| SolutionName | String | The name generated by the solution provider and provided to Authorize.net. | |
| CustomerIP | String | The IP address for the customer. | |
| MobileDeviceId | String | The unique identifier of the mobile device. | |
| MarketType | String | The market type used to process the transaction. Valid values: 0 (eCommerce), 1 (MOTO), 2 (Retail). | |
| Product | String | The product method used to process the transaction. Valid values: Card Not Present, Card Present.
使用できる値は次のとおりです。Card Not Present, Card Present |
Query Transactions in a batch for an Authorize.net merchant account.
BatchId は、WHERE 句でサポートされている唯一使用可能なカラムで、TransactionList から結果を取得する必要があります。BatchId は、(=)演算子またはIN 演算子と一緒に使用できます。
SELECT * FROM TransactionList WHERE BatchId = '35353'
SELECT * FROM TransactionList WHERE BatchId IN ('35353', '34219')
| Name | Type | Statistic | Description |
| TransId [KEY] | String | The unique transaction Id. | |
| BatchId | String | The unique batch Id. | |
| SubmitTime | Datetime | Date and time the transaction was submitted. | |
| SettlementTimeLocal | Datetime | Date and time the transaction was submitted in local format: YYYY-MM-DDTHH:MM:SS.mmm | |
| TransactionStatus | String | The status of the transaction. | |
| InvoiceNumber | String | The invoice number for the transaction. | |
| FirstName | String | The first name of the customer for the transaction. | |
| LastName | String | The last name of the customer for the transaction. | |
| AccountType | String | The card type for this transaction (including eCheck). Valid values are: Visa, MasterCard, AmericanExpress, Discover, JCB, DinersClub, eCheck.
使用できる値は次のとおりです。Visa, MasterCard, AmericanExpress, Discover, JCB, DinersClub, eCheck | |
| AccountNumber | String | The account number for the transaction. | |
| SettleAmount | Decimal | The amount that was submitted for settlement. | |
| HasReturnedItems | Boolean | Indicates that this transaction contains returned items. | |
| SubscriptionId | String | The subscription Id. | |
| SubscriptionPayNum | Integer | Identifies the number of this transaction, in terms of how many transactions have been submitted for this subscription. | |
| MarketType | String | The market type used to process the transaction. Valid values: 0 (eCommerce), 1 (MOTO), 2 (Retail). | |
| Product | String | The product method used to process the transaction. Valid values: Card Not Present, Card Present.
使用できる値は次のとおりです。Card Not Present, Card Present | |
| MobileDeviceId | String | The unique identifier of the mobile device. |
Query Unsettled Transactions for an Authorize.net merchant account.
このテーブルは、WHERE 句のカラムをサポートしていません。
SELECT * FROM UnsettledTransactionList
| Name | Type | Statistic | Description |
| TransId [KEY] | String | The unique transaction Id. | |
| SubmitTime | Datetime | Date and time the transaction was submitted. | |
| TransactionStatus | String | The status of the transaction. | |
| InvoiceNumber | String | The invoice number for the transaction. | |
| FirstName | String | The first name of the customer for the transaction. | |
| LastName | String | The last name of the customer for the transaction. | |
| AccountType | String | The card type for this transaction (including eCheck). Valid values are: Visa, MasterCard, AmericanExpress, Discover, JCB, DinersClub, eCheck. | |
| AccountNumber | String | The account number for the transaction. | |
| SettleAmount | Decimal | The amount that was submitted for settlement. | |
| HasReturnedItems | Boolean | Indicates that this transaction contains returned items. | |
| SubscriptionId | String | The subscription Id. | |
| SubscriptionPayNum | String | Identifies the number of this transaction, in terms of how many transactions have been submitted for this subscription. | |
| MarketType | String | The market type used to process the transaction. Valid values: 0 (eCommerce), 1 (MOTO), 2 (Retail). | |
| Product | String | The product method used to process the transaction. Valid values: Card Not Present, Card Present.
使用できる値は次のとおりです。Card Not Present, Card Present |
| プロパティ | 説明 |
| LoginID | Authorize.net ログインId。 |
| TransactionKey | Authorize.net トランザクションキー。 |
| UseSandbox | Sandbox アカウントを使用していることを示すboolean。provider はデフォルトで、本番環境にリクエストを行います。 |
| プロパティ | 説明 |
| SSLServerCert | TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。 |
| プロパティ | 説明 |
| FirewallType | provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。 |
| FirewallServer | ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。 |
| FirewallPort | プロキシベースのファイアウォールで使用するTCP ポートを指定します。 |
| FirewallUser | プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。 |
| FirewallPassword | プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。 |
| プロパティ | 説明 |
| ProxyAutoDetect | provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。 |
| ProxyServer | HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。 |
| ProxyPort | クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー(ProxyServer 接続プロパティで設定)のTCP ポート。 |
| ProxyAuthScheme | ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。 |
| ProxyUser | ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。 |
| ProxyPassword | ProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。 |
| ProxySSLType | ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。 |
| ProxyExceptions | ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。 |
| プロパティ | 説明 |
| LogModules | ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。 |
| プロパティ | 説明 |
| Location | テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。 |
| BrowsableSchemas | レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。 |
| Tables | レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。 |
| Views | レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。 |
| プロパティ | 説明 |
| MaxRows | 集計やGROUP BY を使用しないクエリで返される最大行数を指定します。 |
| Other | 特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。 |
| PseudoColumns | テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。 |
| Timeout | provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。 |
| UserDefinedViews | カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。 |
このセクションでは、本プロバイダーの接続文字列で設定可能なAuthentication プロパティの全リストを提供します。
| プロパティ | 説明 |
| LoginID | Authorize.net ログインId。 |
| TransactionKey | Authorize.net トランザクションキー。 |
| UseSandbox | Sandbox アカウントを使用していることを示すboolean。provider はデフォルトで、本番環境にリクエストを行います。 |
Authorize.net ログインId。
ペイメントゲートウェイアカウントに紐づいているAPI ログインId。このプロパティは、[Account]->[Security Settings]で確認でき、利用者がウェブサイトトランザクションを提出する権限があるかを認証するために使われます。Merchant Interface にログインするときのログインId とは異なります。
Authorize.net トランザクションキー。
ペイメントゲートウェイアカウントに紐づいているトランザクションキー。このプロパティは、[Account]->[Security Settings]で確認でき、利用者がウェブサイトトランザクションを提出する権限があるかを認証するために使われます。
Sandbox アカウントを使用していることを示すboolean。provider はデフォルトで、本番環境にリクエストを行います。
プロセス処理に使われるAuthorize.net API。プロダクションアカウントを使用している場合、このプロパティを指定する必要はありません。開発アカウントを利用している場合には、このプロパティをTrue に設定します。
このセクションでは、本プロバイダーの接続文字列で設定可能なSSL プロパティの全リストを提供します。
| プロパティ | 説明 |
| SSLServerCert | TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。 |
TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。
TLS/SSL 接続を使用する場合は、このプロパティを使用して、サーバーが受け入れるTLS/SSL 証明書を指定できます。コンピュータによって信頼されていない他の証明書はすべて拒否されます。
このプロパティは、次のフォームを取ります:
| 説明 | 例 |
| フルPEM 証明書(例では省略されています) | -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE----- |
| 証明書を保有するローカルファイルへのパス。 | C:\cert.cer |
| 公開鍵(例では省略されています) | -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY----- |
| MD5 Thumbprint (hex 値はスペースおよびコロン区切り) | ecadbdda5a1529c58a1e9e09828d70e4 |
| SHA1 Thumbprint (hex 値はスペースおよびコロン区切り) | 34a929226ae0819f2ec14b4a3d904f801cbb150d |
これを指定しない場合は、マシンが信用するすべての証明書が受け入れられます。
すべての証明書の受け入れを示すには、'*'を使用します。セキュリティ上の理由から、これはお勧めできません。
このセクションでは、本プロバイダーの接続文字列で設定可能なFirewall プロパティの全リストを提供します。
| プロパティ | 説明 |
| FirewallType | provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。 |
| FirewallServer | ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。 |
| FirewallPort | プロキシベースのファイアウォールで使用するTCP ポートを指定します。 |
| FirewallUser | プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。 |
| FirewallPassword | プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。 |
provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。
プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。
プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。
Note:デフォルトでは、Sync App はシステムプロキシに接続します。この動作を無効化し、次のプロキシタイプのいずれかに接続するには、ProxyAutoDetect をfalse に設定します。
次の表は、サポートされている各プロトコルのポート番号情報です。
| プロトコル | デフォルトポート | 説明 |
| TUNNEL | 80 | Sync App がAuthorize.net への接続を開くポート。トラフィックはこの場所のプロキシを経由して行き来します。 |
| SOCKS4 | 1080 | Sync App がAuthorize.net への接続を開くポート。SOCKS 4 は次にFirewallUser 値をプロキシに渡し、接続リクエストが許容されるかどうかを決定します。 |
| SOCKS5 | 1080 | Sync App がAuthorize.net にデータを送信するポート。SOCKS 5 プロキシに認証が必要な場合には、FirewallUser およびFirewallPassword をプロキシが認識する認証情報に設定します。 |
HTTP プロキシへの接続には、ProxyServer およびProxyPort ポートを使ってください。HTTP プロキシへの認証には、ProxyAuthScheme、ProxyUser、およびProxyPassword を使ってください。
ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。
プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。
プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。
プロキシベースのファイアウォールで使用するTCP ポートを指定します。
プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。
プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。
プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。
プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。
プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。
プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。
プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。
プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。
このセクションでは、本プロバイダーの接続文字列で設定可能なProxy プロパティの全リストを提供します。
| プロパティ | 説明 |
| ProxyAutoDetect | provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。 |
| ProxyServer | HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。 |
| ProxyPort | クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー(ProxyServer 接続プロパティで設定)のTCP ポート。 |
| ProxyAuthScheme | ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。 |
| ProxyUser | ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。 |
| ProxyPassword | ProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。 |
| ProxySSLType | ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。 |
| ProxyExceptions | ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。 |
provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。
この接続プロパティをTrue に設定すると、Sync App は既存のプロキシサーバー構成についてシステムプロキシ設定をチェックします(プロキシサーバーの詳細を手動で入力する必要はありません)。
この接続プロパティは他のプロキシ設定より優先されます。特定のプロキシサーバーに接続するためにSync App を手動で構成する場合は、False に設定します。
HTTP プロキシへの接続には、ProxyServer を参照してください。SOCKS やトンネリングなどの他のプロキシには、FirewallType を参照してください。
HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。
ProxyAutoDetect がFalse に設定されている場合、Sync App はこの接続プロパティで指定されたプロキシサーバーを通じてのみHTTP トラフィックをルーティングします。ProxyAutoDetect がTrue に設定されている場合(デフォルト)、Sync App は代わりにシステムプロキシ設定で指定されたプロキシサーバーを介してHTTP トラフィックをルーティングします。
クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー(ProxyServer 接続プロパティで設定)のTCP ポート。
ProxyAutoDetect がFalse に設定されている場合、Sync App はこの接続プロパティで指定されたプロキシサーバーポートを通じてのみHTTP トラフィックをルーティングします。ProxyAutoDetect がTrue に設定されている場合(デフォルト)、Sync App は代わりにシステムプロキシ設定で指定されたプロキシサーバーポートを介してHTTP トラフィックをルーティングします。
その他のプロキシタイプについては、FirewallType を参照してください。
ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。
認証タイプは次のいずれかです。
"NONE" 以外のすべての値については、ProxyUser およびProxyPassword 接続プロパティも設定する必要があります。
SOCKS 5 認証のような他の認証タイプを使用するには、FirewallType を参照してください。
ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。
ProxyUser および ProxyPassword 接続プロパティは、ProxyServer で指定されたHTTP プロキシに対して接続よび認証するために使用されます。
ProxyAuthScheme で利用可能な認証タイプを1つ選択した後、このプロパティを以下のように設定します。
| ProxyAuthScheme の値 | ProxyUser に設定する値 |
| BASIC | プロキシサーバーに登録されているユーザーのユーザー名。 |
| DIGEST | プロキシサーバーに登録されているユーザーのユーザー名。 |
| NEGOTIATE | プロキシサーバーが属するドメインまたは信頼されたドメイン内の有効なユーザーであるWindows ユーザーのユーザー名。user@domain またはdomain\user の形式で指定。 |
| NTLM | プロキシサーバーが属するドメインまたは信頼されたドメイン内の有効なユーザーであるWindows ユーザーのユーザー名。user@domain またはdomain\user の形式で指定。 |
| NONE | ProxyPassword 接続プロパティは設定しないでください。 |
Sync App は、ProxyAutoDetect がFalse に設定されている場合にのみ、このユーザー名を使用します。ProxyAutoDetect がTrue に設定されている場合(デフォルト)、Sync App は代わりにシステムのプロキシ設定で指定されているユーザー名を使用します。
ProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。
ProxyUser および ProxyPassword 接続プロパティは、ProxyServer で指定されたHTTP プロキシに対して接続よび認証するために使用されます。
ProxyAuthScheme で利用可能な認証タイプを1つ選択した後、このプロパティを以下のように設定します。
| ProxyAuthScheme の値 | ProxyPassword に設定する値 |
| BASIC | ProxyUser で指定したプロキシサーバーユーザーに紐付けられたパスワード。 |
| DIGEST | ProxyUser で指定したプロキシサーバーユーザーに紐付けられたパスワード。 |
| NEGOTIATE | ProxyUser で指定したWindows ユーザーアカウントに紐付けられたパスワード。 |
| NTLM | ProxyUser で指定したWindows ユーザーアカウントに紐付けられたパスワード。 |
| NONE | ProxyPassword 接続プロパティは設定しないでください。 |
SOCKS 5 認証もしくは、トンネリングは、FirewallType を参照してください。
Sync App は、ProxyAutoDetect がFalse に設定されている場合にのみ、このパスワードを使用します。ProxyAutoDetect がTrue に設定されている場合(デフォルト)、Sync App は代わりにシステムのプロキシ設定で指定されているパスワードを使用します。
ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。
このプロパティは、ProxyServer で指定されたHTTP プロキシへの接続にSSL を使用するかどうかを決定します。この接続プロパティには、以下の値を設定できます。
| AUTO | デフォルト設定。ProxyServer がHTTPS URL に設定されている場合、Sync App は、TUNNEL オプションを使用します。ProxyServer がHTTP URL に設定されている場合、コンポーネントはNEVER オプションを使用します。 |
| ALWAYS | 接続は、常にSSL 有効となります。 |
| NEVER | 接続は、SSL 有効になりません。 |
| TUNNEL | 接続はトンネリングプロキシ経由で行われます。プロキシサーバーがリモートホストへの接続を開き、プロキシを経由して通信が行われます。 |
ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。
ProxyServer は、このプロパティで定義されたアドレスを除くすべてのアドレスに使用されます。セミコロンを使用してエントリを区切ります。
Sync App はデフォルトでシステムプロキシ設定を使用するため、それ以上の設定は必要ありません。この接続にプロキシ例外を明示的に設定する場合は、ProxyAutoDetect をFalse に設定します。
このセクションでは、本プロバイダーの接続文字列で設定可能なLogging プロパティの全リストを提供します。
| プロパティ | 説明 |
| LogModules | ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。 |
ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。
このプロパティは、含めるログモジュールを指定することでログファイルの内容をカスタマイズすることができます。 ログモジュールは、クエリ実行、メタデータ、SSL 通信などの異なる領域にログ情報を分類します。 各モジュールは4文字のコードで表され、文字の名前の場合は末尾にスペースが必要なものもあります。
例えば、EXEC はクエリ実行をログに記録し、INFO は一般的なプロバイダーメッセージをログに記録します。 複数のモジュールを含めるには、次のように名前をセミコロンで区切ります:INFO;EXEC;SSL。
Verbosity 接続プロパティは、このプロパティで指定されたモジュールベースのフィルタリングよりも優先されます。 Verbosity レベルを満たし、指定されたモジュールに属するログエントリのみが記録されます。 利用可能なすべてのモジュールをログファイルに含めるには、このプロパティを空白のままにします。
利用可能なモジュールの完全なリストとログの設定に関する詳細な手引きについては、ログ の「高度なログの記録」セクションを参照してください。
このセクションでは、本プロバイダーの接続文字列で設定可能なSchema プロパティの全リストを提供します。
| プロパティ | 説明 |
| Location | テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。 |
| BrowsableSchemas | レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。 |
| Tables | レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。 |
| Views | レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。 |
テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。
Location プロパティは、定義をカスタマイズしたり(例えば、カラム名を変更する、カラムを無視するなど)、新しいテーブル、ビュー、またはストアドプロシージャでデータモデルを拡張する場合にのみ必要です。
指定しない場合、デフォルトの場所は%APPDATA%\\CData\\AuthorizeNet Data Provider\\Schema となり、%APPDATA%はユーザーのコンフィギュレーションディレクトリに設定されます:
| プラットフォーム | %APPDATA% |
| Windows | APPDATA 環境変数の値 |
| Linux | ~/.config |
レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
利用可能なデータベーススキーマをすべてリストすると余分な時間がかかり、パフォーマンスが低下します。 接続文字列にスキーマのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。
レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。
データベースによっては、利用可能なすべてのテーブルをリストするのに時間がかかり、パフォーマンスが低下する場合があります。 接続文字列にテーブルのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。
利用可能なテーブルがたくさんあり、すでに作業したいテーブルが決まっている場合、このプロパティを使用して対象のテーブルのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいテーブルを指定します。各テーブルは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space` です。
Note:複数のスキーマまたはカタログを持つデータソースに接続する場合は、表示する各テーブルを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するテーブルが混同されることを防ぎます。
レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。
データベースによっては、利用可能なすべてのビューをリストするのに時間がかかり、パフォーマンスが低下する場合があります。 接続文字列にビューのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。
利用可能なビューがたくさんあり、すでに作業したいビューが決まっている場合、このプロパティを使用して対象のビューのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいビューを指定します。各ビューは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space` です。
Note:複数のスキーマまたはカタログを持つデータソースに接続する場合は、確認する各ビューを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するビューが混同されることを防ぎます。
このセクションでは、本プロバイダーの接続文字列で設定可能なMiscellaneous プロパティの全リストを提供します。
| プロパティ | 説明 |
| MaxRows | 集計やGROUP BY を使用しないクエリで返される最大行数を指定します。 |
| Other | 特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。 |
| PseudoColumns | テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。 |
| Timeout | provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。 |
| UserDefinedViews | カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。 |
集計やGROUP BY を使用しないクエリで返される最大行数を指定します。
このプロパティは、集計やGROUP BY 句を含まないクエリに対してSync App が返す行数の上限を設定します。 この制限により、クエリがデフォルトで過度に大きな結果セットを返さないようにします。
クエリにLIMIT 句が含まれている場合、クエリで指定された値がMaxRows 設定よりも優先されます。 MaxRows が"-1" に設定されている場合、LIMIT 句が明示的にクエリに含まれていない限り、行の制限は行われません。
このプロパティは、非常に大きなデータセットを返す可能性のあるクエリを実行する際に、パフォーマンスを最適化し過剰なリソース消費を防ぐのに役立ちます。
特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。
このプロパティは、シニアユーザーが特定のシナリオに対して隠しプロパティを設定できるようにします。 これらの設定は通常のユースケースには必要ありませんが、特定の要件に対応したり、追加の機能を提供したりすることができます。 複数のプロパティをセミコロン区切りのリストで定義できます。
Note: 特定のシナリオや問題に対処するためにサポートチームから助言があった場合にのみ、これらのプロパティを設定することを強く推奨します。
複数のプロパティをセミコロン区切りリストで指定します。
| DefaultColumnSize | データソースがメタデータにカラムの長さを提供しない場合に、文字列フィールドのデフォルトの長さを設定します。デフォルト値は2000です。 |
| ConvertDateTimeToGMT | 日時の値を、マシンのローカルタイムではなくGMT グリニッジ標準時に変換するかどうかを決定します。 |
| RecordToFile=filename | 基底のソケットデータ転送を指定のファイルに記録します。 |
テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。
このプロパティを使用すると、Sync App がテーブルカラムとして公開する擬似カラムを定義できます。
個々の擬似カラムを指定するには、以下の形式を使用します。"Table1=Column1;Table1=Column2;Table2=Column3"
すべてのテーブルのすべての擬似カラムを含めるには、次のようにします:"*=*"
provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。
このプロパティは、Sync App が操作をキャンセルする前に操作の完了を待機する最大時間を秒単位で制御します。 操作の完了前にタイムアウト時間が経過すると、Sync App は操作をキャンセルして例外をスローします。
タイムアウトは、クエリや操作全体ではなくサーバーとの個々の通信に適用されます。 例えば、各ページング呼び出しがタイムアウト制限内に完了する場合、クエリは60秒を超えて実行を続けることができます。
このプロパティを0に設定するとタイムアウトが無効になり、操作が成功するか、サーバー側のタイムアウト、ネットワークの中断、またはサーバーのリソース制限などの他の条件で失敗するまで無期限に実行されます。 このプロパティは慎重に使用してください。長時間実行される操作がパフォーマンスを低下させたり、応答しなくなる可能性があるためです。
カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。
このプロパティを使用すると、UserDefinedViews.json というJSON 形式の構成ファイルを通じてカスタムビューを定義および管理できます。 これらのビューはSync App によって自動的に認識され、標準のデータベースビューのようにカスタムSQL クエリを実行できるようになります。 JSON ファイルは、各ビューをルート要素として定義し、その子要素として"query" を持ちます。この"query" にはビューのSQL クエリが含まれています。次に例を示します。
{
"MyView": {
"query": "SELECT * FROM SettledBatchList WHERE MyColumn = 'value'"
},
"MyView2": {
"query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
}
}
このプロパティを使用して、1つのファイルに複数のビューを定義し、ファイルパスを指定できます。 例:UserDefinedViews=C:\Path\To\UserDefinedViews.json。 このプロパティを使用すると、指定されたビューのみがSync App によって検知されます。
詳しくは、ユーザー定義ビュー を参照してください。