getTables
    • PDF

    getTables

    • PDF

    기사 요약

    VPC 환경에서 이용 가능합니다.

    사용자 catalog의 table 검색

    요청

    요청 URL

    GET {DATA_CATALOG API_URL}/catalogs/{catalog-id}/tables
    

    요청 파라미터

    파라미터명필수 여부타입제약 사항설명
    catalogIdYesStringcatalog 고유 id
    (ref: getCatalogs)
    pageNoNoint페이지 번호
    기본값: 1
    pageSizeNoint최대값: 200결과 목록 크기
    기본값: 20
    databaseNameNoStringdatabase의 name 패턴 검색어
    tableNameNoStringtable의 name 패턴 검색어
    locationNoStringlocation의 name 패턴 검색어
    tagKeyValueNoString'{key}:{value}' 형태tag의 key, value 검색어
    sort.fieldNoString정렬 기준이 되는 필드명
    sort.isAscNoStringdefault: false정렬 오름차순 여부

    요청 헤더

    공통 가이드 참조

    요청 예시

    curl -X GET "https://datacatalog.apigw.ntruss.com/api/v1/catalogs/{catalog-id}/tables?dataFormats=csv&dataFormats=json&databaseName=d&location=s&pageNo=1&pageSize=20&sort.field=tableName&sort.isAsc=true&tableName=r&tagKeyValue=r" \
        -H "x-ncp-apigw-timestamp: {x-ncp-apigw-timestamp}" \
        -H "x-ncp-iam-access-key: {x-ncp-iam-access-key}"  \
        -H "x-ncp-apigw-signature-v2: {x-ncp-apigw-signature-v2}"
    

    응답

    응답 바디

    • tableResponseList: 사용자 catalog의 table 리스트
    항목타입설명
    catalogIdIntcatalog 고유 id
    tableNameStringtable 이름
    databaseNameStringdatabase 이름
    locationStringtable 위치
    dataFormatStringtable의 데이터 형식
    createTimeDatetable 생성 일시
    updateTimeDatetable 수정 일시

    응답 예시

    HTTP

    HTTP StatusDescription
    200OK

    JSON

    {
      "pageNo": 1,
      "pageSize": 20,
      "totalCount": 1,
      "requestId": "8778ceab-2a38-45b0-85e6-90c619be8721",
      "tableResponseList": [
        {
          "catalogId": 2144,
          "tableName": "scan_dir",
          "databaseName": "default",
          "location": "s3a://bububu/scan-dir/",
          "dataFormat": "csv",
          "createTime": "2023-04-10T11:55:02+0900"
          "updateTime": "2023-04-11T08:01:33+0900"
        }
      ]
    }
    

    이 문서가 도움이 되었습니까?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.