(베타) 파일 기반 대상 서버 사양을 위한 서버 및 파일 구성

개요

중요

Adobe Experience Platform Destination SDK을 사용하여 파일 기반 대상을 구성하고 제출하는 기능은 현재 베타에 있습니다. 설명서 및 기능은 변경될 수 있습니다.

이 페이지에서는 파일 기반 대상 서버에 대한 모든 서버 구성 옵션에 대해 자세히 설명하고 Experience Platform에서 대상으로 파일을 내보내는 사용자에 대한 다양한 파일 구성 옵션을 설정하는 방법을 설명합니다.

파일 기반 대상의 서버 및 파일 구성 사양은 를 통해 Adobe Experience Platform Destination SDK에서 구성할 수 있습니다 /destination-servers 엔드포인트. 읽기 대상 서버 API 끝점 작업 전체 작업 목록을 보려면 종단점에서 수행할 수 있습니다.

파일 기반 Amazon S3 대상 서버 사양

{
    "name": "S3 destination",
    "destinationServerType": "FILE_BASED_S3",
    "fileBasedS3Destination": {
        "bucket": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.bucket}}"
        },
        "path": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.path}}"
        }
    },
    "fileConfigurations": {
       // See the file formatting configuration section further below on this page
    }
}
매개 변수 유형 설명
name 문자열 대상 연결의 이름입니다.
destinationServerType 문자열 대상 플랫폼에 따라 이 값을 설정합니다. 대상 Amazon S3으로 설정합니다. FILE_BASED_S3.
fileBasedS3Destination.bucket.templatingStrategy 문자열 필수 여부. PEBBLE_V1.
fileBasedS3Destination.bucket.value 문자열 의 이름 Amazon S3 이 대상에서 사용할 버킷입니다.
fileBasedS3Destination.path.templatingStrategy 문자열 필수 여부. PEBBLE_V1.
fileBasedS3Destination.path.value 문자열 내보낸 파일을 호스트할 대상 폴더의 경로입니다.
fileConfigurations 개체 자세한 내용은 파일 형식 구성 자세한 내용은 이 섹션에 대해 설명합니다.

파일 기반 SFTP 대상 서버 사양

{
   "name":"File-based SFTP destination server",
   "destinationServerType":"FILE_BASED_SFTP",
   "fileBasedSftpDestination":{
      "rootDirectory":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.rootDirectory}}"
      },
      "hostName":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.hostName}}"
      },
      "port": 22,
      "encryptionMode" : "PGP"
   },
    "fileConfigurations": {
       // See the file formatting configuration section further below on this page
    }
}
매개 변수 유형 설명
name 문자열 대상 연결의 이름입니다.
destinationServerType 문자열 대상 플랫폼에 따라 이 값을 설정합니다. 대상 SFTP 대상, 다음 위치로 설정 FILE_BASED_SFTP.
fileBasedSftpDestination.rootDirectory.templatingStrategy 문자열 필수 여부. PEBBLE_V1.
fileBasedSftpDestination.rootDirectory.value 문자열 대상 저장소의 루트 디렉토리입니다.
fileBasedSftpDestination.hostName.templatingStrategy 문자열 필수 여부. PEBBLE_V1.
fileBasedSftpDestination.hostName.value 문자열 대상 스토리지의 호스트 이름입니다.
port 정수 SFTP 파일 서버 포트입니다.
encryptionMode 문자열 파일 암호화를 사용할지 여부를 나타냅니다. 지원되는 값:
  • PGP
  • None
fileConfigurations 개체 자세한 내용은 파일 형식 구성 자세한 내용은 이 섹션에 대해 설명합니다.

파일 기반 Azure Data Lake Storage (ADLS) 대상 서버 사양

{
   "name":"ADLS destination server",
   "destinationServerType":"FILE_BASED_ADLS_GEN2",
   "fileBasedAdlsGen2Destination":{
      "path":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.path}}"
      }
   },
  "fileConfigurations": {
       // See the file formatting configuration section further below on this page
    }
}
매개 변수 유형 설명
name 문자열 대상 연결의 이름입니다.
destinationServerType 문자열 대상 플랫폼에 따라 이 값을 설정합니다. 대상 Azure Data Lake Storage 대상, 다음 위치로 설정 FILE_BASED_ADLS_GEN2.
fileBasedAdlsGen2Destination.path.templatingStrategy 문자열 필수 여부. PEBBLE_V1.
fileBasedAdlsGen2Destination.path.value 문자열 내보낸 파일을 호스트할 대상 폴더의 경로입니다.
fileConfigurations 개체 자세한 내용은 파일 형식 구성 자세한 내용은 이 섹션에 대해 설명합니다.

파일 기반 Azure Blob Storage 대상 서버 사양

{
   "name":"Blob destination server",
   "destinationServerType":"FILE_BASED_AZURE_BLOB",
   "fileBasedAzureBlobDestination":{
      "path":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.path}}"
      },
      "container":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.container}}"
      }
   },
  "fileConfigurations": {
       // See the file formatting configuration section further below on this page
    }
}
매개 변수 유형 설명
name 문자열 대상 연결의 이름입니다.
destinationServerType 문자열 대상 플랫폼에 따라 이 값을 설정합니다. 대상 Azure Blob Storage 대상, 다음 위치로 설정 FILE_BASED_AZURE_BLOB.
fileBasedAzureBlobDestination.path.templatingStrategy 문자열 필수 여부. PEBBLE_V1.
fileBasedAzureBlobDestination.path.value 문자열 내보낸 파일을 호스트할 대상 폴더의 경로입니다.
fileBasedAzureBlobDestination.container.templatingStrategy 문자열 필수 여부. PEBBLE_V1.
fileBasedAzureBlobDestination.container.value 문자열 의 이름 Azure Blob Storage 이 대상에서 사용할 컨테이너입니다.
fileConfigurations 개체 자세한 내용은 파일 형식 구성 자세한 내용은 이 섹션에 대해 설명합니다.

파일 기반 Data Landing Zone (DLZ) 대상 서버 사양

{
   "name":"DLZ destination server",
   "destinationServerType":"FILE_BASED_DLZ",
   "fileBasedDlzDestination":{
      "path":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.path}}"
      },
      "useCase": "Your use case"
   },
   "fileConfigurations": {
       // See the file formatting configuration section further below on this page
    }
}
매개 변수 유형 설명
name 문자열 대상 연결의 이름입니다.
destinationServerType 문자열 대상 플랫폼에 따라 이 값을 설정합니다. 대상 Data Landing Zone 대상, 다음 위치로 설정 FILE_BASED_DLZ.
fileBasedDlzDestination.path.templatingStrategy 문자열 필수 여부. PEBBLE_V1.
fileBasedDlzDestination.path.value 문자열 내보낸 파일을 호스트할 대상 폴더의 경로입니다.
fileConfigurations 개체 자세한 내용은 파일 형식 구성 자세한 내용은 이 섹션에 대해 설명합니다.

파일 기반 Google Cloud Storage 대상 서버 사양

{
   "name":"Google Cloud Storage Server",
   "destinationServerType":"FILE_BASED_GOOGLE_CLOUD",
   "fileBasedGoogleCloudStorageDestination":{
      "bucket":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.bucket}}"
      },
      "path":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.path}}"
      }
   },
   "fileConfigurations":{
      // See the file formatting configuration section further below on this page
   }
}
매개 변수 유형 설명
name 문자열 대상 연결의 이름입니다.
destinationServerType 문자열 대상 플랫폼에 따라 이 값을 설정합니다. 대상 Google Cloud Storage 대상, 다음 위치로 설정 FILE_BASED_GOOGLE_CLOUD.
fileBasedGoogleCloudStorageDestination.bucket.templatingStrategy 문자열 필수 여부. PEBBLE_V1.
fileBasedGoogleCloudStorageDestination.bucket.value 문자열 의 이름 Google Cloud Storage 이 대상에서 사용할 버킷입니다.
fileBasedGoogleCloudStorageDestination.path.templatingStrategy 문자열 필수 여부. PEBBLE_V1.
fileBasedGoogleCloudStorageDestination.path.value 문자열 내보낸 파일을 호스트할 대상 폴더의 경로입니다.
fileConfigurations 개체 자세한 내용은 파일 형식 구성 자세한 내용은 이 섹션에 대해 설명합니다.

파일 형식 구성

이 섹션에서는 내보낸 파일의 파일 형식 설정을 설명합니다 CSV 파일. Experience Platform에서 받은 파일을 최적의 방식으로 읽고 해석할 수 있도록 내보낸 파일의 여러 속성을 사용자 측에서 파일 수신 시스템의 요구 사항에 맞게 수정할 수 있습니다.

노트

CSV 옵션은 CSV 파일을 내보낼 때만 지원됩니다. 다음 fileConfigurations 새 대상 서버를 설정할 때는 섹션이 필수가 아닙니다. CSV 옵션에 대한 API 호출에서 값을 전달하지 않으면 아래 표의 기본 값이 사용됩니다.

"fileConfigurations": {
        "compression": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.compression}}"
        },
        "fileType": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.fileType}}"
        },
        "csvOptions": {
            "quote": {
                "templatingStrategy": "NONE",
                "value": "\""
            },
            "quoteAll": {
                "templatingStrategy": "NONE",
                "value": "false"
            },
            "escape": {
                "templatingStrategy": "NONE",
                "value": "\\"
            },
            "escapeQuotes": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "header": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "ignoreLeadingWhiteSpace": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "ignoreTrailingWhiteSpace": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "nullValue": {
                "templatingStrategy": "NONE",
                "value": ""
            },
            "dateFormat": {
                "templatingStrategy": "NONE",
                "value": "yyyy-MM-dd"
            },
            "timestampFormat": {
                "templatingStrategy": "NONE",
                "value": "yyyy-MM-dd'T':mm:ss[.SSS][XXX]"
            },
            "charToEscapeQuoteEscaping": {
                "templatingStrategy": "NONE",
                "value": "\\"
            },
            "emptyValue": {
                "templatingStrategy": "NONE",
                "value": ""
            },
            "lineSep": {
                "templatingStrategy": "NONE",
                "value": "\n"
            }
        },
        "maxFileRowCount":5000000
    }
필드 필수/선택적 설명 기본값
compression.value 선택 사항입니다 데이터를 파일에 저장할 때 사용할 압축 코덱입니다. 지원되는 값: none, bzip2, gzip, lz4, 및 snappy. none
fileType.value 선택 사항입니다 출력 파일 형식을 지정합니다. 지원되는 값: csv, parquet, 및 json. csv
csvOptions.quote.value 선택 사항입니다 전용"fileType.value": "csv". 구분 기호가 값의 일부가 될 수 있는 따옴표 붙은 값을 이스케이프하는 데 사용되는 단일 문자를 설정합니다. null
csvOptions.quoteAll.value 선택 사항입니다 전용"fileType.value": "csv". 모든 값을 항상 따옴표로 묶어야 하는지를 나타냅니다. 기본값은 따옴표 문자가 포함된 값만 이스케이프 처리하는 것입니다. false
csvOptions.escape.value 선택 사항입니다 전용"fileType.value": "csv". 이미 따옴표로 묶인 값 내에 따옴표를 이스케이프 처리하는 데 사용되는 단일 문자를 설정합니다. \
csvOptions.escapeQuotes.value 선택 사항입니다 전용"fileType.value": "csv". 따옴표를 포함하는 값을 항상 따옴표로 묶어야 하는지를 나타냅니다. 기본값은 따옴표 문자가 포함된 모든 값을 이스케이프 처리하는 것입니다. true
csvOptions.header.value 선택 사항입니다 전용"fileType.value": "csv". 열 이름을 첫 번째 행으로 쓸지 여부를 나타냅니다. true
csvOptions.ignoreLeadingWhiteSpace.value 선택 사항입니다 전용"fileType.value": "csv". 값에서 선행 공백을 트리밍할지 여부를 나타냅니다. true
csvOptions.ignoreTrailingWhiteSpace.value 선택 사항입니다 전용"fileType.value": "csv". 값에서 후행 공백을 트리밍할지 여부를 나타냅니다. true
csvOptions.nullValue.value 선택 사항입니다 전용"fileType.value": "csv". null 값의 문자열 표현을 설정합니다. ""
csvOptions.dateFormat.value 선택 사항입니다 전용"fileType.value": "csv". 날짜 형식을 나타냅니다. yyyy-MM-dd
csvOptions.timestampFormat.value 선택 사항입니다 전용"fileType.value": "csv". 타임스탬프 형식을 나타내는 문자열을 설정합니다. yyyy-MM-dd'T'HH:mm:ss[.SSS][XXX]
csvOptions.charToEscapeQuoteEscaping.value 선택 사항입니다 전용"fileType.value": "csv". 따옴표 문자의 이스케이프를 이스케이프 처리하는 데 사용되는 단일 문자를 설정합니다. \ 이스케이프 및 따옴표 문자가 다른 경우. \0 이스케이프 문자와 따옴표 문자가 같은 경우.
csvOptions.emptyValue.value 선택 사항입니다 전용"fileType.value": "csv". 빈 값의 문자열 표현을 설정합니다. ""
csvOptions.lineSep.value 선택 사항입니다 전용"fileType.value": "csv". 작성에 사용해야 하는 라인 구분자를 정의합니다. 최대 길이는 1자입니다. \n
maxFileRowCount 선택 사항입니다 내보낸 파일에 포함할 수 있는 최대 행 수입니다. 대상 플랫폼 파일 크기 요구 사항에 따라 구성합니다. N/A

이 페이지에서는