Skip to content

Fox DB Profile - Configuration

Fox DB Profile 설정은 코드 혹은 구성 설정을 통해 수행이 가능합니다. 코드를 사용한 설정은 FoxDbProfileSettings 클래스를 참고 하십시요. 코드를 다시 컴파일하고 배포할 필요가 없으며 재로드(reload) 기능을 제공하는 구성 설정은 훨씬 유연하게 Fox DB Profile 을 적용하거나 해제할 수 있습니다.

이 문서와 관련된 예제 코드는 다음 예제를 참조 하십시요.

Global Level Settings

neodeex.config.json 구성 설정에서 database 섹션의 dbProfile 속성은 전역 Fox DB Profile 설정을 수행합니다. "database:dbProfile" 속성의 설정 사항들은 모든 FoxDbAccess 객체의 DbProfileSettings 속성의 기본값으로 설정됩니다.

다음 구성 설정 예제는 전역 Fox DB Profile 설정의 예를 보여줍니다. 이 구성 설정은 FoxDbAccess 를 통한 모든 데이터 액세스 중에 200 msec 이상 소요되는 쿼리 정보를 콘솔에 출력합니다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
{
  "database": {
    "connectionStrings": {
        ......
    },
    "dbProfile": {
      "enable": true,
      "loggerName": "ConsoleLogger",
      "executionTime": 200,
      "diagnostics": true
    },
    "queryMappers": {
        ......
    }
  },
  "logging": {
        ......
  }
}

Connection String Level Settings

Fox DB Profile 설정은 연결 문자열 수준에서도 지정이 가능합니다. "database:connectionStrings" 내의 각 연결 문자열 설정마다 dbProfile 속성을 명시하여 Fox DB Profile 설정을 수행할 수 있습니다. 연결 문자열 수준의 Fox DB Profile 설정은 전역 수준 설정을 오버라이드(override) 합니다.

다음 구성 설정은 전역 수준과 PostgreSQL 연결 문자열 수준에 설정된 Fox DB Profile 설정을 보여줍니다. 이 예제에서 Oracle 연결 문자열을 사용하는 경우, 전역 수준 설정을 사용하여 200 msec 이상의 수행 시간을 갖는 경우 콘솔에 쿼리 수행 정보를 출력합니다. 한편 PostgreSQL 연결 문자열을 사용하는 경우, 수행 시간에 상관없이(executionTime 속성값 오버라이드) 모든 쿼리 수행 정보를 텍스트 로그 파일(loggerName 속성값 오버라이드)에 기록합니다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
  "database": {
    "defaultConnectionString": "PostgreSQL",
    "connectionStrings": {
      "PostgreSQL": {
        ......
        "dbProfile": {
          "loggerName": "TextFileLogger",
          "executionTime": 0
        }
      },
      "Oracle": {
        ......
      }
    },
    "dbProfile": {
      "enable": true,
      "loggerName": "ConsoleLogger",
      "executionTime": 200,
      "diagnostics": true
    }
  },
  "logging": {
        ......
  }
}

Summary

구성 설정에서 Fox DB Profile 를 설정하는 방법은 전역 수준 설정과 연결 문자열 수준 설정 두 가지 입니다. 전역 수준 설정은 "database:dbProfile" 속성을 통해 지정이 가능하며 모든 데이터 액세스에 영향을 줍니다. 연결 문자열 수준 설정은 "database:connectionStrings" 내에 정의된 각 연결 문자열 설정에서 dbProfile 속성을 통해 지정이 가능합니다. 연결 문자열 수준 설정은 전역 설정을 오버라이드 하며 해당 연결 문자열을 사용하는 FoxDbAccess 에만 영향을 줍니다.